Es un identificador de destino de BUILD.
Para cada instancia Label l, la representación de cadena str(l) tiene la propiedad de que Label(str(l)) == l, independientemente de dónde se produzca la llamada Label().
Cuando se pasan como argumentos posicionales a print() o fail(), Label usa una representación de cadena optimizada para la legibilidad humana. Si es posible, esta representación usa un nombre de repositorio aparente desde la perspectiva del repositorio principal.
Miembros
Etiqueta
Label Label(input)
Label, en el contexto del paquete en el que se encuentra el archivo fuente .bzl que realiza la llamada. Si el valor proporcionado ya es un Label, se devuelve sin cambios.En el caso de las macros, una función relacionada, native.package_relative_label(), convierte la entrada en un Label en el contexto del paquete que se está construyendo. Usa esa función para imitar la conversión de cadena a etiqueta que realizan automáticamente los atributos de regla con valores de etiqueta.
Parámetros
| Parámetro | Descripción |
|---|---|
input
|
cadena o Label;
obligatorio Es la cadena de la etiqueta de entrada o el objeto Label. Si se pasa un objeto Label, se devuelve tal cual. |
nombre
string Label.name
Label("@@foo//pkg/foo:abc").name == "abc"paquete
string Label.package
Label("@@repo//pkg/foo:abc").package == "pkg/foo"pariente
Label Label.relative(relName)
--+incompatible_enable_deprecated_label_apis Obsoleto. Este método se comporta de manera sorprendente cuando se usa con un argumento que contiene un nombre de repo aparente. En su lugar, usa
Label.same_package_label(), native.package_relative_label() o Label().Resuelve una etiqueta que es absoluta (comienza con //) o relativa al paquete actual. Si esta etiqueta se encuentra en un repositorio remoto, el argumento se resolverá en relación con ese repositorio. Si el argumento contiene un nombre de repositorio, se ignora la etiqueta actual y se devuelve el argumento tal como está, excepto que se vuelve a escribir el nombre del repositorio si se encuentra en la asignación del repositorio actual. Las etiquetas reservadas también se mostrarán tal como están.
Por ejemplo:
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")
Si la asignación del repositorio que se pasó es {'@other' : '@remapped'}, se realizará la siguiente reasignación:
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
Parámetros
| Parámetro | Descripción |
|---|---|
relName
|
string;
obligatorio Es la etiqueta que se resolverá en relación con esta. |
repo_name
string Label.repo_name
@) al principio. Por ejemplo: Label("@@foo//bar:baz").repo_name == "foo"same_package_label
Label Label.same_package_label(target_name)
Parámetros
| Parámetro | Descripción |
|---|---|
target_name
|
string;
required Es el nombre del destino de la etiqueta nueva. |
workspace_name
string Label.workspace_name
--+incompatible_enable_deprecated_label_apis Obsoleto. El nombre del campo "nombre del espacio de trabajo" es inapropiado aquí. En su lugar, usa
Label.repo_name, que se comporta de la misma manera.Nombre canónico del repositorio que contiene el destino al que se refiere esta etiqueta, sin ningún signo arroba (@) al principio. Por ejemplo:
Label("@@foo//bar:baz").workspace_name == "foo"workspace_root
string Label.workspace_root
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"