t.wada流 TDD（テスト駆動開発）

和田卓人氏のTDD哲学に基づき、高品質なテスト駆動開発を実践する。

Core Philosophy（中核思想）

「テストとは、動くことを証明するものではない。間違いを見つけるためのものだ。」 — t.wada

3つの原則

1. テストは設計行為 — テストを書くことで、使いやすいAPIを設計する
2. テストは仕様書 — テストコードが最も正確なドキュメントである
3. 小さく回す — Red → Green → Refactor を短いサイクルで繰り返す

TDD Cycle（Red-Green-Refactor）

🔴 RED      → 失敗するテストを先に書く
     ↓
🟢 GREEN    → 最小限のコードでテストを通す
     ↓
🔵 REFACTOR → テストが通ったまま設計を改善
     ↓
   （繰り返し）

Instructions

Step 1: 要件を振る舞いで分解

実装前に「〜したとき、〜となる」形式でテストケースをリストアップする。

テストケースリスト:
□ 空のリストを渡すと空のリストを返す
□ 1要素のリストはそのまま返す
□ 複数要素は昇順でソートされる
□ 負の数を含んでも正しくソートされる

最も単純なケースから始める。

Step 2: テスト構造（AAA パターン）

すべてのテストは Arrange-Act-Assert の3フェーズで構成する。

def test_振る舞いを日本語で記述():
    # Arrange（準備）
    sut = TargetClass()
    input_data = create_test_data()

    # Act（実行）
    result = sut.target_method(input_data)

    # Assert（検証）
    assert result == expected_value

ポイント:

• テスト名は日本語で振る舞いを明確に記述
• 1テスト1アサーション（原則）
• 3つのブロックを空行で明確に分離

Step 3: 境界値と異常系

必ず以下をカバーする:

# 境界値テスト
def test_空入力():
    assert func([]) == []

def test_単一要素():
    assert func([1]) == [1]

def test_最大値():
    assert func([MAX_VALUE]) == expected

def test_最大値プラス1で例外():
    with pytest.raises(ValueError):
        func([MAX_VALUE + 1])

# 異常系テスト
def test_None入力で例外():
    with pytest.raises(TypeError):
        func(None)

def test_不正な型で例外():
    with pytest.raises(TypeError):
        func("not a list")

Step 4: Refactor（リファクタリング）

テストがグリーンの状態を維持しながら:

• 重複の除去
• 命名の改善
• 責務の分離

ルール: 振る舞いを変えずに構造を改善する

Anti-Patterns（避けるべきパターン）

❌ 実装詳細のテスト

# Bad: 内部状態に依存
assert obj._internal_cache == {...}
assert obj._call_count == 3

# Good: 振る舞いをテスト
assert obj.get_result() == expected

❌ テスト間の依存

# Bad: 前のテストの状態に依存
class TestCounter:
    counter = Counter()  # 共有状態

    def test_1(self):
        self.counter.increment()

    def test_2(self):
        assert self.counter.value == 1  # test_1に依存

# Good: 各テストが独立
def test_increment():
    counter = Counter()
    counter.increment()
    assert counter.value == 1

❌ 過度なモック

# Bad: すべてをモック化（何もテストしていない）
@patch('module.ClassA')
@patch('module.ClassB')
@patch('module.ClassC')
def test_something(mock_a, mock_b, mock_c):
    ...

# Good: 外部境界のみモック化
@patch('module.external_api_client')
def test_something(mock_api):
    ...

❌ 巨大なテスト

# Bad: 1テストで複数の振る舞い
def test_user_registration():
    # 50行のテストコード...
    assert user.email == ...
    assert user.created_at == ...
    assert email_sent == True
    assert db.users.count() == ...

# Good: 1テスト1振る舞い
def test_ユーザー登録でメールアドレスが保存される():
    ...

def test_ユーザー登録で確認メールが送信される():
    ...

Test Template

新しいテストファイルを作成する際のテンプレート:

"""
{モジュール名}のテスト

テスト対象: {クラス名/関数名}
"""
import pytest
from src.module import TargetClass


class Test{TargetClass}:
    """TargetClassの振る舞いテスト"""

    # ========== 正常系 ==========

    def test_基本的な使用方法(self):
        """最も一般的なユースケース"""
        # Arrange
        sut = TargetClass()

        # Act
        result = sut.do_something("input")

        # Assert
        assert result == "expected"

    # ========== 境界値 ==========

    def test_空入力(self):
        """空の入力を処理できる"""
        sut = TargetClass()
        result = sut.do_something("")
        assert result == ""

    def test_最大長入力(self):
        """最大長の入力を処理できる"""
        sut = TargetClass()
        result = sut.do_something("x" * MAX_LENGTH)
        assert len(result) <= MAX_LENGTH

    # ========== 異常系 ==========

    def test_None入力で例外(self):
        """Noneを渡すとTypeErrorが発生"""
        sut = TargetClass()
        with pytest.raises(TypeError):
            sut.do_something(None)

    def test_不正な入力でValueError(self):
        """不正な入力はValueErrorを発生"""
        sut = TargetClass()
        with pytest.raises(ValueError) as exc_info:
            sut.do_something("invalid")
        assert "不正な入力" in str(exc_info.value)

Checklist

実装完了時の確認項目:

• すべてのテストがパス
• 各テストが独立して実行可能
• テスト名から振る舞いが理解できる
• AAA構造が明確
• 境界値がカバーされている
• 異常系がカバーされている
• 実装詳細ではなく振る舞いをテスト
• 過度なモックを使用していない

References

追加のガイダンスは以下を参照:

• EXAMPLES.md - 具体的なテストパターン例
• PATTERNS.md - よくあるテストパターン集