PyCharm 2024.1 ヘルプ

テスト結果を調べる

PyCharm でテストが実行されている間、テスト実行は実行ツールウィンドウのその実行構成のタブに表示されます。テスト実行が終了すると、そのタブでテスト結果を確認できます。

右側のコンソールには、現在のテストセッションの出力が表示されます。テストの実行に関する詳細情報と、テストが失敗したか無視された理由を確認できます。

テスト結果リストの上にあるテスト結果ツールバーを使用すると、成功したテストと無視されたテストの表示と非表示を切り替えたり、各テストの実行にかかった時間を表示したり、テスト結果をエクスポートインポート並べ替えたりすることができます。

実行構成タブの各テストの横に、IDE はテストステータスアイコンを表示します。

アイコン

説明

Test error

テストエラー。このステータスは、テスト済みのソースコードから例外を発生させたテストに割り当てられます。

Test failed

テストに失敗しました。少なくとも 1 つの子テストが失敗した場合、そのすべての親テストが失敗としてマークされます。

Test ignored

テストが無視されました。

Test in progress

テスト中です。

Test passed

テストは正常に終了しました。

Terminated

テストは終了しました。このステータスは、停止されたテストに割り当てられます。

少なくとも 1 つのテストがこのステータスを受け取ると、すべての未完了のテストとその親テストに終了のマークが付けられます。

テスト結果の並べ替えとフィルタリング

失敗したテストのみに焦点を当てる場合、またはテスト結果を再編成する場合は、テスト結果ツールバーの次のオプションを使用します。

  • 成功したテストを非表示にするには、the Show Passed button 成功を表示オプションを無効にします。

  • 無視されたテストを非表示にするには、the Show Ignored button 無視対象を表示オプションを無効にします。

  • the Sorting Options button をクリックし、テスト結果を並べ替える方法を選択します。

    • スイートを常に上に表示 – クリックすると上部にスイートが表示されます。

    • アルファベット順に並べ替え – クリックすると、テスト結果がアルファベット順に並べ替えられます。

    • 時間で並べ替え – クリックしてテストノードをリストの先頭に配置します。

テスト結果を管理する

  • テスト結果ツールバーで the More button をクリックし、テストランナーの設定を選択して、次のオプションを有効にします。

    • 実行中のテストを追跡 : 現在のテストの実行を監視します。

    • インライン統計情報を表示 : テストの実行時間を表示します。

    • スイートを常に上に表示 : 並べ替えを適用するときは、常にテストノードをリストの一番上に配置してください。

    • スタックトレースへスクロール : テストが失敗する前に大量の出力 (ログなど) を生成した場合、このオプションは、実行構成タブでテストを選択すると、出力コンソールをアサーション失敗まで自動的にスクロールします。

    • 例外のソースを開く : このオプションをオンにして実行構成タブで失敗したテストメソッドをダブルクリックすると、エディターは例外がスローされた行までスクロールします (テストメソッドの宣言までスクロールする代わりに)。

    • シングルクリックで移動 : 選択したテストのコードをエディターで自動的に開きます。

    • 終了時に最初の失敗したテストを選択 : テストセッションが完了すると、リストで最初に失敗したテストが自動的に選択されます。

assertEquals の相違点を表示

単体テストに文字列 assertEquals エラーが含まれている場合、IDE を使用して文字列を比較し、相違点を表示できます。

  • 必要なテストを右クリックし、コンテキストメニューから assertEquals の相違点を表示を選択します。

    専用の差分ビューアーで文字列を比較できるようになります。

    Viewing assertEquals difference

以前のテストの結果を表示する

PyCharm は、最後の 10 回のテストセッションの結果を自動的に保存します。最近のテストセッションのリストを開くには:

  • テスト結果ツールバーの Test History アイコンをクリックし、リストから必要なテストセッションを選択します。

    各テストセッションのリストには、実行構成名とタイムスタンプが表示されます。

    Viewing results of previous tests

    テスト結果を保持したり、チームと共有したりする場合は、テスト結果をファイルにエクスポートすることもできます。

テスト結果のエクスポートとインポート

テスト結果をファイルにエクスポートする

  1. テスト結果ツールバーで The More button をクリックし、次に テスト結果のエクスポートをクリックします。

  2. ファイルを保存する形式を選択します。

    • HTML : 定義済みのテンプレートから HTML ファイルを生成します。

    • XML : このファイルを後で PyCharm にインポートする場合は、この形式を使用してください。

    • カスタム、XSL テンプレートを適用する : カスタム XSL(英語) テンプレートを使用して、生の XML 出力から HTML ファイルを生成します。このオプションの横にある Browse button をクリックし、*.xsl コードスタイル定義ファイルを選択します。

  3. 出力ファイルの名前とその場所を指定します。

  4. エクスポート後にブラウザーでファイルを開く場合は、エクスポートしたファイルをブラウザーで開くチェックボックスをオンにします。OK をクリックします。

テスト結果のインポート

  1. 以前にエクスポートしたファイルを読み込むには、テスト結果ツールバーの Import Tests from File をクリックします。

    まだテストを実行しておらず、テスト結果ツールバーを含むツールウィンドウが使用できない場合は、Ctrl+Shift+A を押して Import Tests from File と入力します。

  2. 開いたファイルシステムダイアログで、テスト結果を含む .xml ファイルを選択し、開くをクリックします。

関連ページ:

ファイルの差分ビューアー

この差分ビューアーは、2 つのファイルまたはファイルの 2 つのバージョン (ローカルの変更、またはローカルファイルとリモートリポジトリ内のそのリビジョン間の変更) を比較するときに表示されます。バイナリや .jar ファイルなど、あらゆる種類のファイルを比較できます。これを開くには、比較する 2 つのファイル、またはそのバージョンを比較するファイルを選択し、を押します。差分ビューアーが新しいタブで開きます。差分ビューアーは、コード補完、ライブテンプレート、その他の機能を有効にする強力なエディター...

実行 / デバッグ構成

PyCharm は、実行 / デバッグ構成を使用して、コードを実行、デバッグ、テストします。各構成は、何を実行し、どのパラメーターと環境を使用するかを定義する、名前付きのスタートアッププロパティのセットです。さまざまな起動プロパティを使用して、PyCharm がスクリプトを実行するために使用するさまざまな方法を定義できます。例: 異なる Python インタープリターを使用して同じコードを実行し、さまざまな環境変数のセットを提供し、代替ファイルから入力値を取得できます。実行 / デバッグ構成には...

テストの監視と管理

テストの進行状況と結果は、実行ツールウィンドウの専用のテストランナータブに表示されます。where: 実行ツールバーは実行ツールウィンドウのツールバーとほぼ同じですが、テスト固有のボタンを備えています。左側のペインには、現在の実行 / デバッグ構成内のすべてのテストのツリービューが表示されます。ルートノードは、実行するように選択されたテストを表します。ネストされたノードは、テストスイートとテストケースの階層を表します。リーフノードは個々のテストを表します。各テストのステータスはアイコンで示されます...

Pytest

PyCharm は、完全な機能テストフレームワーク pytest をサポートしています。次の機能が利用できます。専用テストランナー。テスト対象と pytest フィクスチャのコード補完。コードナビゲーション。詳細な失敗アサートレポート。Python 2.7 および Python 3.5 以降をサポートします。マルチプロセッシングテストの実行。デフォルトでは、推奨されるデフォルトのテストランナーは unittest です。pytest を利用するには、最初にそれをデフォルトのテストランナーにする必要があり...