# Python テスト

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/ja-jp/help/clion/llms.txt).

通常、CLion は作成した実行/デバッグ構成を実行することで、他の Python アプリケーションと同様に Python テストを実行およびデバッグします。 その際、指定されたテストクラスまたはメソッドをテストランナーに渡します。

多くの場合、コンテキストメニューからテストセッションを開始できます。 この目的のために、   実行   および   デバッグ   コマンドは、特定のコンテキストメニューで提供されます。 例: これらのコマンドは、 [プロジェクトツールウィンドウ](project-tool-window.html)のテストクラス、ディレクトリ、パッケージで使用できます。 エディターで現在作業しているテストクラスまたはメソッドでも使用できます。

永続的な実行 / デバッグ構成がないテストを実行すると、一時的な構成が作成されます。 後で再利用したい場合は、 [実行 / デバッグ構成](run-debug-configurations-dialog.html)ダイアログを使用してそのような構成を保存できます。

テストはバックグラウンドで実行されるため、同時に複数のテストを実行できます。

各実行構成には、 [実行ツールウィンドウ](run-tool-window.html)（ [テスト結果タブ](null)）に独自のタブが作成されます。 1 つのタブで複数のテストを集約できます。

CLion でテストを実行する詳細については、
[テストの実行、デバッグ、終了](performing-tests.html)
を参照してください。
Procedure: ディレクトリ内のすべての Python テストを実行する

1. プロジェクトツールウィンドウで、実行するテストが含まれているディレクトリを選択します。

2. コンテキストメニューから、対応する実行コマンドを選択します。

ディレクトリにさまざまなテストフレームワークに属するテストが含まれている場合は、使用する構成を選択します。

例:  `実行 'All tests in: <directory name>'`   `<ディレクトリ名> で pytest を実行します`  を選択します。

![ディレクトリ内のすべてのテストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/py_run_test_folder.png)

3. テストランナーで [結果を確認](viewing-and-exploring-test-results.html)します。

![1 つのディレクトリからすべての pytest テストを実行する](https://resources.jetbrains.com/help/img/idea/2026.3/py_run_tests_from_test_package.png)

> **Tip:**
> Django バージョン 1.1 以降の場合、このテストランナーがクラスであれば、CLion はカスタムテストランナーをサポートします。

デフォルトでは、すべてのテストは 1 つずつ実行されます。 pytest テストフレームワークのためにこの振る舞いを変えて、あなたのテストを並行して実行することができます。

Procedure: Python テストを並行して実行する

pytest テストの実行を最適化するためにテスト多重処理を可能にしてください。

テスト実行用の CPU の数を明示的に指定するには

1. [pytest-xdist(英語)](https://pypi.org/project/pytest-xdist/) をインストールします。

2. プロジェクトテストフレームワークとして pytest を指定します。

3. メインツールバーの実行 / デバッグ構成のリストから   実行構成の編集 ...   を選択します。   実行 / デバッグ構成   ダイアログで、   Pytest テスト   グループを展開し、   <ディレクトリ名> の pytest   を選択します。

ディレクトリ内のすべてのテストを初めて実行する際に、CLion はこの構成を作成します。 テストをまだ実行していない場合は、 ![追加ボタン](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) アイコンをクリックして、実行 / デバッグ構成パラメーターを指定します。

4. 実行 / デバッグ構成   ダイアログで、   追加引数   フィールドにテストを実行する CPU の数を指定し、  `-n <number of CPUs>`  変更を保存します。

![pytest テストのグループのための Run/Debug 設定の編集](https://resources.jetbrains.com/help/img/idea/2026.3/py_pytest_run_debug_conguration_addoptions.png)

5. ディレクトリ内のすべてのテストをもう一度実行し、   実行   ツールウィンドウで出力を調べます。 この例では、結果として同じテストを実行した場合の合計実行時間は 30 秒 13 ミリ秒であるのに対して、12 秒 79 ミリ秒です。 テストレポートは、テストの実行に使用された CPU と実行時間に関する情報を提供します。

![Running tests in parallel](https://resources.jetbrains.com/help/img/idea/2026.3/py_run_tests_in_parallel_3_cpu.animated.gif)

あるいは、  `pytest.ini`  ファイルでテストを実行するための CPU の数を指定できます。 例えば、

```PYTHON
[pytest]
addopts = -n3

```

> **Note:**
> `pytest.ini`  ファイルと実行 / デバッグ構成で異なる値の CPU 番号を指定した場合は、  `pytest.ini`  ファイルの設定よりも後者の方が優先されます。

実行中のテストを停止できる場合は、実行中のすべてのテストがすぐに停止します。   実行   ツールウィンドウのテストのアイコンは、テストのステータス（合格、失敗、中止）を反映しています。

## See also

### コンセプト

[実行 / デバッグ構成](run-debug-configuration.html)

