テスト駆動開発
哲学
核となる原則: テストは実装の詳細ではなく、パブリックインターフェースを通じて振る舞いを検証すべきです。コードは完全に変更される可能性がありますが、テストは変更されるべきではありません。
良いテストは統合スタイルです。パブリックAPIを通じて実際のコードパスを実行します。システムが_何を_行うかを記述し、_どのように_行うかは記述しません。良いテストは仕様のように読み取れます。「ユーザーは有効なカートでチェックアウトできる」というテストは、その機能が存在することを正確に示します。これらのテストは内部構造に関係しないため、リファクタリング後も生き残ります。
悪いテストは実装に結合しています。内部の協力者をモックし、プライベートメソッドをテストし、または外部手段(データベースにインターフェース経由ではなく直接クエリするなど)で検証します。警告サイン:リファクタリング時にテストが壊れるが、振る舞いは変わっていない場合。内部関数の名前を変更しただけでテストが失敗するなら、そのテストは実装をテストしており、振る舞いをテストしていません。
例についてはtests.mdを、モッキングのガイドラインについてはmocking.mdを参照してください。
アンチパターン:水平スライシング
すべてのテストを先に書き、その後すべての実装を書かないでください。 これは「水平スライシング」と呼ばれ、REDフェーズを「すべてのテストを書く」、GREENフェーズを「すべてのコードを書く」と扱うものです。
これにより質の悪いテストが生まれます:
- まとめて書かれたテストは_実際の_振る舞いではなく、_想像上の_振る舞いをテストします
- ユーザー向けの振る舞いではなく、データ構造や関数シグネチャといった_形状_をテストすることになります
- テストは実際の変更に鈍感になります。振る舞いが壊れているのにテストがパスしたり、振る舞いが正しいのにテストが失敗したりします
- 実装を理解する前にテスト構造にコミットしてしまい、先を見越しすぎます
正しいアプローチ: トレーサーブレットによる垂直スライス。1つのテスト→1つの実装→繰り返し。各テストは前のサイクルで学んだことに基づいて書かれます。コードを書いたばかりなので、どの振る舞いが重要で、それをどのように検証するかが正確に分かります。
間違い(水平):
RED: test1, test2, test3, test4, test5
GREEN: impl1, impl2, impl3, impl4, impl5
正しい(垂直):
RED→GREEN: test1→impl1
RED→GREEN: test2→impl2
RED→GREEN: test3→impl3
...
ワークフロー
1. 計画
コードを書く前に:
- 必要なインターフェースの変更についてユーザーと確認する
- テストすべき振る舞い(優先順位付き)をユーザーと確認する
- 深いモジュール(小さなインターフェース、深い実装)の機会を特定する
- テスト容易性のためのインターフェースを設計する
- テストする振る舞い(実装手順ではない)をリストアップする
- 計画についてユーザーの承認を得る
質問例:「パブリックインターフェースはどのようにすべきですか?どの振る舞いを最も重要にテストすべきですか?」
すべてをテストすることはできません。 どの振る舞いが最も重要かをユーザーと正確に確認してください。すべてのエッジケースではなく、クリティカルパスと複雑なロジックにテスト労力を集中させましょう。
2. トレーサーブレット
システムについて1つのことを確認するテストを1つ書きます:
RED: 最初の振る舞いのテストを書く → テストが失敗
GREEN: テストを通過させる最小限のコードを書く → テストが成功
これがトレーサーブレットです。パスがエンドツーエンドで機能することを証明します。
3. インクリメンタルループ
残りの各振る舞いについて:
RED: 次のテストを書く → 失敗
GREEN: 通過させる最小限のコードを書く → 成功
ルール:
- 一度に1つのテスト
- 現在のテストを通過させるのに十分なコードのみ
- 将来のテストを先取りしない
- テストは観測可能な振る舞いに集中させる
4. リファクタリング
すべてのテストが通過した後、リファクタリング候補を探します:
- 重複を抽出する
- モジュールを深くする(複雑さをシンプルなインターフェースの背後に移動)
- 自然な場所でSOLID原則を適用する
- 新しいコードが既存のコードについて何を明らかにするかを考える
- 各リファクタリングステップの後にテストを実行する
REDの状態でリファクタリングしないでください。 まずGREENにしてください。
サイクルごとのチェックリスト
[ ] テストは実装ではなく振る舞いを記述している
[ ] テストはパブリックインターフェースのみを使用している
[ ] テストは内部リファクタリング後も生き残る
[ ] コードはこのテストに対して最小限である
[ ] 推測による機能追加がない