BUILD ターゲット識別子。
Label
インスタンス l
ごとに、Label()
呼び出しが発生する場所に関係なく、文字列表現 str(l)
には Label(str(l)) == l
というプロパティがあります。
メンバー
ラベル
Label Label(input)
.bzl
ソースファイルが存在するパッケージのコンテキストで、ラベル文字列を Label
オブジェクトに変換します。指定された値がすでに Label
の場合は、変更されずに返されます。マクロの場合、関連する関数 native.package_relative_label()
は、現在作成中のパッケージのコンテキストで入力を Label
に変換します。この関数を使用すると、ラベル値のルール属性によって自動的に実行される文字列からラベルへの変換を模倣できます。
パラメータ
パラメータ | 説明 |
---|---|
input
|
string; または Label;
必須 入力ラベルの文字列またはラベル オブジェクト。Label オブジェクトが渡された場合は、そのまま返されます。 |
name
string Label.name
Label("//pkg/foo:abc").name == "abc"
パッケージ
string Label.package
Label("//pkg/foo:abc").package == "pkg/foo"
相対
Label Label.relative(relName)
//
で始まる)または現在のパッケージを基準とする相対パスのラベルを解決します。このラベルがリモート リポジトリにある場合、引数はそのリポジトリを基準に解決されます。引数にリポジトリ名が含まれている場合、現在のラベルは無視され、引数はそのまま返されます。ただし、現在のリポジトリ マッピングにリポジトリ名が含まれている場合は、リポジトリ名が書き換えられます。予約済みラベルもそのまま返されます。例:
Label("//foo/bar:baz").relative(":quux") == Label("//foo/bar:quux") Label("//foo/bar:baz").relative("//wiz:quux") == Label("//wiz:quux") Label("@repo//foo/bar:baz").relative("//wiz:quux") == Label("@repo//wiz:quux") Label("@repo//foo/bar:baz").relative("//visibility:public") == Label("//visibility:public") Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@other//wiz:quux")
渡されたリポジトリ マッピングが {'@other' : '@remapped'}
の場合、次の再マッピングが行われます。
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
パラメータ
パラメータ | 説明 |
---|---|
relName
|
required これに対して解決されるラベル。 |
workspace_name
string Label.workspace_name
Label("@foo//bar:baz").workspace_name == "foo"
workspace_root
string Label.workspace_root
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"