Pytest（パイテスト）

作成: 実行 | 構成の編集 | | Python テスト | pytest

このダイアログを使用して、 pytest(英語) の実行 / デバッグ構成を作成します。

実行 / デバッグ構成のツリービューには、プロジェクトで利用できる構成の管理や、デフォルト構成テンプレートの調整に役立つツールバーがあります。

項目	ショートカット	説明
	`Alt+Insert`	実行 / デバッグ構成を作成します。
	`Alt+Delete`	選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。
	`Ctrl+D`	選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。
		このボタンは、一時的な構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。
		新しいフォルダーに移動 / 新しいフォルダーを作成します。実行 / デバッグ構成は、フォルダーに配置することでグループ化できます。フォルダーを作成するには、カテゴリ内の設定を選択し、をクリックしてフォルダー名を指定します。カテゴリだけにフォーカスがある場合は、空のフォルダーが作成されます。次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたはボタンとボタンを使用します。グループ化を解除するには、フォルダーを選択してをクリックします。
		このボタンをクリックすると、設定がアルファベット順にソートされます。

共通オプション

項目	説明
命名方法名	実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。
プロジェクトファイルとして保存する。	実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、構成をプロジェクト内の任意の他のディレクトリに保存できます。デフォルトでは無効になっており、CLion は実行構成設定を .idea/workspace.xml に保存します。

項目

説明

命名方法名

実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。

プロジェクトファイルとして保存する。

実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、 .idea ディレクトリを共有したくない場合は、構成をプロジェクト内の任意の他のディレクトリに保存できます。

デフォルトでは無効になっており、CLion は実行構成設定を .idea/workspace.xml に保存します。

Pytest 固有の設定オプション

項目	説明
Python インタープリター	事前構成された Python インタープリターのいずれかを選択します。
ターゲット: script/module/custom	ドロップダウンからターゲットを選択します: スクリプト: Python ファイルへのパス。モジュール: Python モジュール名とテストクラスインスタンス。カスタム: パス、モジュール、テストクラスインスタンスの任意の組み合わせ。選択したターゲットタイプに応じて、次の値を指定できます。テストファイルへのパス（例: /Users/jetbrains/Car/my_tests/test_car.py ）。パスを入力するか、ボタンをクリックしてプロジェクト構造内のファイルを探します。プロジェクト内のモジュールの名前です（例: `my_tests`）。モジュール名を入力したり、ターゲットモジュールを名前で検索したり、プロジェクト構造内で検索したりすることができます。モジュール、スクリプト、クラス、メソッドのカスタム組み合わせ。例えば、 `my_tests.test_car.TestCar.test_brake` のように、： `my_tests`: パッケージ名 `test_car`: モジュール名 `TestCar`: `test_car` のクラスインスタンス `test_brake`: `TestCar` クラスのメソッド
追加引数	このテキストフィールドには、テストにそのまま渡すフレームワーク固有の追加引数を指定します。例えば： --some-argument=some-value このオプションは推奨されておらず、CLion でサポートされていないものを起動したい上級者だけが使用してください。
キーワード	テスト名に一致する式。 docs.pytest.org(英語) の例を参照してください。
環境変数	参照ボタンをクリックするか、 `Shift+Enter` を押して、「環境変数」ダイアログで目的の環境変数のセットを指定します。新しい変数を作成するには、をクリックして希望の名前と値を入力します。
Docker コンテナーの設定このフィールドは、プロジェクトに Docker ベースのリモートインタープリターが選択されている場合にのみ表示されます。設定といくつかのオプション（`--net`、 `--リンク` など）との対応について言えば、これらのオプションは Docker コマンドライン引数(英語)からのものであることに注意してください。をクリックしてダイアログを開き、以下の設定を指定します。
オプション	ネットワークを無効にする：ネットワークを無効にするには、このチェックボックスを選択してください。これは `--net="none"` に対応し、コンテナ内では外部ネットワークリソースが利用できないことを意味します。ネットワークモード: オプション `--net` の他の値に対応します。 `bridge` がデフォルト値です。ブリッジのネットワーク上のコンテナーに IP アドレスが割り当てられ、トラフィックはこのブリッジを介してコンテナーにルーティングされます。コンテナーは、デフォルトで IP アドレスを介して通信できます。名前で通信するには、リンクする必要があります。 `共有セッションには、ホスト`: コンテナー内のホストのネットワークスタックを使用します。 `container:<name\|id>`: 名前または ID で指定された別のコンテナーのネットワークスタックを使用してください。詳細については、ネットワーク設定(英語)のドキュメントを参照してください。リンク: このセクションを使用して、作成するコンテナーを他のコンテナーとリンクします。これは `Network mode = bridge` に適用され、 `--リンク` オプションに対応します。すべてのポートを公開する: すべてのコンテナーポートをホストに公開します。これはオプション `--publish-all` に対応します。ポートバインディング：ポートバインディングのリストを指定します。 `docker run` で `-p` オプションを使用するのと同じです。追加ホスト: `--add-host` オプションに対応します。詳細については、「/etc/hosts の管理(英語) 」を参照してください。ボリュームバインディング: このフィールドを使用して、特別なフォルダー (ボリューム) と、Docker デーモンが実行されるコンピューターのフォルダー間のバインドを指定します。 `-v` オプションに対応します。詳細については、「コンテナー内のデータを管理する(英語) 」を参照してください。環境変数: このフィールドを使用して、環境変数とその値のリストを指定します。これは `-e` オプションに対応します。詳細については、「ENV (環境変数)(英語) 」を参照してください。をクリックしてテーブルを展開します。、、をクリックしてリストを作成します。

追加オプション

オプションを変更をクリックし、ダイアログに追加したいオプションを選択してください。

オペレーティングシステム

項目	説明
複数のインスタンスを許可する	この実行構成の複数のインスタンスを並行して実行できるようにします。デフォルトでは無効になっており、別のインスタンスがまだ実行中にこの構成を開始すると、CLion は実行中のインスタンスを停止して別のものを開始するよう提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

項目

説明

複数のインスタンスを許可する

この実行構成の複数のインスタンスを並行して実行できるようにします。

デフォルトでは無効になっており、別のインスタンスがまだ実行中にこの構成を開始すると、CLion は実行中のインスタンスを停止して別のものを開始するよう提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。

Python

項目	説明
インタープリターオプション	このフィールドで、インタープリターに渡されるコマンドラインオプション(英語)を指定します。必要に応じて、をクリックし、エディターに文字列を入力します。
PYTHONPATH にコンテンツルートを追加する	プロジェクト内のすべてのコンテンツルートを環境変数 PYTHONPATH に追加するには、このチェックボックスを選択してください。
PYTHONPATH にソースルートを追加する	プロジェクトのすべてのソースルートを環境変数 PYTHONPATH に追加するには、このチェックボックスを選択してください。

デバッグ

項目	説明
自分のコードのみデバッグする	このオプションを有効にすると、デバッガーはユーザーが記述したコードのみに焦点を当て、外部ライブラリへのステップインをスキップします。

ログ

次のオプションは、この構成の実行のログ記録に関連しています。詳細については、を参照してください。

項目	説明
コンソールに表示するログを指定する。	アプリケーション実行中に表示するログファイルを指定します。をクリックして新しいログを追加します。ログファイルエイリアスの編集ダイアログで、次のように構成します。エイリアス: ログが表示されるタブの名前。ログファイルのロケーション: ログファイルまたは Ant パターン(英語)へのパスを指定します。ローリングログの複数ファイルがパターンに一致する場合、CLion は最も新しいものを表示します。パターンでカバーできるすべてのファイルを表示する。: パターンに一致するすべてのログを表示します。テーブル内のログに対して、次のオプションを構成できます：アクティブ: 指定したログファイルを表示します。内容のスキップ: 以前の実行からの古いログメッセージを表示しません。
コンソール出力をファイルに保存する	コンソール出力を指定の場所に保存します。パスを手動で入力するか、参照ボタンをクリックして表示されるダイアログで目的の場所を指定します。
メッセージが標準出力に出力されたときにコンソールを表示する	アプリケーションが標準出力ストリームに書き込む際にコンソールを有効化します。
メッセージが標準エラーに出力されたときにコンソールを表示する	アプリケーションが標準エラーストリームに書き込む際にコンソールを有効化します。

起動前

項目	説明
開始時に実行 / デバッグツールウィンドウを開く	デフォルトではこのオプションが選択されており、実行 / デバッグ構成を開始すると、実行またはデバッグツールウィンドウが開きます。そうでない場合、ツールウィンドウは非表示になります。ただし、設定の実行中は、 `Alt+4` または `Alt+5` を押すことで、対応するツールウィンドウを自分で開くことができます。
開始時に実行/デバッグツールウィンドウにフォーカスする	このオプションを選択すると、実行 / デバッグ構成を開始したときに、実行またはデバッグツールウィンドウに自動的にフォーカスが移動します。
開始前に実行 / デバッグ構成を表示する	このオプションを選択すると、実行／デバッグ構成を実際に開始する前に、実行／デバッグ構成の設定が表示されます。
起動前タスクの追加	このオプションを選択すると、以下の利用可能なタスクのいずれかを追加できます。外部ツールの実行: 外部アプリケーションを実行することを選択します。開いたダイアログで、実行する 1 つまたは複数のアプリケーションを選択します。 CLion でまだ定義されていない場合は、定義を追加してください。詳細については、外部ツールおよび外部ツールを参照してください。別の構成を実行: 別の実行 / デバッグ構成を実行することを選択し、それが完了するまで待ってから現在の構成を開始します。複数の構成を並行して実行する場合は、複合実行 / デバッグ構成を使用してください。ファイル監視の実行：このオプションを選択すると、CLion ですべての現在アクティブな File Watchersが適用されます。 Grunt タスクの実行: Grunt タスクを実行するには、このオプションを選択してください。表示される Grunt タスクダイアログで、必要なタスクが定義されている Gruntfile.js を指定し、実行するタスクを選択して、Grunt ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 grunt-cli パッケージへのパスを指定します。 gulp タスクの実行: Gulp タスクを実行するには、このオプションを選択してください。表示される Gulp タスクダイアログで、必要なタスクが定義されている Gulpfile.js を指定し、実行するタスクを選択して、Gulp ツールに渡す引数を指定します。 Node.js ランタイムの場所、それに渡すパラメーター、 gulp パッケージへのパスを指定します。 npm スクリプトを実行する。: npm スクリプトを実行するには、このオプションを選択してください。開いた NPM スクリプトダイアログで、 npm 実行 / デバッグ構成設定を指定します。 TypeScript のコンパイル: 組み込み TypeScript コンパイラーを実行するように選択し、TypeScript コードに加えたすべての変更が生成された JavaScript ファイルに反映されるようにします。表示される TypeScript のコンパイル設定ダイアログで、エラーの確認チェックボックスを選択または選択解除して、エラーが検出された場合のコンパイラーの動作を設定します。エラーの確認チェックボックスが選択されていると、コンパイラーはすべてのエラーを表示し、実行構成は開始されません。エラーの確認チェックボックスがオフの場合、コンパイラーは検出されたすべてのエラーを表示しますが、実行構成は起動されます。 CoffeeScript ソースマップの生成：このオプションを選択すると、 CoffeeScriptソースのソースマップが生成されます。表示されるダイアログで、CoffeeScript のソースファイルがある場所を指定します。

2026 年 7 月 15 日