Pytest実践ガイド:TDDの書き方と遅いテストの高速化手順

当ページのリンクには広告が含まれています。
Pytest実践ガイド:TDDの書き方と遅いテストの高速化手順
この記事の結論
Pytestを活用したTDD(テスト駆動開発)では、素朴なassert文とパラメータ化テスト(parametrize)による高い可読性、フィクスチャによるセットアップ処理の共通化が品質向上の軸となります。Red-Green-Refactorサイクルを回し、CI/CDパイプラインと連動させることで、変更に強くリファクタリングしやすい堅牢なコードベースを構築できます。

お疲れ様です!IT業界で働くアライグマです!

「本番リリース後に予期しないバグが見つかり、緊急対応に追われてしまう」
「既存コードをリファクタリングしたいけれど、どこが壊れるか分からず手が出せない」
「Pytestを導入してテスト駆動開発(TDD)を進めたいが、実践的な書き方や運用のコツが分からない」

PythonでWebアプリケーションやデータ基盤を開発していると、こうしたテストに関する悩みに直面する場面は非常に多いですよね。

Pytestは、標準のunittestに比べて簡潔な構文と強力なフィクスチャ機構を備えており、現代のPython開発におけるデファクトスタンダードとして広く支持されています。

本記事では、Pytestの基本構成から、実務で役立つフィクスチャやモックの活用法、TDDのワークフロー、そしてCI/CDと連携した自動テストの運用手法まで体系的に分かりやすく解説します。

目次

Pytestが解決するテストの課題

テストコードを継続的にメンテナンスしていくためには、テストフレームワークの表現力と実行効率が極めて重要になります。

従来のテスト手法における課題

手動テストや旧来の冗長なテスト記述には、開発速度と品質の両面でいくつかの根本的な課題が存在します:

  • 手動確認による工数増大と確認漏れ:画面ポチポチによる手動テストは、機能が増えるほど指数関数的に工数が膨らみ、回帰テストの網羅が難しくなります。
  • ボイラープレートの多さ:クラス定義やself.assertEqualのような専用アサーションメソッドが並ぶと、テストの主眼が何であるかが埋もれてしまいます。
  • セットアップ処理の重複:テストケースごとに似たような初期化コードが散在し、仕様変更時の修正負荷が高くなります。

PytestはPython標準のassert文をそのまま解釈し、テスト失敗時に詳細な差分情報を分かりやすく表示してくれるため、直感的なテスト記述が可能です。

IT女子 アラ美IT女子 アラ美
Pytestなら標準のassert文だけで直感的にテストが書けるんだね!

ITアライグマITアライグマ
そうなんです!クラスを作らずに関数単位で書けるので、テストの記述ハードルがぐっと下がりますよ。

Pytestの基本構成とテスト設計

まずは、Pytestを使った基本的なテスト関数の書き方と、テストケースを効率的に量産する手法を確認しましょう。

シンプルな関数テストとassert文

Pytestでは、test_から始まるファイル名および関数名を定義するだけで、テストランナーが自動検出して実行します。

import pytest

def calculate_discount(price: int, discount_rate: float) -> int:
    if discount_rate < 0 or discount_rate > 1:
        raise ValueError("Invalid discount rate")
    return int(price * (1 - discount_rate))

def test_calculate_discount_normal():
    assert calculate_discount(1000, 0.2) == 800

def test_calculate_discount_invalid_rate():
    with pytest.raises(ValueError, match="Invalid discount rate"):
        calculate_discount(1000, 1.5)

例外発生の検証にはpytest.raisesを使用し、意図通りのエラーメッセージが返されているかをスムーズに検査できます。

parametrizeによるテストケースの効率化

境界値テストや多数の入力パターンを検証する際は、@pytest.mark.parametrizeデコレータが威力を発揮します。

@pytest.mark.parametrize("price,rate,expected", [
    (1000, 0.0, 1000),
    (1000, 0.1, 900),
    (1000, 0.5, 500),
    (1000, 1.0, 0),
])
def test_calculate_discount_multiple(price, rate, expected):
    assert calculate_discount(price, rate) == expected

テストロジックを一度書くだけで複数の入力値と期待値を反復検証できるため、コードの重複を排除しつつ網羅性を一気に引き上げることができます。

IT女子 アラ美IT女子 アラ美
parametrizeを使うと、境界値テストが何パターンもすっきり書けるわね!

ITアライグマITアライグマ
テストデータのバリエーションをテーブル形式で並べられるので、見通しが抜群に良くなりますよ。

フィクスチャとモックの活用

データベース接続やモックAPIなど、テストに必要な前提条件を安全かつクリーンに管理するのがPytestのフィクスチャ機能です。

フィクスチャによるセットアップとティアダウン

@pytest.fixtureを付与した関数を定義することで、テストデータの作成や外部リソースの初期化・解放を一元管理できます。

import sqlite3
import pytest

@pytest.fixture
def db_connection():
    # セットアップ(事前処理)
    conn = sqlite3.connect(":memory:")
    cursor = conn.cursor()
    cursor.execute("CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT)")
    conn.commit()
    yield conn
    # ティアダウン(事後処理)
    conn.close()

def test_insert_user(db_connection):
    cursor = db_connection.cursor()
    cursor.execute("INSERT INTO users (name) VALUES ('alice')")
    db_connection.commit()
    
    cursor.execute("SELECT name FROM users WHERE id = 1")
    assert cursor.fetchone()[0] == "alice"

テスト関数の引数にフィクスチャ名を指定するだけで依存性が自動注入され、yield以降の処理でテスト終了後のクリーンアップが確実に実行されます。

モックを活用した外部依存の遮断

外部APIとのHTTP通信やメール送信など、単体テストで実際に実行したくない処理はunittest.mockやmonkeypatchを用いて差し替えます。外部サービスの障害やネットワーク遅延に左右されない、安定したテスト実行環境を維持しましょう。

IT女子 アラ美IT女子 アラ美
yieldの前後でセットアップと後片付けが綺麗に分かれるのが分かりやすいね。

ITアライグマITアライグマ
はい!テスト関数ごとに接続や解放を書かずに済むので、保守性が飛躍的に向上しますよ。

TDDワークフローとPytest運用

テスト駆動開発(TDD)のリズムを身につけることで、設計品質と実装の確実性を同時に高めることができます。

Red-Green-Refactorサイクルの実践

TDDは以下の3つのステップを小さな単位でリズミカルに反復します:

  • Red(失敗するテストの作成):これから作成する機能の仕様をテストコードとして書き、テストが期待通りに失敗することを確認します。
  • Green(最小限の実装):テストをパスさせるための最もシンプルで手っ取り早いコードを実装します。
  • Refactor(リファクタリング):テストが通る状態を維持したまま、重複の排除やコードの可読性向上、設計の洗練を行います。

テストが安全網として機能しているため、既存の挙動を壊す不安なくリファクタリングに集中できる点が最大のメリットです。

IT女子 アラ美IT女子 アラ美
先にテストを書いてから実装するから、仕様の漏れにすぐ気づけるんだね!

ITアライグマITアライグマ
テストが通っている安心感があるからこそ、恐れずにコードの整理やリファクタリングを進められますよ。

CI/CD統合と品質ゲートの構築

テストコードの価値を最大限に引き出すには、開発者のローカル実行だけに依存せず、CI環境で自動実行する仕組みが不可欠です。

GitHub Actionsでの自動テスト実行

プルリクエストが作成されたタイミングでPytestを自動実行し、テストが全て成功した場合のみマージを許可する品質ゲートを設置します。

name: Python Test
on: [pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Set up Python
        uses: actions/setup-python@v5
        with:
          python-version: '3.11'
      - name: Install dependencies
        run: |
          pip install -r requirements.txt
          pip install pytest pytest-cov
      - name: Run Pytest
        run: pytest --cov=src --cov-report=term-missing

カバレッジ計測プラグイン(pytest-cov)を組み合わせることで、テストされていない未カバーの行をPR上で可視化し、レビュー時の客観的な判断基準として役立てることができます。

IT女子 アラ美IT女子 アラ美
PRを作るたびに自動でテストが走れば、デグレの心配がなくなるね!

ITアライグマITアライグマ
CIパイプラインで自動検証することで、チーム全員が安心してコードをマージできるようになりますよ。

pytestが遅いときの高速化の手順

テストが増えて実行に時間がかかるようになったら、やみくもに並列化する前に、どのテストが遅いのかを先に確かめます。ここで使うオプションは、pytest と pytest-xdist の公式ドキュメント(2026年11月18日確認)に載っているものです。

手順1:遅いテストを –durations で見つける

pytest --durations=10 を付けて実行すると、時間のかかったテストが遅い順に10件表示されます。pytest の使い方のページでは、pytest --durations=10 --durations-min=1.0 で「1.0秒以上かかったテストのうち遅い10件」を出す例が紹介されています。

上位に並んだテストが、データベースへの接続や外部APIの呼び出しをしていないかを見ます。原因が分かれば、次の手順のどれが効くかを決められます。

手順2:重いフィクスチャのスコープを広げる

フィクスチャは、既定(scope="function")ではテスト関数ごとに作られ、テストが終わるたびに片付けられます。フィクスチャのページによると、scope="module" にするとモジュール内の最後のテストまで、scope="session" にするとテストの実行全体の終わりまで同じものが使い回されます。

データベースの接続のように作るのが重いものは、スコープを広げるだけで速くなることがあります。ただし、テスト同士で状態を共有するため、あるテストが書き換えたデータが別のテストに影響しないようにしておく必要があります。

手順3:失敗したテストだけを先に回す

直している最中は、毎回すべてのテストを流す必要はありません。キャッシュのページにあるとおり、pytest --lf(--last-failed)は前回失敗したテストだけを実行し、pytest --ff(--failed-first)は前回失敗したテストを先に流してから残りを実行します。

手順4:pytest-xdist で並列に実行する

ここまでで遅さが残るなら、プラグインの pytest-xdist で複数のCPUに分けて実行します。pip install pytest-xdist で入れ、pytest -n auto で実行します。pytest-xdist のドキュメントによると、-n auto はパソコンの物理CPUコアの数だけプロセスを使います。

並列にすると実行の順番が保証されないため、前のテストの結果に頼っているテストは失敗するようになります。並列にして初めて落ちるテストが出たら、そのテストが別のテストの残したデータに頼っていないかを確かめてください。

IT女子 アラ美IT女子 アラ美
いきなり並列にするんじゃなくて、まず遅いテストを探すのが先なんだね。

ITアライグマITアライグマ
はい。原因が1本の重いフィクスチャなら、スコープを変えるだけで済むこともありますよ。

よくある質問

Q. テストカバレッジは100%を目指すべきですか?

カバレッジ100%を必須要件にすると、自明なgetter/setterや外部ライブラリのラッパーに対するテスト記述に追われ、開発効率が著しく低下します。業務の中核となる複雑なドメインロジックや計算処理、分岐の多い箇所を重点的にカバーし、80%程度を目安に運用するのが現実的です。

Q. PytestとPython標準のunittestはどちらを使うべきですか?

新規プロジェクトであればPytestを強く推奨します。unittestと比べてボイラープレートコードが大幅に少なく、フィクスチャのスコープ管理やプラグイン(pytest-xdistによる並列化など)のエコシステムが充実しているためです。なお、Pytestは既存のunittestコードもそのまま実行可能です。

Q. テストの実行速度が遅くなってきた場合の対策は?

まず --durations で遅いテストを見つけ、重いフィクスチャのスコープを広げる、失敗したテストだけを回す、pytest-xdist で並列にする、の順に試します(上の「pytestが遅いときの高速化の手順」)。普段の実行から重い統合テストを外したいときは、自分で付けたマーカーを使って pytest -m "not slow" のように除外する方法もあります。

IT女子 アラ美IT女子 アラ美
重いテストにはマーカーをつけて、普段はサクサク動かす工夫ができるんだね。

ITアライグマITアライグマ
はい!単体テストは高速に回し、重い統合テストはPR時や夜間に回すなどメリハリをつけましょう。

まとめ

本記事では、Pytestを用いた効率的なテスト設計とTDDの実践手法、フィクスチャの活用法、そしてCI/CDによる品質担保のポイントを解説しました。

重要なポイントをおさらいします:

  • 簡潔な記法:標準assert文と関数ベースの記述により、直感的で読みやすいテストコードを実現
  • テストケースの集約:@pytest.mark.parametrizeを活用して入力パターンの網羅性を高める
  • フィクスチャによる共通化:セットアップとティアダウンを一元化し、外部依存を適切に分離
  • CI連携による品質保証:プルリクエスト時の自動実行とカバレッジ計測でリグレッションを防止

信頼性の高いテストスイートは、将来にわたる積極的なリファクタリングと素早い機能リリースを支える最強の資産となります。まずは手元の小さな関数をPytestでテストすることから、実践を始めてみてください!

IT女子 アラ美IT女子 アラ美
まずは身近な関数のテストから書いて、TDDのリズムを掴んでみるわ!

ITアライグマITアライグマ
ぜひPytestを活用して、バグの心配なく安心して開発できる環境を作っていきましょうね!

この記事をシェアする
  • URLをコピーしました!
  • URLをコピーしました!

この記事を書いた人

ITアライグマのアバター ITアライグマ ITエンジニア / PM

都内の事業会社で働くPM兼Webエンジニアです(IT業界10年以上、既婚・子持ち)。
スマホや決済アプリ、Wi-Fi、スマートスピーカーなど、身近なITの「困った」を、公式のヘルプやサポート情報で確かめたうえで、原因の切り分けから直し方までまとめています。設定で直らないときは、回線やサービスの見直しも含めて紹介しています。

目次