実行 / デバッグ構成: pytest
このダイアログを使用して、pytest(英語) の実行 / デバッグ構成を作成します。
構成タブ
項目 | 説明 |
|---|---|
pytest | |
ターゲット: script/module/custom | ドロップダウンからターゲットを選択します:
選択したターゲットタイプに応じて、次の値を指定できます。
|
追加引数 | このテキストフィールドで、テストにそのまま渡される追加のフレームワーク固有の引数を指定します。例:
--some-argument=some-value
|
キーワード | テスト名に一致する式。docs.pytest.org(英語) の例を参照してください。 |
Pytest パラメーター | パラメーター化されたテストのどのデータサンプルを実行するかを指定できます。 例: サンプルテストのこのフィールドに
import pytest
@pytest.mark.parametrize("foo,bar", [
(1, 1),
(2, 2),
(3, 3),
])
def test_true(foo, bar):
assert foo == bar
その結果、ターミナルで |
環境変数 | 参照ボタンをクリックするか、Shift+Enter を押して、「環境変数」ダイアログで目的の環境変数のセットを指定します。新しい変数を作成するには、 |
Python インタープリター | リストから事前設定された Python インタープリターの 1 つを選択してください。 |
インタープリターオプション | このフィールドで、インタープリターに渡されるコマンドラインオプション(英語)を指定します。必要に応じて、 |
作業ディレクトリ | 実行中のタスクが使用するディレクトリを指定します。
このフィールドではパス変数を使用できます。 |
PYTHONPATH にコンテンツルートを追加する | このチェックボックスを選択して、プロジェクトのすべてのコンテンツルートを環境変数 PYTHONPATH に追加します。 |
PYTHONPATH にソースルートを追加する | このチェックボックスを選択して、プロジェクトのすべてのソースルートを環境変数 PYTHONPATH に追加します。 |
Docker コンテナーの設定 | |
オプション |
|
ログ
これらの設定を使用して、実行中またはデバッグ中に生成されるログファイルをコンソール、つまり実行またはデバッグツールウィンドウの専用タブに表示するかを指定します。
ログフィールドを有効にする方法については、ログオプションの設定を参照してください。
項目 | 説明 |
|---|---|
アクティブ | この列のチェックボックスを選択すると、ログエントリが実行ツールウィンドウまたはデバッグツールウィンドウの対応するタブに表示されます。 |
ログファイルエントリ | この列の読み取り専用フィールドには、表示するログファイルの一覧が表示されます。リスト
|
内容のスキップ | 選択したログの以前の内容をスキップするには、このチェックボックスを選択します。 |
コンソール出力をファイルに保存する | このチェックボックスを選択して、コンソール出力を指定した場所に保存します。パスを手動で入力するか、参照ボタンをクリックして、表示されるダイアログで目的の場所をポイントします。 |
メッセージが標準出力ストリームに出力されたときにコンソールを表示する | 関連付けられているプロセスが Standard.out に書き込んだ場合は、このチェックボックスをオンにして出力コンソールをアクティブにして前面に表示します。 |
メッセージがエラー出力ストリームに出力されたときにコンソールを表示する | 関連付けられているプロセスが Standard.err に書き込んだ場合は、このチェックボックスをオンにして出力コンソールをアクティブにして前面に表示します。 |
| このボタンをクリックするとログファイルエイリアスの編集ダイアログが開き、新しいログエントリを選択してエイリアスを指定できます。 |
| このボタンをクリックすると、ログファイルエイリアスの編集ダイアログの選択したログファイルエントリのプロパティを編集できます。 |
| 選択したログエントリをリストから削除するには、このボタンをクリックします。 |
| このボタンをクリックすると、選択ログファイルのエントリを編集できます。このボタンは、項目が選択されている場合にのみ使用できます。 |
共通設定
実行構成を編集するとき(ただし実行構成テンプレートは編集しないとき)、次のオプションを指定できます。
項目 | 説明 |
|---|---|
名前 | 実行構成の名前を指定して、編集または実行時に他の構成の間ですばやく識別できるようにします。 |
複数のインスタンスを許可する | この実行構成の複数のインスタンスを並行して実行できるようにします。 デフォルトでは無効になっており、別のインスタンスがまだ実行されているときにこの構成を開始すると、PyCharm は実行中のインスタンスを停止して別のインスタンスを開始することを提案します。これは、実行構成が多くのリソースを消費し、複数のインスタンスを実行する正当な理由がない場合に役立ちます。 |
プロジェクトファイルとして保存 | 実行構成設定を含むファイルを保存して、他のチームメンバーと共有します。デフォルトの場所は .idea/runConfigurations です。ただし、.idea ディレクトリを共有したくない場合は、プロジェクト内の他のディレクトリに構成を保存できます。 デフォルトでは無効になっており、PyCharm は実行構成設定を .idea/workspace.xml に保存します。 |
ツールバー
実行 / デバッグ構成のツリー表示には、プロジェクトで使用可能な構成を管理したり、デフォルトの構成テンプレートを調整したりするのに役立つツールバーがあります。
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | 実行 / デバッグ構成を作成します。 |
| Alt+Delete | 選択した実行 / デバッグ構成を削除します。デフォルト設定は削除できません。 |
| Ctrl+D | 選択した実行 / デバッグ構成のコピーを作成します。デフォルト設定のコピーを作成してください。 |
| このボタンは、一時的な構成を選択した場合にのみ表示されます。このボタンをクリックして、一時的な構成を永続的なものとして保存します。 | |
| 新しいフォルダーに移動 / 新しいフォルダーを作成します。実行 / デバッグ構成は、フォルダーに配置することでグループ化できます。 フォルダーを作成するには、カテゴリ内の設定を選択し、 次に、設定をフォルダー内、フォルダー間、フォルダー外に移動するには、ドラッグまたは グループ化を解除するには、フォルダーを選択して | |
| このボタンをクリックすると、設定がアルファベット順にソートされます。 |
起動前
この領域では、選択した実行 / デバッグ構成を開始する前に実行するタスクを指定できます。タスクは、リストに表示されている順序で実行されます。
項目 | ショートカット | 説明 |
|---|---|---|
| Alt+Insert | このアイコンをクリックして、以下の使用可能なタスクのいずれかを追加します。
|
| Alt+Delete | このアイコンをクリックして、選択したタスクをリストから削除します。 |
| Enter | 選択したタスクを編集するには、このアイコンをクリックします。開いたダイアログで必要な変更を加えます。 |
| Alt+Up Alt+Down | これらのアイコンをクリックして、選択したタスクをリスト内で 1 行上または下に移動します。タスクは、リストに表示されている順に実行されます。 |
このページを表示する | 実行 / デバッグ構成を実際に開始する前に、実行 / デバッグ構成設定を表示するには、このチェックボックスを選択します。 | |
ツールウィンドウをアクティブにする | デフォルトではこのチェックボックスは選択されており、実行 / デバッグ構成を開始すると実行またはデバッグツールウィンドウが開きます。 それ以外の場合、チェックボックスがオフの場合、ツールウィンドウは非表示になります。ただし、構成が実行されている場合は、Alt+4 または Alt+5 を押すことにより、構成に対応するツールウィンドウを自分で開くことができます。 |
関連ページ:
Pytest
PyCharm は、完全な機能テストフレームワーク pytest をサポートしています。次の機能が利用できます。専用テストランナー。テスト対象と pytest フィクスチャのコード補完。コードナビゲーション。詳細な失敗アサートレポート。Python 2.7 および Python 3.5 以降をサポートします。マルチプロセッシングテストの実行。デフォルトでは、推奨されるデフォルトのテストランナーは unittest です。pytest を利用するには、最初にそれをデフォルトのテストランナーにする必要があり...
パス変数
パス変数を使用して、特定のプロジェクトの一部ではないリソースへの絶対パスを定義します。これらの外部リソースは、チームメイトのコンピューターのさまざまな場所にある場合があります。これが、ユーザー定義のカスタムパス変数がプロジェクト設定として保存されず、グローバル IDE 設定として保存される理由です。設定が完了すると、そのようなパス変数は、PyCharm のインスタンスで開くすべてのプロジェクトに対して同じ値になります。新しいパス変数を作成するを押して設定を開き、を選択します。をクリックし、変数の...
コンテンツルート
PyCharm では、コンテンツは現在作業しているファイルの集まりであり、おそらくサブフォルダーの階層に編成されています。この階層の最上位にあるフォルダーは、コンテンツルートフォルダーまたはコンテンツルート (と表示) と呼ばれます。プロジェクトには少なくとも 1 つのコンテンツルートフォルダーがあり、既定ではプロジェクトフォルダー自体です。いくつかのコンテンツルートを持つことで、共通の直系親を持たない複数のディレクトリからのファイルを扱うことができます。これは、静的コンテンツ(アイコンなど)を使...
Docker
Docker は、分離された再現可能な環境で実行可能ファイルをデプロイおよび実行するためのツールです。これは、たとえば、本番環境と同じ環境でコードをテストする場合に役立ちます。PyCharm は Docker 機能を統合し、Docker イメージの作成、Docker コンテナーの実行、Docker Compose アプリケーションの管理、パブリックおよびプライベート Docker レジストリの使用など、IDE から直接実行するための支援を提供します。Docker コンテナーにデプロイされたさまざま...
デバッグツールウィンドウ
デバッガーセッションを開始すると、デバッグツールウィンドウが開きます。このウィンドウを使用して、デバッガーセッションを制御し、プログラムデータ (フレーム、変数など) を表示および分析し、デバッガーアクションを実行します。デフォルトでは、プログラムがブレークポイントに到達したときにデバッグツールウィンドウが開き、セッションが終了しても非表示になりません。この動作を変更するには、ビルド、実行、デプロイ | デバッガー設定ページに移動し、ブレークポイントでデバッグウィンドウを表示するチェックボック...
ログオプションの設定
実行 / デバッグ構成ダイアログのログタブを使用して、アプリケーションまたはサーバーによって生成されたログファイルがコンソールに表示される方法を設定します。アプリケーションまたはサーバーがログファイルを生成する場合、デフォルトのエントリは自動的に実行 / デバッグ構成ダイアログのログファイルリストに追加されます。ログのオプションを設定するに進みます。または、実行ウィジェットでクリックし、ドロップダウンメニューから実行構成の編集を選択します。オプションを変更をクリックし、コンソールに表示するログ...