Um identificador de destino do BUILD.
Para cada instância Label l, a representação de string str(l) tem a propriedade Label(str(l)) == l, independentemente de onde a chamada Label() ocorre.
Membros
Rótulo
Label Label(input)
Label, no contexto do pacote em que o arquivo de origem .bzl de chamada está armazenado. Se o valor fornecido já for um Label, ele será retornado inalterado.Para macros, uma função relacionada, native.package_relative_label(), converte a entrada em um Label no contexto do pacote que está sendo criado. Use essa função para imitar a conversão de string em rótulo, que é feita automaticamente por atributos de regras com valor de rótulo.
Parâmetros
| Parâmetro | Descrição |
|---|---|
input
|
string ou Label;
obrigatório A string do rótulo de entrada ou o objeto Label. Se um objeto Label for transmitido, ele será retornado como está. |
nome
string Label.name
Label("@@foo//pkg/foo:abc").name == "abc"pacote
string Label.package
Label("@@repo//pkg/foo:abc").package == "pkg/foo"relativo
Label Label.relative(relName)
--+incompatible_enable_deprecated_label_apis Deprecated. Esse método se comporta de maneira inesperada quando usado com um argumento que contém um nome de repositório aparente. Prefira
Label.same_package_label(), native.package_relative_label() ou Label().Resolve um rótulo absoluto (que começa com //) ou relativo ao pacote atual. Se o rótulo estiver em um repositório remoto, o argumento será resolvido em relação a esse repositório. Se o argumento contiver um nome de repositório, o rótulo atual será ignorado e o argumento será retornado como está, exceto se o nome do repositório for substituído se ele estiver no mapeamento atual. Os rótulos reservados também são retornados como estão.
Por exemplo:
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")
Se o mapeamento do repositório transmitido for {'@other' : '@remapped'}, o seguinte remapeamento vai ocorrer:
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
Parâmetros
| Parâmetro | Descrição |
|---|---|
relName
|
required O rótulo que será resolvido em relação a este. |
repo_name
string Label.repo_name
@). Por exemplo, Label("@@foo//bar:baz").repo_name == "foo"same_package_label
Label Label.same_package_label(target_name)
Parâmetros
| Parâmetro | Descrição |
|---|---|
target_name
|
obrigatório O nome de destino do novo marcador. |
workspace_name
string Label.workspace_name
--+incompatible_enable_deprecated_label_apis Deprecated. O nome do campo "nome do espaço de trabalho" é um nome incorreto. Use
Label.repo_name, que tem o mesmo comportamento.O nome canônico do repositório que contém o destino mencionado por este rótulo, sem nenhum caractere de arroba inicial (@). Por exemplo,
Label("@@foo//bar:baz").workspace_name == "foo"workspace_root
string Label.workspace_root
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"