先住民

ネイティブ ルールや他のパッケージ ヘルパー関数をサポートする組み込みモジュール。すべてのネイティブルールは、このモジュールの関数として表示されます（例: native.cc_library）。ネイティブ モジュールは読み込みフェーズでのみ使用できます（つまり、マクロで使用でき、ルールの実装では使用できません）。属性は None 値を無視し、属性が設定されていないものとして扱います。
次の関数も使用できます。

メンバー

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

existing_rule

unknown native.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 フラグが設定されている場合は、同じ内容の新しい変更可能な辞書を返します。

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

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

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

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

パラメータ

existing_rules

unknown native.existing_rules()

ここで、変更不可の辞書型オブジェクトとは、辞書型の反復処理（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 native.exports_files(srcs, visibility=None, licenses=None)

パラメータ

glob

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

• include の少なくとも 1 つのパターンと一致します。
• exclude（デフォルト []）のどのパターンにも一致しません。

パラメータ

module_name

string native.module_name()

module_version

string native.module_version()

package_group

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

パラメータ

package_name

string native.package_name()

package_relative_label

Label native.package_relative_label(input)

この関数は、BUILD ファイルと、そのファイルが直接または間接的に呼び出すマクロの評価中にのみ呼び出されます。たとえば、ルール実装関数では呼び出せません。

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

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

パラメータ

repo_name

string native.repo_name()

repository_name

string native.repository_name()

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

サブパッケージ

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

パラメータ