nativo/nativa/indígena/aborigen

Un módulo integrado para admitir reglas nativas y otras funciones de ayuda de paquetes. Todas las reglas nativas aparecen como funciones en este módulo, p.ej., native.cc_library. Ten en cuenta que el módulo nativo solo está disponible en la fase de carga (es decir, para macros, no para implementaciones de reglas). Los atributos ignorarán los valores None y los tratarán como si el atributo no se hubiera establecido.
También están disponibles las siguientes funciones:

Miembros

• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package_group
• package_name
• package_relative_label
• repo_name
• repository_name
• subpaquetes

existing_rule

unknown native.existing_rule(name)

Aquí, un objeto inmutable similar a un diccionario significa un objeto x profundamente inmutable que admite la iteración similar a un diccionario, len(x), name in x, x[name], x.get(name), x.items(), x.keys() y x.values().

El resultado contiene una entrada para cada atributo, a excepción de los privados (cuyos nombres no comienzan con una letra) y algunos tipos de atributos heredados que no se pueden representar. Además, el diccionario contiene entradas para name y kind de la instancia de la regla (por ejemplo, 'cc_binary').

Los valores del resultado representan los valores de atributo de la siguiente manera:

• Los atributos de tipo str, int y bool se representan tal como están.
• Las etiquetas se convierten en cadenas del formato ':foo' para los destinos en el mismo paquete o '//pkg:name' para los destinos en un paquete diferente.
• Las listas se representan como tuplas y los diccionarios se convierten en diccionarios nuevos y mutables. Sus elementos se convierten de forma recursiva de la misma manera.
• Los valores de select se muestran con su contenido transformado como se describió anteriormente.
• Los atributos para los que no se especificó ningún valor durante la creación de instancias de la regla y cuyo valor predeterminado se calcula se excluyen del resultado. (Los valores predeterminados calculados no se pueden calcular hasta la fase de análisis).

Si es posible, usa esta función solo en las funciones de implementación de macros simbólicas del finalizador de reglas. No se recomienda el uso de esta función en otros contextos y se inhabilitará en una versión futura de Bazel. Esto hace que los archivos BUILD sean frágiles y dependan del orden. Además, ten en cuenta que difiere sutilmente de las otras dos conversiones de valores de atributos de reglas del formato interno a Starlark: una que usan los valores predeterminados calculados y la otra que usa ctx.attr.foo.

Parámetros

existing_rules

unknown native.existing_rules()

Aquí, un objeto inmutable similar a un diccionario significa un objeto x profundamente inmutable que admite la iteración similar a un diccionario, len(x), name in x, x[name], x.get(name), x.items(), x.keys() y x.values().

Si es posible, usa esta función solo en las funciones de implementación de macros simbólicas del finalizador de reglas. No se recomienda el uso de esta función en otros contextos y se inhabilitará en una versión futura de Bazel. Esto hace que los archivos BUILD sean frágiles y dependan del orden.

exports_files

None native.exports_files(srcs, visibility=None, licenses=None)

Parámetros

glob

sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

• Coincide con al menos un patrón en include.
• No coincide con ninguno de los patrones de exclude ([] predeterminado).

Parámetros

module_name

string native.module_name()

module_version

string native.module_version()

package_group

None native.package_group(name, packages=[], includes=[])

Parámetros

package_name

string native.package_name()

package_relative_label

Label native.package_relative_label(input)

Solo se puede llamar a esta función mientras se evalúa un archivo BUILD y las macros a las que llama directa o indirectamente. No se puede llamar a esta función en (por ejemplo) una función de implementación de reglas.

El resultado de esta función es el mismo valor Label que se produciría si se pasara la cadena determinada a un atributo con valor de etiqueta de un destino declarado en el archivo BUILD.

Nota de uso: La diferencia entre esta función y Label() es que Label() usa el contexto del paquete del archivo .bzl que lo llamó, no el paquete del archivo BUILD. Usa Label() cuando necesites hacer referencia a un objetivo fijo que esté codificado en la macro, como un compilador. Usa package_relative_label() cuando necesites normalizar una cadena de etiqueta que proporciona el archivo BUILD a un objeto Label. (No hay forma de convertir una cadena en un Label en el contexto de un paquete que no sea el archivo BUILD o el archivo .bzl de llamada. Por esa razón, las macros externas siempre deben preferir pasar objetos Label a macros internas en lugar de cadenas de etiquetas.

Parámetros

repo_name

string native.repo_name()

repository_name

string native.repository_name()

Es el nombre canónico del repositorio que contiene el paquete que se está evaluando actualmente, con un solo signo @ (@) como prefijo. Por ejemplo, en los paquetes que crea la estrofa WORKSPACE local_repository(name='local', path=...), se establecerá en @local. En los paquetes del repositorio principal, se establecerá en @.

subpaquetes

sequence native.subpackages(include, exclude=[], allow_empty=False)

Parámetros