BUILD ターゲット識別子。
どの Label
インスタンス l
でも、Label()
呼び出しが発生する場所に関係なく、文字列表現 str(l)
には Label(str(l)) == l
というプロパティがあります。
位置引数として print()
または fail()
に渡すと、Label
は代わりに人間が読み取れるように最適化された文字列表現を使用します。この表現では、可能であれば、メイン リポジトリの観点から見かけたリポジトリ名を使用します。
メンバー
ラベル
Label Label(input)呼び出し元の
.bzl
ソースファイルが存在するパッケージのコンテキストで、ラベル文字列を Label
オブジェクトに変換します。指定された値がすでに Label
の場合は、変更されることなく返されます。マクロの場合、関連する関数 native.package_relative_label()
が、現在作成されているパッケージのコンテキストで入力を Label
に変換します。この関数を使用して、ラベル値のルール属性によって自動的に行われる文字列からラベルへの変換を模倣します。
パラメータ
パラメータ | 説明 |
---|---|
input
|
string;またはラベル
必須 入力ラベル文字列またはラベル オブジェクト。Label オブジェクトが渡された場合は、そのまま返されます。 |
name
string Label.nameこのラベルによって参照されるターゲットの名前。次に例を示します。
Label("@@foo//pkg/foo:abc").name == "abc"
パッケージ
string Label.packageこのラベルによって参照されるターゲットを含むパッケージの名前(リポジトリ名は除く)。次に例を示します。
Label("@@repo//pkg/foo:abc").package == "pkg/foo"
相対
Label Label.relative(relName)試験運用版。この API は試験運用版であり、いつでも変更される可能性があります。これに依存しないでください。
--+incompatible_enable_deprecated_label_apis
[非推奨] を設定すると、試験運用版に基づいて有効にできます。見かけ上のリポジトリ名を含む引数とともに使用すると、このメソッドが驚くべき振る舞いをします。代わりに
Label.same_package_label()
、native.package_relative_label()
、または Label()
を使用することをおすすめします。絶対ラベル(//
で始まる)または現在のパッケージを基準とする相対ラベルを解決します。このラベルがリモート リポジトリにある場合、引数はそのリポジトリの相対パスで解決されます。引数にリポジトリ名が含まれている場合、現在のラベルは無視され、引数はそのまま返されますが、リポジトリ名が現在のリポジトリ マッピングに含まれている場合は、書き換えられます。予約済みのラベルもそのまま返されます。
例:
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
|
string;
必須 このラベルを基準に解決されるラベル。 |
repo_name
string Label.repo_nameこのラベルによって参照されるターゲットを含むリポジトリの正規名。先頭にアットマーク(
@
)は付けません。例: Label("@@foo//bar:baz").repo_name == "foo"
same_package_label
Label Label.same_package_label(target_name)指定されたターゲット名でこのラベルと同じパッケージにラベルを作成します。
パラメータ
パラメータ | 説明 |
---|---|
target_name
|
string;
必須 新しいラベルのターゲット名。 |
workspace_name
string Label.workspace_name試験運用版。この API は試験運用版であり、いつでも変更される可能性があります。これに依存しないでください。
--+incompatible_enable_deprecated_label_apis
[非推奨] を設定すると、試験運用版に基づいて有効にできます。フィールド名「workspace name」は用語は間違っています。代わりに、まったく同じように動作する
Label.repo_name
を使用してください。このラベルによって参照されるターゲットを含むリポジトリの正規名。先頭にアットマーク(@
)は付けません。例:
Label("@@foo//bar:baz").workspace_name == "foo"
workspace_root
string Label.workspace_rootこのラベルが参照するターゲットを含むリポジトリの実行ルートを、execroot を基準として返します。次に例を示します。
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"