BUILD ファイル

BUILD ファイルで使用できるメソッド。BUILD ファイルでも使用できる追加のfunctionsとビルドルールについては、Build Encyclopedia もご覧ください。

メンバー

• depset
• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package
• package_group
• package_name
• package_relative_label
• repo_name
• repository_name
• 選択
• サブパッケージ

depset

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

depset のすべての要素（直接的および間接的）は、式 type(x) によって取得されるものと同じ型である必要があります。

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

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

作成された depset の順序は、transitive depset の順序と互換性がある必要があります。"default" 順序は他のすべての順序と互換性がありますが、他のすべての順序は互換性がありません。

パラメータ

existing_rule

unknown existing_rule(name)

ここで、変更不可の辞書型オブジェクトとは、辞書型の反復処理（len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys()、x.values()）をサポートする、変更不可のオブジェクト x を意味します。

結果には、非公開の属性（名前が文字で始まらない）と、表現できないレガシー属性タイプを除き、各属性のエントリが含まれます。さらに、この辞書には、ルール インスタンスの name と kind のエントリ（'cc_binary' など）が含まれています。

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

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

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

パラメータ

existing_rules

unknown existing_rules()

ここで、変更不可の辞書型オブジェクトとは、辞書型の反復処理（len(x)、name in x、x[name]、x.get(name)、x.items()、x.keys()、x.values()）をサポートする、変更不可のオブジェクト x を意味します。

注: 可能であれば、この関数を使用しないでください。これにより、BUILD ファイルが脆弱になり、順序に依存するようになります。

exports_files

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

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

string module_name()

string module_version()

unknown package(**kwargs)

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

string package_name()

Label package_relative_label(input)

string repo_name()

string repository_name()

unknown select(x, no_match_error='')

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