メンバー
- depset
- existing_rule
- existing_rules
- exports_files
- glob
- module_name
- module_version
- package_group
- package_name
- package_relative_label
- repository_name
- select
- サブパッケージ
到着
depset depset(direct=None, order="default", *, transitive=None)depset を作成します。
direct パラメータは depset の直接要素のリストで、transitive パラメータは、要素が作成された depset の間接要素になる depset のリストです。depset がリストに変換されるときに返される要素の順序は、order パラメータで指定します。詳細については、Depsets の概要をご覧ください。依存関係のすべての要素（直接的および間接的）は、式 type(x) で取得される型と同じ型でなければなりません。
ハッシュベースのセットは反復処理中の重複を排除するために使用されるので、depset のすべての要素はハッシュ可能である必要があります。ただし、現在のところ、この不変条件は、すべてのコンストラクタで一貫してチェックされるわけではありません。整合性チェックを有効にするには、--compatible_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 x、x[name]、x.get(name)、x.items()、x.keys()、x.values() をサポートする、高度に不変のオブジェクト x）を意味します。
--noincompatible_existing_rules_immutable_view フラグが設定されている場合、代わりに同じ内容の新しい可変の辞書を返します。
結果には各属性のエントリが含まれます。ただし、非公開の属性（名前が文字で始まらないもの）と、表現できない以前の属性タイプの一部は除きます。また、この辞書にはルール インスタンスの name と kind のエントリが含まれます（例: 'cc_binary'）。
結果の値は、次のように属性値を表します。
- str、int、bool 型の属性はそのまま表されます。
- ラベルは、同じパッケージ内のターゲットの場合は
':foo'の形式、別のパッケージ内のターゲットの場合は'//pkg:name'の形式の文字列に変換されます。 - リストはタプルとして表され、辞書は新しい可変の辞書に変換されます。これらの要素は、同じ方法で再帰的に変換されます。
select値は、その内容が前述のように変換された状態で返されます。- ルールのインスタンス化時に値が指定されず、デフォルト値が計算される属性は結果から除外されます。（計算されたデフォルトは、分析フェーズまで計算できません）。
可能であれば、この関数の使用は避けてください。BUILD ファイルは脆弱で、順序に依存します。また、内部形式から Starlark へのルール属性値の他の 2 つの変換とは微妙に異なることに注意してください。1 つは計算済みデフォルトで使用され、もう 1 つは ctx.attr.foo で使用されます。
パラメータ
| パラメータ | 説明 |
|---|---|
name
|
required ターゲットの名前。 |
existing_rules
unknown existing_rules()このスレッドのパッケージでこれまでにインスタンス化されているルールを記述する、ディクショナリに似た不変のオブジェクトを返します。辞書に似たオブジェクトの各エントリは、ルール インスタンスの名前を
existing_rule(name) によって返される結果にマッピングします。ここで、不変の dict に似たオブジェクトとは、辞書に似た反復処理（len(x)、name in x、x[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.modules の module.name フィールドと同じです。None が返されることがあります。
module_version
string module_version()このパッケージがあるリポジトリに関連付けられている Bazel モジュールのバージョン。このパッケージが、MODULE.bazel ではなく WORKSPACE で定義されたリポジトリからのものである場合、これは空です。モジュール拡張機能によって生成されたリポジトリの場合、これは拡張機能をホストするモジュールのバージョンです。これは、
module_ctx.modules の module.version フィールドと同じです。None が返されることがあります。
package_group
None package_group(name, packages=[], includes=[])visibility 属性で参照できます。
パラメータ
| パラメータ | 説明 |
|---|---|
name
|
required このルールの一意の名前。 |
packages
|
文字列のシーケンス。デフォルトは []このグループのパッケージの完全な列挙。 |
includes
|
string のシーケンス。デフォルトは []これに含まれる他のパッケージ グループ。 |
package_name
string package_name()評価対象のパッケージの名前。たとえば、ビルド ファイル
some/package/BUILD では、値は some/package になります。BUILD ファイルが .bzl ファイルで定義された関数を呼び出す場合、package_name() は呼び出し元の BUILD ファイル パッケージと一致します。この関数は、非推奨の変数 PACKAGE_NAME と同等です。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 に変換する方法はありません。そのため、外側のマクロでは、ラベルの文字列ではなく内側のマクロに常にラベル オブジェクトを渡す必要があります）。
パラメータ
| パラメータ | 説明 |
|---|---|
input
|
string; または Label;
必須 入力ラベルの文字列またはラベル オブジェクト。ラベル オブジェクトが渡された場合は、そのまま返されます。 |
repository_name
string repository_name()ルールまたはビルド拡張機能の呼び出し元リポジトリの名前。たとえば、WORKSPACE スタンザ
local_repository(name='local', path=...) によって呼び出されたパッケージでは、@local に設定されます。メイン リポジトリのパッケージでは、@ に設定されます。この関数は、非推奨の変数 REPOSITORY_NAME と同等です。select
unknown select(x, no_match_error='')
select() は、ルール属性を構成可能にするヘルパー関数です。詳しくは、ビルド百科事典をご覧ください。
パラメータ
| パラメータ | 説明 |
|---|---|
x
|
required 構成条件を値にマッピングする辞書。各キーは、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 に設定すると、この関数が成功する可能性があります。 |