テストを実行する
Shellはテストコマンドを実行し、カードには実際の終了コードと完全な出力が表示されます。
モックAPIは本番サービスの代わりです。ファイルから固定の応答を返すため、テストは毎回同じ挙動を示します。CycleMantleはそのファイルを作成し、架空のサンプルデータを用意して、あなたが見守る中でチャットからテストコマンドを実行します。提案のどれをプロジェクトに適用するかは、あなたが決定します。
Shellはテストコマンドを実行し、カードには実際の終了コードと完全な出力が表示されます。
write_fileとedit_fileは、あなたが承認または拒否できる差分形式でテストとフィクスチャを提案します。
read_fileとgrepはレポートやログを開き、エージェントが未テストの行を特定できるようにします。
チャットでタスクを説明します。エージェントはコードを読み取り、コマンドを実行し、各結果をカードとして表示します。Ask firstでは、何かが変更される前にあなたの決定を待ちます。Plan onlyは、ステップを実行する前に手順を確認したい場合に最初に表示されます。すべてのカードはチャットに残るため、スクロールして何を実行したかを確認できます。
src/RateClient.php読み込み完了tests/fixtures/rates.json保存完了tests/RateClientTest.php保存完了your test command終了コード 0rates.json一致数: 2tests/RateClientTest.php差分表示あなたのクラスは為替レートサービスから数値を要求し、テストはライブサーバーに依存すべきではありません。エージェントにモックAPIを作成させてください。read_fileでクライアントクラスを読み込み、write_fileでtests/fixtures/rates.jsonに固定応答を保存し、edit_fileでテストを変更して外部呼び出しの代わりにそのファイルを読み込むようにします。ユニットテストのセットアップで実際の関数を呼び出すと、テストは意図していないコードに依存するため、フィクスチャを小さく保ち、それを置き換える呼び出しの名前を付けてください。Ask firstは、保存する前に差分を表示します。承認し、Shellでテストコマンドを実行し、終了コードを確認します。その後、カードを展開して、出力内の応答が架空のものであることを確認します。出力に実際のサーバーアドレスが表示された場合は、停止してテストを修正してください。
レポートクラスには、名前、日付、金額を持つ3人のユーザーが必要になる場合があります。ここでテストデータ生成とは、エージェントが架空の人物のJSONファイルを作成することを意味します。実際の顧客リストから行をコピーすることはありません。テストデータ生成に使用するツールの一つとして、エージェントが作成したプレーンファイルは差分で簡単にレビューでき、後で変更しやすいです。globを使用して既存のフィクスチャをまず探し、新しいファイルが既存の名前と競合しないようにします。チャットでファイルを開き、手動で不自然な値を修正し、エッジケースをカバーするために空の名前の行を1つ追加し、テストを再実行します。名前を明らかに架空のものにしてください。ファイルをコードとともにコミットし、チームメイトが同じデータを使用できるようにします。
Shell経由でカバレッジコマンドを実行し、エージェントにread_fileでレポートを読み取ってください。エージェントは実行されなかった行を持つ関数を特定し、それらに対するテストを差分として提案します。人々はよくユニットテストで何をテストすべきか尋ねますが、答えは小さく始めることから始まります:1つの通常入力、1つの空のリストなどのエッジケース、1つの無効な値です。一度にすべてではなく、テストを1つずつ承認してください。そうすれば、弱いテストに気づくことができます。高い数値でも、コードが正しいことを証明するわけではありません。懐疑的であり続けてください。各アサーションを自分で読み、関数が間違っていた場合に失敗するかどうかを問いかけてください。最後の承認されたテストの後、コマンドを最終回実行してください。最も重要なファイルに信頼できるテストがあるまで繰り返します。
テストが失敗すると、カードにはテストコマンドの実際の出力が表示されます。エージェントにread_fileでテストとテスト対象のクラスを読み取らせ、不一致の原因を説明させてください。grepを使用して値が構築されている場所を見つけ、差分として修正を提案できます。人々はモッキングが問題を引き起こす理由を尋ねますが、一つの答えは、架空の応答が本番サービスからずれる可能性があることです。フィクスチャをあなたが所有するサービスと比較し、一致する場合にのみ差分を承認し、コマンドを再実行してください。同じテストが2回失敗した場合は、Plan onlyに切り替え、さらに編集を行う前に説明を求めてください。修正が承認されるまで、失敗した出力を保持してください。
CycleMantleはホストされたサービスやプラグインではありません。あなたのファイル、あなたのPC、そしてアクセス権のあるサーバーのみに使用されます。Shell、Web、SSHは作業フォルダに限定されないため、エージェントがアクセスできるフォルダ、コマンド、サーバーはあなたが決定します。テストに合格しても、コードが正しいことを保証するものではありません。