GoLand 2020.3 ヘルプ

テスト用の実行 / デバッグ構成を作成する

ディレクトリでテストを実行する

  1. 実行 | 実行構成の編集にナビゲートします。

  2. 実行 / デバッグ構成ダイアログで、新規構成の追加 Alt+Insert をクリックし、Go テストを選択します。

  3. ディレクトリフィールドで、アプリケーションファイルとテストファイルを含むディレクトリへのパスを指定します(たとえば、applicationFolder/main.goapplicationFolder/main_test.go)。

    (オプション)また、次の設定を指定できます。

    • パターン : サブテストとサブベンチマークを実行するために定義する引数。サブテストとサブベンチマークの詳細については、golang.org のサブテストとサブベンチマーク(英語)を参照してください。次のテスト関数について考えてみます。

      func MyTestFunc(t *testing.T) { ... t.Run("ID=1", func(t *testing.T) { ... }) t.Run("ID=2", func(t *testing.T) { ... }) t.Run("UID=1", func(t *testing.T) { ... }) ... }

      MyTestFunc 関数では、次の go test 引数を使用できます。

      コード 説明
      go test -run すべてのテストを実行。
      go test -run Test Test パターンに一致するテストを実行します(たとえば、MyTestFunc )。
      go test -run MyTestFunc/ID= 最上位の MyTestFunc 関数に属し、ID= パターンに一致するサブテストを実行します。
      go test -run /UID=1 すべてのトップレベルのテスト関数から UID=1 に一致するサブテストを実行します。

      パターンフィールドには、引数のみをリストします(たとえば、TestMyTestFunc/ID=/UID=1 )。

    • 作業ディレクトリ : ビルドされたアプリケーションに使用されるディレクトリ。相対ファイルまたはディレクトリを作成するコードがある場合、それらはこのディレクトリに相対的です。

    • 環境 : テストを実行するために必要な環境変数。

      環境変数を編集するには、フィールドの最後にある参照ボタンをクリックします。環境変数ダイアログで、追加ボタンをクリックし、必要な環境変数を追加します。

      Add an environment variable
    • Go ツール引数 : go ツールの引数(たとえば、-tags )。

    • すべてのカスタムビルドタグを使用する : ビルド中に適用されるすべてのタグ。タグは、Go | ビルドタグとベンダリングの設定 Ctrl+Alt+S にリストされています。

    • プログラム引数 : ビルドされたアプリケーションの引数。

    • sudo で実行する : アプリケーションに sudo 特権を付与します。

    • 起動前: ツールウィンドウをアクティブにする : 選択した実行 / デバッグ構成を起動する前に起動するタスクを追加します。タスクを追加するには、追加ボタン Alt+Insert をクリックして、追加するツールを選択します。

  4. 適用をクリックします。

    Test configuration for a directory

パッケージのテストを実行する

パッケージテストを有効にするには、Ctrl+Alt+S を押して設定を開き、Go | Go モジュールに移動して、Go モジュールの統合を有効にするチェックボックスを選択します。

  1. 実行 | 実行構成の編集にナビゲートします。

  2. 実行 / デバッグ構成ダイアログで、新規構成の追加 Alt+Insert をクリックし、Go テストを選択します。

  3. テスト種類リストから、パッケージを選択します。

  4. ファイルフィールドに、テストファイルの名前( main_test.go など)を入力します。このフィールドではスマート補完 Ctrl+Shift+Space を使用できます。

    (オプション)また、次の設定を指定できます。

    • パターン : サブテストとサブベンチマークを実行するために定義する引数。サブテストとサブベンチマークの詳細については、golang.org のサブテストとサブベンチマーク(英語)を参照してください。次のテスト関数について考えてみます。

      func MyTestFunc(t *testing.T) { ... t.Run("ID=1", func(t *testing.T) { ... }) t.Run("ID=2", func(t *testing.T) { ... }) t.Run("UID=1", func(t *testing.T) { ... }) ... }

      MyTestFunc 関数では、次の go test 引数を使用できます。

      コード 説明
      go test -run '' すべてのテストを実行。
      go test -run Test Test パターンに一致するテストを実行します(たとえば、MyTestFunc )。
      go test -run MyTestFunc/ID= 最上位の MyTestFunc 関数に属し、ID= パターンに一致するサブテストを実行します。
      go test -run /UID=1 すべてのトップレベルのテスト関数から UID=1 に一致するサブテストを実行します。

      パターンフィールドには、引数のみをリストします(たとえば、TestMyTestFunc/ID=/UID=1 )。

    • 出力ディレクトリ : テスト結果が保存されているディレクトリ。

    • 作業ディレクトリ : ビルドされたアプリケーションに使用されるディレクトリ。相対ファイルまたはディレクトリを作成するコードがある場合、それらはこのディレクトリに相対的です。

    • 環境 : テストを実行するために必要な環境変数。

      環境変数を編集するには、フィールドの最後にある参照ボタンをクリックします。環境変数ダイアログで、追加ボタンをクリックし、必要な環境変数を追加します。

      Add an environment variable
    • Go ツール引数 : go ツールの引数(たとえば、-tags )。

    • すべてのカスタムビルドタグを使用する : ビルド中に適用されるすべてのタグ。タグは、Go | ビルドタグとベンダリングの設定 Ctrl+Alt+S にリストされています。

    • プログラム引数 : ビルドされたアプリケーションの引数。

    • sudo で実行する : アプリケーションに sudo 特権を付与します。

    • 起動前: ツールウィンドウをアクティブにする : 選択した実行 / デバッグ構成を起動する前に起動するタスクを追加します。タスクを追加するには、追加ボタン Alt+Insert をクリックして、追加するツールを選択します。

  5. 適用をクリックします。

    Test configuration for a package

ファイルのテストを実行する

  1. 実行 | 実行構成の編集にナビゲートします。

  2. 実行 / デバッグ構成ダイアログで、新規構成の追加 Alt+Insert をクリックし、Go テストを選択します。

  3. テスト種類リストから、ファイルを選択します。

  4. ファイルフィールドに、テストファイルの名前( /Users/jetbrains/runDebugConfigurationsForTests/main_file_test.go など)を入力します。

    ファイルフィールドに他のパスが含まれていないことを確認してください。そうしないと、Named files must all be in one directory エラーが発生します。

    (オプション)また、次の設定を指定できます。

    • 出力ディレクトリ : テスト結果が保存されているディレクトリ。

    • 作業ディレクトリ : ビルドされたアプリケーションに使用されるディレクトリ。相対ファイルまたはディレクトリを作成するコードがある場合、それらはこのディレクトリに相対的です。

    • 環境 : テストを実行するために必要な環境変数。

      環境変数を編集するには、フィールドの最後にある参照ボタンをクリックします。環境変数ダイアログで、追加ボタンをクリックし、必要な環境変数を追加します。

      Add an environment variable
    • Go ツール引数 : go ツールの引数(たとえば、-tags )。

    • すべてのカスタムビルドタグを使用する : ビルド中に適用されるすべてのタグ。タグは、Go | ビルドタグとベンダリングの設定 Ctrl+Alt+S にリストされています。

    • プログラム引数 : ビルドされたアプリケーションの引数。

    • sudo で実行する : アプリケーションに sudo 特権を付与します。

    • 起動前: ツールウィンドウをアクティブにする : 選択した実行 / デバッグ構成を起動する前に起動するタスクを追加します。タスクを追加するには、追加ボタン Alt+Insert をクリックして、追加するツールを選択します。

  5. 適用をクリックします。

    Test configuration for a file