Etiqueta

Un identificador de destino de BUILD.

Para cada instancia Label l, la representación de cadena str(l) tiene la propiedad Label(str(l)) == l, sin importar dónde se produzca la llamada Label().

Miembros

• Etiqueta
• name
• paquete
• relative
• workspace_name
• workspace_root

Etiqueta

Label Label(input)

Convierte una cadena de etiqueta en un objeto Label, en el contexto del paquete en el que reside el archivo fuente .bzl que realiza la llamada. Si el valor determinado ya es un Label, se muestra sin cambios.

Para las macros, una función relacionada, native.package_relative_label(), convierte la entrada en un Label en el contexto del paquete que se está compilando. 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 etiqueta; obligatorio La cadena de etiqueta de entrada o el objeto de etiqueta. Si se pasa un objeto de etiqueta, se muestra tal como está.

name

string Label.name

El nombre de esta etiqueta dentro del paquete. Por ejemplo:

Label("//pkg/foo:abc").name == "abc"

paquete

string Label.package

La parte del paquete de esta etiqueta. Por ejemplo:

Label("//pkg/foo:abc").package == "pkg/foo"

relative

Label Label.relative(relName)

Resuelve una etiqueta que es absoluta (comienza con //) o relativa al paquete actual. Si esta etiqueta está 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 muestra el argumento tal como está, excepto que se vuelve a escribir el nombre del repositorio si está 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	obligatorio La etiqueta que se resolverá en relación con esta.

workspace_name

string Label.workspace_name

La parte del repositorio de esta etiqueta. Por ejemplo,

Label("@foo//bar:baz").workspace_name == "foo"

workspace_root

string Label.workspace_root

Muestra la raíz de ejecución del espacio de trabajo de esta etiqueta, en relación con la raíz de ejecución. Por ejemplo:

Label("@repo//pkg/foo:abc").workspace_root == "external/repo"