Bazel には、コード カバレッジを生成する coverage サブコマンドがあります
bazel coverage でテストできるリポジトリに関するレポート。期限
さまざまな言語エコシステムの特異性にかかわるものですが、
特定のプロジェクトでこれを行うのは簡単です。
このページでは、Google Cloud Storage バケットを レポートについても、言語固有の注意事項が示されています。 よく知られた言語の人だけが使用できます。最初に読むことをおすすめします 全般的なセクションを読んでから ご覧ください。また、 リモート実行セクション。いくつかの 考慮事項を確認します
さまざまなカスタマイズが可能ですが、このドキュメントでは、
lcov レポートの作成と使用が可能です。
ルートの 1 つです
カバレッジ レポートを作成する
準備
カバレッジ レポートを作成する基本的なワークフローでは、 次のとおりです。
- テスト ターゲットを含む基本的なリポジトリ
- 言語固有のコード カバレッジ ツールがインストールされたツールチェーン
- 正しい「計測」構成
前の 2 つは言語固有で ほとんどがわかりやすいので 複雑なプロジェクトでは後者の方が 難しい場合があります
"インストルメンテーション"カバレッジツールは
使用されます。Bazel を使用すると、
サブセットを 1 つに
--instrumentation_filter
フラグ。
インストルメンテーションが有効になっていることを確認しますテストでインストルメンテーションを有効にするには、
--instrument_test_targets
フラグは必須です。
デフォルトでは、bazel はターゲット パッケージの照合を試み、
INFO メッセージとして返すことができます。
実行中のカバレッジ
カバレッジ レポートを作成するには、bazel coverage
--combined_report=lcov
[target] を使用します。これにより、
ターゲットのテスト、lcov 形式でのカバレッジ レポートの生成
おすすめします。
完了したら、Bazel は生成されたすべての
1 つにマージします
$(bazel info
output_path)/_coverage/_coverage_report.dat に作成。
テストが失敗した場合でもカバレッジ レポートが生成されますが、 不合格になったテストはこれにとどまりません。合格したテストのみが 報告されます。
カバレッジの表示
カバレッジ レポートは、人が読める形式の lcov でのみ出力されます。
使用できます。ここから、genhtml ユーティリティ（lcov の一部）を
プロジェクト）を使用して、ウェブで表示できるレポートを作成します。
browser:
genhtml --branch-coverage --output genhtml "$(bazel info output_path)/_coverage/_coverage_report.dat"
genhtml はソースコードも読み取って、欠損値にアノテーションを付けます。
です。これが機能するには、次のことが期待されます。
genhtml は、bazel プロジェクトのルートで実行されます。
結果を表示するには、Terraform で生成された index.html ファイルを開くだけです。
任意のウェブブラウザの genhtml ディレクトリ。
genhtml ツールに関するその他のヘルプと情報については、
lcov カバレッジ形式については、lcov プロジェクトをご覧ください。
リモート実行
現在、リモートテスト実行で実行する場合、いくつかの注意点があります。
- レポートの組み合わせの操作はまだリモートで実行できません。これは、
Bazel では、カバレッジ出力ファイルが
（この問題を参照）、
組み合わせアクションへの入力として正しく扱いません。宛先
--strategy=CoverageReport=localを使用してください。- 注: 次のように指定する必要がある場合があります。
Bazel が設定されている場合、代わりに
--strategy=CoverageReport=local,remoteBazel によるストラテジーの解決により、local,remoteが試行されます。
- 注: 次のように指定する必要がある場合があります。
Bazel が設定されている場合、代わりに
--remote_download_minimalなどのフラグは使用できません。 影響しています- テストを行うと、Bazel は現在、カバレッジ情報の作成に失敗します。
キャッシュに保存されています。この問題を回避するには
--nocache_test_resultsは、カバレッジ実行専用に設定できます。 ただし テスト時間の面で大きなコストがかかります --experimental_split_coverage_postprocessing、--experimental_fetch_all_coverage_outputs<ph type="x-smartling-placeholder">- </ph>
- 通常、カバレッジはテスト アクションの一環として実行されるため、 デフォルトでは、すべてのカバレッジがリモート リソースの出力として返されるわけではありません。 実行されています。これらのフラグはデフォルトをオーバーライドし、 適用範囲データを抽出できます。詳しくは、この問題をご覧ください。 表示されます。
言語固有の構成
Java
Java は、デフォルトの構成ですぐに使用できます。「 bazel ツールチェーンには、移行に必要なすべてのものが リモート実行にも対応しています
Python
rules_python カバレッジのドキュメントをご覧ください。
をご覧ください。