pytest-coverage について
pytest のカバレッジレポートで未テストのソース行を特定し、行カバレッジがすべて埋まるまでテスト追加を進めるスキルです。プロジェクト全体またはモジュール単位の確認に使えます。
主な機能
- 01注釈付きカバレッジレポートの生成
- 02モジュールまたはテストファイルの指定
- 03未カバーのソース行の特定
- 04カバレッジ完了までテストを反復
活用シーン
- 01プロジェクト内の未テスト行の発見
- 02単一モジュールのカバレッジ確認
- 03未カバーコードへのテスト追加
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/インストール後、Claude Code で/pytest-coverageを入力して読み込まれたか確認します。
詳細
目標は、テストがあらゆるコード行をカバーすることです。
次のコマンドでカバレッジレポートを生成します。
pytest --cov --cov-report=annotate:cov_annotate
特定のモジュールのカバレッジを確認する場合は、次のように指定できます。
pytest --cov=your_module_name --cov-report=annotate:cov_annotate
実行するテストを個別に指定することもできます。たとえば、次のとおりです。
pytest tests/test_your_module.py --cov=your_module_name --cov-report=annotate:cov_annotate
cov_annotate ディレクトリを開いて、注釈付きのソースコードを確認してください。 ソースファイルごとに 1 つのファイルが生成されます。あるファイルのソースカバレッジが 100% であれば、すべての行がテストでカバーされていることを意味するため、そのファイルを開く必要はありません。
テストカバレッジが 100% 未満のファイルごとに、cov_annotate 内の対応するファイルを見つけて確認してください。
行が ! (感嘆符) で始まっている場合、その行はテストでカバーされていないことを意味します。 不足している行をカバーするテストを追加してください。
すべての行がカバーされるまで、テストを実行し続けてカバレッジを改善してください。