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.
Quando transmitido como argumentos posicionais para print() ou fail(), Label usa uma representação de string otimizada para leitura humana. Essa representação usa um nome de repositório aparente do repositório principal, se possível.
Membros
Rótulo
Label Label(input)
Label, no contexto do pacote em que o arquivo de origem .bzl de chamada reside. 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 esse 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 no estado em que se encontra, exceto que o nome do repositório será reescrito se estiver no mapeamento do repositório 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"