pytest-dev/pytest-xdist

これは何？

主な機能

• 01`pytest -n`を使って、テストを複数CPUで並列実行します。
• 02`-n auto`を使うと、利用可能なCPU数に応じてワーカー数を自動設定します。
• 03失敗したテストを繰り返し再実行するモードを提供します。
• 04既存のpytestテストスイートでプラグインとして利用できます。

ユースケース

• 逐次実行に時間がかかりすぎる、大規模なpytestテストスイートを高速化する。
• デバッグ中に、不安定なテストや失敗するテストを繰り返し実行する。
• マルチコアの開発マシンやCIランナーでテストスイートを実行する。

クイックスタート

1. 1

   CPUコアを使ってテストスイートを並列実行する

   pytest -n auto

収録されている特集

トピック

よくある質問

pytest-xdist とは？

pytestのテストを複数CPUで並列実行し、失敗したテストを繰り返し実行するモードも追加するプラグイン。 pytest-xdistは、pytestのテストランナーに新しい実行モードを追加します。主な用途は、テストを複数CPUに分散して実行時間を短縮することです。`pytest -n auto`を実行すると、利用可能なCPUごとにワーカープロセスが1つ起動し、テストがそれぞれに分配されます。

pytest-xdist は無料で使えますか？ライセンスは？

pytest-xdist は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

pytest-xdist は今もメンテナンスされていますか？

活発にメンテナンス中。pytest-xdist の最終コミットは 2026年11月2日 です。

pytest-xdist は何に使えますか？

逐次実行に時間がかかりすぎる、大規模なpytestテストスイートを高速化する。 デバッグ中に、不安定なテストや失敗するテストを繰り返し実行する。 マルチコアの開発マシンやCIランナーでテストスイートを実行する。

pytest-xdist のインストール方法は？

CPUコアを使ってテストスイートを並列実行する: pytest -n auto

pytest-xdist はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/pytest-dev/pytest-xdist