一般的な定義

List of labels ; optional

実行時にこのルールで必要なファイル。ファイルまたはルールのターゲットを一覧表示できます。通常、すべてのターゲットを許可します。

data 属性内のターゲットのデフォルトの出力とランファイルは、このターゲットによって出力される、またはこのターゲットへのランタイムの依存関係がある実行ファイルの *.runfiles 領域に表示されます。これには、このターゲットの srcs の実行時に使用されるデータファイルまたはバイナリが含まれる場合があります。データファイルに依存して使用する方法について詳しくは、データの依存関係をご覧ください。

実行時に他の入力を使用する可能性がある入力を処理する場合は、新しいルールで data 属性を定義する必要があります。ルールの実装関数は、任意の data 属性の出力とランファイルからターゲットのランファイルを入力することも、ソースコードまたはランタイム依存関係を提供する任意の依存関係属性のランファイルにも入力する必要があります。

List of labels ; optional

このターゲットの依存関係。通常は、ルール ターゲットのみを一覧表示します。（一部のルールではファイルを直接 deps にリストできますが、これは可能な限り避ける必要があります）。

言語固有のルールは通常、リストされたターゲットを特定のプロバイダを持つルールに制限します。

deps を使用してターゲットが依存しようとすることの意味の正確なセマンティクスは、ルールの種類によって異なります。また、ルール固有のドキュメントで詳しく説明しています。ソースコードを処理するルールの場合、deps は通常、srcs のコードで使用されるコード依存関係を指定します。

ほとんどの場合、deps 依存関係は、あるモジュールが別のプログラミング言語で定義されたシンボルを同じプログラミング言語で使用し、個別にコンパイルできるようにするために使用します。言語横断的な依存関係も多くの場合許可されています。たとえば、java_library ターゲットを cc_library 属性の C++ コードに依存する場合、後者を deps 属性にリストします。詳細については、依存関係の定義をご覧ください。

List of strings; optional; nonconfigurable

このターゲットに使用するライセンス タイプの文字列のリスト。これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。この属性は使用しないでください。

List of labels ; optional

このルールによって処理または含まれているファイル。通常、ファイルを直接リストしますが、ルール ターゲット（filegroup や genrule など）を表示してデフォルト出力を含めることもできます。

多くの場合、言語固有のルールでは、リストにあるファイルに特定のファイル拡張子が必要です。

List of labels ; optional; nonconfigurable

デフォルトのサポート対象環境に加えて、このターゲットのビルド先となる環境のリスト。

これは Bazel の制約システムの一部であり、ユーザーは依存可能なターゲットと依存できないターゲットを宣言できます。たとえば、外部にデプロイ可能なバイナリは、会社のシークレット コードがあるライブラリに依存しないでください。詳しくは、 ConstraintSemantics をご覧ください。

String; optional; nonconfigurable

このターゲットに関連付けられた警告の警告メッセージ。通常、これはターゲットが古くなった、別のルールに置き換わった、パッケージで非公開になっている、またはなんらかの理由で有害であると見なされることをユーザーに知らせるために使用されます。メッセージを回避するために必要な変更点を簡単に確認できるように、いくつかの参照（ウェブページ、バグ番号、移行 CL の例など）を含めることをおすすめします。代替として使用できる新しいターゲットがある場合は、古いターゲットのすべてのユーザーを移行することをおすすめします。

この属性はビルド方法には影響しませんが、ビルドツールの診断出力に影響する可能性があります。deprecation 属性を含むルールが別のパッケージのターゲットによって依存されている場合は、ビルドツールによって警告が発行されます。

パッケージ内の依存関係はこの警告から除外されます。たとえば、非推奨のルールのテストを作成しても、警告は発生しません。

非推奨のターゲットが別の非推奨のターゲットに依存している場合、警告メッセージは発行されません。

ターゲットの使用を停止すると、ターゲットを削除できます。

List of strings; optional; nonconfigurable

この特定のターゲットに使用される配布方法の文字列のリスト。これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。この属性は使用しないでください。

List of labels ; optional; nonconfigurable

このターゲットの実行プラットフォームに存在する必要がある constraint_values のリスト。これは、ルールタイプによってすでに設定されている制約とは別に適用されます。制約は、使用可能な実行プラットフォームのリストを制限するために使用されます。詳細については、ツールチェーンの解決をご覧ください。

Dictionary of strings; optional

このターゲット用に選択されたプラットフォームの exec_properties に追加される文字列の辞書。プラットフォーム ルールの exec_properties をご覧ください。

プラットフォーム レベルとターゲット レベルのプロパティの両方にキーがある場合、値はターゲットから取得されます。

List of feature strings; optional

特徴は、ターゲットで有効または無効にできる文字列タグです。機能の意味はルール自体によって異なります。

この features 属性は、 パッケージ レベルの features 属性と組み合わされます。たとえば、機能 ["a"、"b"] がパッケージ レベルで有効で、ターゲットの features 属性に ["-a", "c"] が含まれている場合、ルールで有効になる機能は「b」と「c」です。 例を見る

List of labels ; optional; nonconfigurable

デフォルトでサポートされる環境ではなく、このターゲット用に構築できる環境のリスト。

これは Bazel の制約システムの一部です。詳しくは、compatible_with をご覧ください。

List of strings; optional; nonconfigurable

タグはあらゆるルールで使用できます。テストルールと test_suite ルールに対するタグは、テストの分類に役立ちます。テストされていないターゲットのタグは、genrule と Starlark アクションのサンドボックス実行を制御するため、また人間や外部ツールによる解析に使用されます。

テストまたは genrule ターゲットの tags 属性、または Starlark アクションの execution_requirements のキーに次のキーワードが見つかった場合、Bazel はサンドボックス化コードの動作を変更します。

• no-sandbox キーワードの結果、アクションまたはテストはサンドボックス化されません。キャッシュまたはリモートで実行できます。no-cache または no-remote を使用して、これらの両方またはいずれかを防ぐことができます。
• no-cache キーワードの結果、アクションまたはテストは（リモートまたはローカルで）キャッシュに保存されません
• no-remote-cache キーワードの結果、アクションまたはテストはリモートでキャッシュに保存されません（ただし、ローカルにキャッシュされる場合があります。また、リモートで実行される場合もあります）。注: このタグでは、ディスク キャッシュはローカル キャッシュとみなされ、http キャッシュと gRPC キャッシュはリモートとみなされます。ローカル ディスク キャッシュとリモート キャッシュの組み合わせが使用されている場合（組み合わせキャッシュ）、リモート キャッシュとして扱われ、--incompatible_remote_results_ignore_disk が設定されていない限り完全に無効になります。この場合、ローカル コンポーネントが使用されます。
• no-remote-exec キーワードを指定すると、アクションまたはテストはリモートで実行されなくなります（ただし、リモートではキャッシュされる場合があります）。
• no-remote キーワードは、アクションまたはテストがリモートで実行されないように、またはリモートでキャッシュに保存されないようにします。これは、no-remote-cache と no-remote-exec の両方を使用する場合と同じです。
• no-remote-cache-upload キーワードは、スポーンのリモート キャッシュのアップロードを無効にします。リモート実行は無効になりません。
• local キーワードによって、アクションまたはテストがリモートでキャッシュまたはリモートで実行またはサンドボックス内で実行できなくなります。genrules とテストの場合、local = True 属性でルールをマークしても結果は同じです。
• requires-network キーワードを使用すると、サンドボックス内から外部ネットワークにアクセスできます。このタグが有効なのは、サンドボックスが有効になっている場合のみです。
• block-network キーワードは、サンドボックス内からの外部ネットワークへのアクセスをブロックします。この場合、localhost との通信のみが許可されます。このタグが有効なのは、サンドボックスが有効になっている場合のみです。
• requires-fakeroot は、テストまたはアクションを uid と gid 0（root ユーザー）として実行します。これは Linux でのみサポートされています。このタグは、--sandbox_fake_username コマンドライン オプションよりも優先されます。

通常、テストのタグは、デバッグおよびリリース プロセスにおけるテストの役割にアノテーションを付けるために使用されます。通常、タグは、ランタイムのアノテーションがない C++ テストと Python テストで特に便利です。タグとサイズの要素を使用すると、コードベースのチェックイン ポリシーに基づいて一連のテストを柔軟に組み立てることができます。

テストルールの tags 属性に次のキーワードが見つかった場合、Bazel はテスト実行の動作を変更します。

• exclusive は、テストを強制的に「排他的」モードで実行し、他のテストが同時に実行されないようにします。このようなテストは、すべてのビルド アクティビティと非独占テストの完了後に、シリアルで実行されます。Bazel はリモートマシンで実行されているものを制御できないため、このようなテストではリモート実行は無効になります。
• exclusive-if-local は、ローカルで実行した場合はテストを「排他的」モードに実行しますが、リモートで実行した場合はテストを並行して実行します。
• manual キーワードを使用すると、ターゲット パターンのワイルドカード（...、:*、:all など）と test_suite ルールが除外されます。これらのルールでは、build、test、coverage コマンドのビルドと実行に使用するトップレベル ターゲットのセットを計算する際に、テストを明示的に指定することはできません。query コマンドを含む他のコンテキストでは、ターゲット ワイルドカードやテストスイートの拡張には影響しません。manual は、継続的なビルドシステムやテストシステムによって自動的にターゲットがビルドまたは実行されるべきということを意味しません。たとえば、特定の Bazel フラグを必要とするものの、適切に構成された presubmit または継続的テスト実行に含まれているターゲットを bazel test ... から除外することが望ましい場合があります。
• external キーワードは、（--cache_test_results の値に関係なく）無条件にテストを実行します。

List of labels ; optional

このターゲットが互換性があると見なされるには、ターゲット プラットフォームに存在する必要がある constraint_value のリスト。これは、ルールタイプですでに設定されている制約に加えて適用されます。ターゲット プラットフォームがリストにあるすべての制約を満たしていない場合、ターゲットは互換性がないとみなされます。互換性のないターゲットは、ターゲット パターンが拡張されている場合（例: //...、:all）に、ビルドとテストのためにスキップされます。互換性のないターゲットがコマンドラインで明示的に指定された場合、Bazel はエラーを出力し、ビルドまたはテストの失敗を引き起こします。

互換性のないターゲットに推移的に依存するターゲット自体は互換性がないとみなされます。また、ビルドとテストもスキップされます。

空のリスト（デフォルト）は、ターゲットがすべてのプラットフォームと互換性があることを示します。

Workspace ルール以外のすべてのルールでこの属性がサポートされます。一部のルールでは、この属性は効果がありません。たとえば、cc_toolchain に target_compatible_with を指定しても意味がありません。

互換性のないターゲットのスキップについて詳しくは、プラットフォームのページをご覧ください。

Boolean; optional; default False except for test and test suite targets; nonconfigurable

True の場合、テスト専用ターゲット（テストなど）のみがこのターゲットに依存できます。

同様に、testonly でないルールを testonly であるルールに依存することはできません。

テスト（*_test ルール）とテストスイート（test_suite ルール）はデフォルトで testonly です。

この属性は、本番環境にリリースされるバイナリにターゲットが含まれないようにすることを目的としています。

testonly は実行時ではなくビルド時に適用され、依存関係ツリーにクチコミが拡散するため、慎重に適用する必要があります。たとえば、単体テストに役立つスタブと疑似も、本番環境にリリースされるのと同じバイナリを使用する統合テストに役立つ可能性があるため、テスト専用としてマークするべきではありません。逆に、通常の動作を無条件にオーバーライドするなど、リンクするのも危険なルールは、確実にテスト専用としてマークする必要があります。

List of labels ; optional; nonconfigurable

この変数に変数の作成を許可するターゲットのセット。これらのターゲットは、TemplateVariableInfo を提供するルールのインスタンスか、Bazel に組み込まれているツールチェーン タイプ用の特別なターゲットです。次に例を示します。

• @bazel_tools//tools/cpp:current_cc_toolchain
• @bazel_tools//tools/jdk:current_java_runtime

これは、プラットフォームに依存する構成のルール実装で使用されるツールチェーンの解決のコンセプトとは異なることに注意してください。この属性を使用して、ターゲットで使用する特定の cc_toolchain または java_toolchain を決定することはできません。

List of labels ; optional; default default_visibility from package if specified, or //visibility:private otherwise; nonconfigurable

ターゲットの visibility 属性は、ターゲットを他のパッケージで使用できるかどうかを制御します。可視性に関するドキュメントをご覧ください。

List of strings; optional; subject to $(location) and "Make variable" substitution, and Bourne shell tokenization

bazel test で Bazel がターゲットに渡されるときに渡すコマンドライン引数。

これらの引数は、bazel test コマンドラインで指定された --test_arg 値の前に渡されます。

Dictionary of strings; optional; values are subject to $(location) and "Make variable" substitution

bazel test によってテストの実行時に設定される追加の環境変数を指定します。

この属性は、cc_test、py_test、sh_test などのネイティブ ルールにのみ適用されます。Starlark で定義されたテストルールには適用されません。独自の Starlark ルールでは、「env」属性を追加し、それを使用して TestEnvironment プロバイダにデータを入力できます。

List of strings; optional

bazel test によってテストが実行されたときに、外部環境から継承する追加の環境変数を指定します。

この属性は、cc_test、py_test、sh_test などのネイティブ ルールにのみ適用されます。Starlark で定義されたテストルールには適用されません。

String "enormous", "large" "medium" or "small", default is "medium"; optional; nonconfigurable

テスト ターゲットの「負荷」を指定します。実行に必要な時間やリソースの量などです。

単体テストは「小規模」、統合テストは「中」、エンドツーエンド テストは「大規模」または「大規模」とみなされます。Bazel は、サイズを使用してデフォルトのタイムアウトを決定します。これは timeout 属性でオーバーライドできます。タイムアウトは、個々のテストではなく、BUILD ターゲット内のすべてのテストで発生します。テストをローカルで実行する場合、スケジューリングのために size も使用します。Bazel は --local_{ram,cpu}_resources を優先し、大量の負荷を同時にテストすることでローカルマシンに負荷をかけないようにしようとします。

テストサイズは、次のデフォルトのタイムアウトに対応し、ローカル リソースのピーク使用量を想定しています。

テストを生成するときに、環境変数 TEST_SIZE がこの属性の値に設定されます。

String "short", "moderate", "long", "eternal" (with the default derived from the test's size attribute); nonconfigurable

テストの実行が終わるまでの推定時間。

テストのサイズ属性はリソースの見積もりを制御しますが、テストのタイムアウトは個別に設定できます。明示的に指定しない場合、タイムアウトはテストのサイズに基づきます。テスト タイムアウトは、--test_timeout フラグを使用してオーバーライドできます。たとえば、低速であることが判明している特定の条件の下で実行できます。テストのタイムアウト値は、次の期間に対応します。

上記以外の場合、テスト タイムアウトは --test_timeout bazel フラグでオーバーライドできます。たとえば、低速であることがわかっている条件で手動で実行する場合などです。--test_timeout 値は秒単位です。たとえば、--test_timeout=120 の場合、テストのタイムアウトは 2 分に設定されます。

環境変数 TEST_TIMEOUT は、テストを生成するときにテスト タイムアウト（秒単位）に設定されます。

Boolean; optional; default False; nonconfigurable

テストを不安定とマークします。

設定すると、テストが最大 3 回実行され、失敗するたびにテストが失敗します。この属性はデフォルトで False に設定されており、テストは 1 回だけ実行されます。一般に、この属性の使用はおすすめしません。アサーションがサポートされている場合は、テストに必ず合格する必要があります。

Non-negative integer less than or equal to 50; optional

テストの実行に使用する並列シャードの数を指定します。

この値は、テストを実行する並列シャードの数を決定するために使用されるヒューリスティックをオーバーライドします。一部のテストルールでは、最初にシャーディングを有効にするためにこのパラメータが必要になることがあります。--test_sharding_strategy もご覧ください。

テストのシャーディングが有効になっている場合、テストを生成するときに、環境変数 TEST_TOTAL_SHARDS がこの値に設定されます。

シャーディングでは、テストランナーがテスト シャーディング プロトコルをサポートする必要があります。そうしない場合、ほとんどのシャードごとにすべてのテストが実行される可能性がありますが、これは望ましいことではありません。

シャーディングの詳細については、Test Encyclopedia のテストのシャーディングをご覧ください。

Boolean; default False; nonconfigurable

サンドボックス化せずに、テストをローカルで強制的に実行します。

True に設定すると、タグ「tags=["local"]」として「ローカル」が提供されます。

List of strings; optional; subject to $(location) and "Make variable" substitution, and Bourne shell tokenization; nonconfigurable

Bazel が run コマンドまたはテストとしてターゲットに渡される場合のコマンドライン引数。これらの引数は、bazel run または bazel test コマンドラインで指定された引数の前に渡されます。

注: Bazel の外部でターゲットを実行した場合（bazel-bin/ でバイナリを手動で実行した場合など）、引数は渡されません。

Dictionary of strings; optional; values are subject to $(location) and "Make variable" substitution

bazel run によってターゲットの実行時に設定される追加の環境変数を指定します。

この属性は、cc_binary、py_binary、sh_binary などのネイティブ ルールにのみ適用されます。Starlark で定義された実行可能ルールには適用されません。

注: Bazel の外部でターゲットを実行する場合（たとえば、bazel-bin/ でバイナリを手動で実行する場合）、環境変数は設定されません。

List of strings; optional

このバイナリによって生成された出力ファイルのライセンス。 これは、Bazel で使用されなくなった非推奨のライセンス API の一部です。この属性は使用しないでください。