Es un identificador de destino de compilación.
Para cada l
de instancia de Label
, la representación de cadena str(l)
tiene la propiedad que Label(str(l)) == l
, sin importar dónde ocurre la llamada a Label()
.
Miembros
Etiqueta
Label Label(input)Convierte una cadena de etiqueta en un objeto
Label
, en el contexto del paquete en el que se encuentra el archivo fuente .bzl
de llamada. Si el valor determinado ya es un Label
, se muestra sin cambios.En el caso de las macros, una función relacionada, native.package_relative_label()
, convierte la entrada en 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 reglas con valores de etiqueta.
Parámetros
Parámetro | Descripción |
---|---|
input
|
cadena o Etiqueta;
obligatorio Es la cadena de la etiqueta de entrada o el objeto Label. Si se pasa un objeto Label, se muestra tal como está. |
nombre
string Label.nameEs el nombre de esta etiqueta dentro del paquete. Por ejemplo:
Label("//pkg/foo:abc").name == "abc"
paquete
string Label.packageEs la parte del paquete de esta etiqueta. Por ejemplo:
Label("//pkg/foo:abc").package == "pkg/foo"
relativo
Label Label.relative(relName)Resuelve una etiqueta que es absoluta (comienza con
//
) o relativa al paquete actual. Si la 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 el argumento se muestra tal como está, excepto que el nombre del repositorio se vuelve a escribir si está en la asignación de 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 producirá 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 Es la etiqueta que se resolverá en relación con esta. |
workspace_name
string Label.workspace_nameEs la parte del repositorio de esta etiqueta. Por ejemplo,
Label("@foo//bar:baz").workspace_name == "foo"
workspace_root
string Label.workspace_rootMuestra la raíz de ejecución para el espacio de trabajo de esta etiqueta, en relación con el execroot. Por ejemplo:
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"