BUILD ファイル

<ph type="x-smartling-placeholder"></ph> 問題を報告 ナイトリー · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

BUILD ファイルで利用可能なメソッド追加の関数とビルドルールについては、Build Encyclopedia もご覧ください。これらは BUILD ファイルでも使用できます。

メンバー

到着

depset depset(direct=None, order="default", *, transitive=None)

depset を作成します。direct パラメータは depset の直接要素のリストで、transitive パラメータは、要素が作成された depset の間接要素になる depset のリストです。depset がリストに変換されるときに返される要素の順序は、order パラメータで指定します。詳細については、Depsets の概要をご覧ください。

依存関係のすべての要素(直接的および間接的)は、式 type(x) で取得される型と同じ型でなければなりません。

ハッシュベースのセットは反復処理中の重複を排除するために使用されるので、depset のすべての要素はハッシュ可能である必要があります。ただし、現在のところ、この不変条件は、すべてのコンストラクタで一貫してチェックされるわけではありません。一貫性のあるチェックを有効にするには、--compatibility_always_check_depset_elements フラグを使用します。今後のリリースではこれがデフォルトの動作になる予定です。問題 10313 をご覧ください。

また、要素は現在不変である必要がありますが、この制限は今後緩和される予定です。

作成されるデプセットの順序は、transitive デプセットの順序と互換性がある必要があります。"default" の注文は他の注文と互換性があります。他のすべての注文は自分とのみ互換性があります。

パラメータ

パラメータ 説明
direct sequence;または None デフォルトは None
です depset の direct 要素のリスト。
order デフォルトは "default"
新しい依存関係の走査戦略。設定可能な値については、こちらをご覧ください。
transitive depsetシーケンス。または None デフォルトは None
要素が depset の間接要素になる depset のリスト。

existing_rule

unknown existing_rule(name)

このスレッドのパッケージでインスタンス化されたルールの属性を記述する、ディクショナリに似た不変のオブジェクトを返します。その名前のルール インスタンスが存在しない場合は None を返します。

ここで、不変の dict に似たオブジェクトとは、辞書に似た反復処理(len(x)name in xx[name]x.get(name)x.items()x.keys()x.values() をサポートする、高度に不変のオブジェクト x)を意味します。

--noincompatible_existing_rules_immutable_view フラグが設定されている場合、代わりに同じ内容の新しい可変の辞書を返します。

結果には各属性のエントリが含まれます。ただし、非公開の属性(名前が文字で始まらないもの)と、表現できない以前の属性タイプの一部は除きます。また、この辞書にはルール インスタンスの namekind のエントリが含まれます(例: 'cc_binary')。

結果の値は、次のように属性値を表します。

  • str、int、bool 型の属性はそのまま表されます。
  • ラベルは、同じパッケージ内のターゲットの場合は ':foo' の形式、別のパッケージ内のターゲットの場合は '//pkg:name' という形式の文字列に変換されます。
  • リストはタプルとして表され、辞書は新しい可変の辞書に変換されます。これらの要素は、同じ方法で再帰的に変換されます。
  • select 値は、その内容が前述のように変換された状態で返されます。
  • ルールのインスタンス化時に値が指定されず、デフォルト値が計算される属性は結果から除外されます。(計算されたデフォルトは、分析フェーズまで計算できません)。

可能であれば、この関数の使用は避けてください。BUILD ファイルは脆弱で、順序に依存します。また、内部形式から Starlark へのルール属性値の他の 2 つの変換とは微妙に異なることに注意してください。1 つは計算済みデフォルトで使用され、もう 1 つは ctx.attr.foo で使用されます。

パラメータ

パラメータ 説明
name 必須
ターゲットの名前。

existing_rules

unknown existing_rules()

このスレッドのパッケージでこれまでにインスタンス化されているルールを記述する、ディクショナリに似た不変のオブジェクトを返します。辞書に似たオブジェクトの各エントリは、ルール インスタンスの名前を existing_rule(name) によって返される結果にマッピングします。

ここで、不変の dict に似たオブジェクトとは、辞書に似た反復処理(len(x)name in xx[name]x.get(name)x.items()x.keys()x.values() をサポートする、高度に不変のオブジェクト x)を意味します。

--noincompatible_existing_rules_immutable_view フラグが設定されている場合、代わりに同じ内容の新しい可変の辞書を返します。

注: 可能であれば、この関数の使用は避けてください。BUILD ファイルは脆弱で、順序に依存します。さらに、 --noincompatible_existing_rules_immutable_view フラグが設定されている場合、特にループ内で呼び出した場合、この関数は非常に高コストになります。

exports_files

None exports_files(srcs, visibility=None, licenses=None)

このパッケージに属するファイルのうち、他のパッケージにエクスポートされるファイルのリストを指定します。

パラメータ

パラメータ 説明
srcs 文字列シーケンス。 必須
エクスポートするファイルのリスト。
visibility sequence;または None デフォルトは None
です 公開設定を指定できます。ファイルは、指定したターゲットに表示されます。公開設定が指定されていない場合、ファイルはすべてのパッケージに表示されます。
licenses 文字列シーケンス。または None デフォルトは None
指定するライセンス。

glob

sequence glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

Glob は、現在のパッケージ内のすべてのファイルについて、以下の変更可能な並べ替え済みリストを返します。
  • include の 1 つ以上のパターンと一致します。
  • exclude のどのパターンとも一致しない(デフォルトは [])。
で確認できます。 exclude_directories 引数が有効(1 に設定)の場合、ディレクトリ型のファイルは結果から除外されます(デフォルトは 1)。

パラメータ

パラメータ 説明
include 文字列シーケンス。 デフォルトは []
含める glob パターンのリスト。
exclude 文字列シーケンス。 デフォルトは []
除外する glob パターンのリスト。
exclude_directories デフォルトは 1
ディレクトリを除外するかどうかのフラグ。
allow_empty デフォルトは unbound
glob パターンが何も一致しないことを許可するかどうか。`allow_empty` が False の場合は、個々のインクルード パターンがなんらかの値に一致する必要があり、最終的な結果は(`exclude` パターンの一致が除外された後)空でない必要があります。

module_name

string module_name()

このパッケージが存在するリポジトリに関連付けられている Bazel モジュールの名前。このパッケージが、MODULE.bazel ではなく WORKSPACE で定義されたリポジトリからのものである場合、これは空です。モジュール拡張機能によって生成されたリポジトリの場合、拡張機能をホストするモジュールの名前です。これは、module_ctx.modulesmodule.name フィールドと同じです。 None を返すことができます。

module_version

string module_version()

このパッケージがあるリポジトリに関連付けられている Bazel モジュールのバージョン。このパッケージが、MODULE.bazel ではなく WORKSPACE で定義されたリポジトリからのものである場合、これは空です。モジュール拡張機能によって生成されたリポジトリの場合、これは拡張機能をホストするモジュールのバージョンです。これは、module_ctx.modulesmodule.version フィールドと同じです。 None を返すことができます。

package_group

None package_group(name, packages=[], includes=[])

この関数は一連のパッケージを定義し、グループにラベルを割り当てます。ラベルは visibility 属性で参照できます。

パラメータ

パラメータ 説明
name 必須
このルールの一意の名前。
packages 文字列シーケンス。 デフォルトは []
このグループ内のパッケージの完全な列挙。
includes 文字列シーケンス。 デフォルトは []
これに含まれる他のパッケージ グループ。

package_name

string package_name()

評価対象のパッケージの名前(リポジトリ名なし)。たとえば、ビルド ファイル some/package/BUILD では、値は some/package になります。BUILD ファイルが .bzl ファイルで定義された関数を呼び出す場合、package_name() は呼び出し元の BUILD ファイル パッケージと一致します。

package_relative_label

Label package_relative_label(input)

現在初期化されているパッケージ(つまり、現在のマクロが実行されている BUILD ファイル)のコンテキストで、入力文字列を Label オブジェクトに変換します。入力がすでに Label の場合、変更されることなく返されます。

この関数は、BUILD ファイルとそれが直接または間接的に呼び出すマクロを評価しているときにのみ呼び出すことができます。ルール実装関数などで呼び出すことはできません。

この関数の結果は、BUILD ファイルで宣言されたターゲットのラベル値属性に指定された文字列を渡した場合と同じ Label 値になります。

使用上の注意: この関数と Label() の違いは、Label()BUILD ファイルのパッケージではなく、呼び出し元の .bzl ファイルのパッケージのコンテキストを使用する点です。コンパイラなど、マクロにハードコードされた固定ターゲットを参照する必要がある場合は、Label() を使用します。BUILD ファイルが提供するラベル文字列を Label オブジェクトに正規化する必要がある場合は、package_relative_label() を使用します。(パッケージのコンテキストでは、BUILD ファイルまたは呼び出し元の .bzl ファイル以外に文字列を Label に変換する方法はありません。そのため、外側のマクロは、ラベルの文字列ではなく内側のマクロに常に Label オブジェクトを渡す必要があります)。

パラメータ

パラメータ 説明
input string;またはラベル 必須
入力ラベル文字列またはラベル オブジェクト。Label オブジェクトが渡された場合は、そのまま返されます。

repo_name

string repo_name()

現在評価されているパッケージを含むリポジトリの正規名。先頭にアットマークは付けません。

repository_name

string repository_name()

試験運用版。この API は試験運用版であり、いつでも変更される可能性があります。これに依存しないでください。--+incompatible_enable_deprecated_label_apis
[非推奨] を設定すると、試験運用版に基づいて有効にできます。代わりに repo_name を使用することをおすすめします。これは、不要な先頭のアットマークは含まれませんが、それ以外はまったく同じように動作します。

現在評価されているパッケージを含むリポジトリの正規名。先頭に 1 つのアットマーク(@)を付けます。たとえば、WORKSPACE スタンザ local_repository(name='local', path=...) によって呼び出されたパッケージでは、@local に設定されます。メイン リポジトリのパッケージでは、@ に設定されます。

選択

unknown select(x, no_match_error='')

select() は、ルール属性を構成可能にするヘルパー関数です。詳しくは、ビルドの百科事典をご覧ください。

パラメータ

パラメータ 説明
x 必須
構成条件を値にマッピングする辞書。各キーは、config_setting または constraint_value インスタンスを識別するラベルまたはラベル文字列です。文字列の代わりにラベルを使用するタイミングについては、マクロに関するドキュメントをご覧ください。
no_match_error デフォルトは ''
条件が一致しない場合に報告するカスタムエラー(省略可)。

サブパッケージ

sequence subpackages(include, exclude=[], allow_empty=False)

ファイル システムのディレクトリの深さに関係なく、現在のパッケージのすべての直接サブパッケージの新しい変更可能なリストを返します。返されたリストが並べ替えられ、現在のパッケージに関連するサブパッケージの名前が含まれます。この関数を直接呼び出すのではなく、bazel_skylib.subpackages モジュールのメソッドを使用することをおすすめします。

パラメータ

パラメータ 説明
include 文字列シーケンス。 必須
サブパッケージ スキャンに含める glob パターンのリスト。
exclude 文字列シーケンス。 デフォルトは []
サブパッケージ スキャンから除外する glob パターンのリスト。
allow_empty デフォルトは False
呼び出しが空のリストを返した場合に失敗するかどうか。デフォルトでは、空のリストは BUILD ファイルで潜在的に、subpackages() の呼び出しが過剰であることを示しています。true に設定すると、この関数が成功する可能性があります。