26:テストケース毎にテストデータを用意する¶

テストコードを修正したら、関係のないところでテストが失敗してしまって困ったことはありませんか？テストデータを使い回すと、意図しないテストの失敗を招いてしまいます。

具体的な失敗¶

square_list という整数のリストの各要素を2乗してまたリストとして返す関数があるとします。

# spam.py ----

def square_list(nums):
    return [n * n for n in nums]

# 実行イメージ
# square_list([1, 2, 3]) => [1, 4, 9]

この関数に対して、下記のようなテストコードを書いたとします。

# 本来は別のテスト使うテストデータ生成関数をimport
from spam.tests.other_fixtures import get_other_fixtures

class TestSquareList:

    def test_square(self):
        # Arrange --
        from spam import square_list

        test_list = get_other_fixtures() # => [1, 2, 3] がテストデータとして取得できる

        # Act --
        actual = square_list(test_list)

        # Assert --
        expected = [1, 4, 9]
        assert actual == expected

square_list という関数をテストするために、たまたま他のテストで用意した整数のリストを返す関数 get_other_fixtures を利用しています。

この状態で、他の開発者が 別のテストを修正する目的 で get_other_fixtures 関数の戻り値を変更したらどうなるでしょうか？　もちろんこの TestSqureList のテストケースは失敗してしまいます。

このテストを書いた本人ならば、すぐに原因もわかるかもしれませんが、他の開発者は別のテストを修正しているつもりなので、原因がわかるまでに時間が掛かってしまうでしょう。

ベストプラクティス¶

上記のようなトラブルを避けるためにも、フィクスチャーを複数のテスト間でに使い回すのを極力避けましょう。理想的には個々のテストケースの中でのみ有効なフィクスチャーを用意して、他のテストには影響を与えないようにしましょう。

class TestSquareList:

    def test_square(self):
        # Arrange --
        from spam import square_list

        test_list = [1, 2, 3]  # 専用のテストデータを用意

        # Act --
        actual = square_list(test_list)

        # Assert --
        expected = [1, 4, 9]
        assert actual == expected

フィクスチャーを使い回さないという考えは、 factory-boy などのフィクスチャーを自動生成するライブラリを使うときにも適用できます。たとえばよくあるのが、Factoryクラスのデフォルト値に依存したテストを書いてしまうケースです。

（中略）詳細は書籍自走プログラマーをご参照ください