módulo_ctx

Es el contexto de la extensión del módulo que contiene funciones auxiliares y la información sobre las etiquetas pertinentes en el grafo de dependencias. Cuando creas una extensión de módulo, obtienes un objeto module_ctx como argumento para la función implementation.

Miembros

descargar

struct module_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, *, integrity='')

Descarga un archivo en la ruta de acceso de salida de la URL proporcionada y muestra una estructura que contiene success, una marca que es true si la descarga se completó correctamente y, si es así, un hash del archivo con los campos sha256 y integrity.

Parámetros

Parámetro Descripción
url string; or Iterable of strings; obligatorio
Es una lista de URLs de espejo que hacen referencia al mismo archivo.
output string; or Label; or path; default = ''
ruta de acceso al archivo de salida, en relación con el directorio del repositorio.
sha256 default = ''
el hash SHA-256 esperado del archivo descargado Debe coincidir con el hash SHA-256 del archivo descargado. Omitir el SHA-256 representa un riesgo de seguridad, ya que pueden cambiar los archivos remotos. En el mejor de los casos, omitir este campo hará que tu compilación no sea hermética. Es opcional para facilitar el desarrollo, pero debe configurarse antes del envío.
executable default = False
Establece la marca ejecutable en el archivo creado, que es falsa de forma predeterminada.
allow_fail default = False
Si se establece, indica el error en el valor que se muestra en lugar de generar un error para las descargas fallidas.
canonical_id default = ''
Si se establece, restringe los hits de caché a los casos en los que el archivo se agregó a la caché con el mismo ID canónico.
auth default = {}
Es un diccionario opcional que especifica la información de autenticación para algunas de las URLs.
integrity default = ''
Es la suma de comprobación esperada del archivo descargado, en formato de integridad de subrecursos. Debe coincidir con la suma de comprobación del archivo descargado. Omitir la suma de comprobación es un riesgo de seguridad, ya que los archivos remotos pueden cambiar. En el mejor de los casos, omitir este campo hará que tu compilación no sea hermética. Es opcional facilitar el desarrollo, pero se debe configurar antes del envío.

download_and_extract

struct module_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, *, integrity='', rename_files={})

Descarga un archivo en la ruta de acceso de salida de la URL proporcionada, lo extrae y muestra una estructura que contiene success, una marca que es true si la descarga se completó correctamente y, si es así, un hash del archivo con los campos sha256 y integrity.

Parámetros

Parámetro Descripción
url string; or Iterable of strings; obligatorio
Lista de URLs duplicadas que hacen referencia al mismo archivo.
output string; or Label; or path; default = ''
Es la ruta de acceso al directorio en el que se descomprimirá el archivo, en relación con el directorio del repositorio.
sha256 default = ''
el hash SHA-256 esperado del archivo descargado. Debe coincidir con el hash SHA-256 del archivo descargado. Omitir el SHA-256 es un riesgo de seguridad, ya que los archivos remotos pueden cambiar. En el mejor de los casos, omitir este campo hará que tu compilación no sea hermética. Es opcional para facilitar el desarrollo, pero debe configurarse antes del envío. Si se proporciona, primero se verificará la caché del repositorio en busca de un archivo con el hash determinado. Solo se intentará realizar una descarga si el archivo no se encuentra en la caché. Después de una descarga correcta, el archivo se agregará a la caché.
type default = ''
Es el tipo de archivo del archivo descargado. De forma predeterminada, el tipo de archivo se determina a partir de la extensión de archivo de la URL. Si el archivo no tiene extensión, puedes especificar de forma explícita "zip", "jar", "war", "aar", "tar", "tar.gz", "tgz", "tar.xz", "txz", ".tar.zst", ".tzst", "tar.bz2", ".ar" o ".deb" aquí.
stripPrefix default = ''
Es un prefijo de directorio para quitar de los archivos extraídos. Muchos archivos contienen un directorio de nivel superior que contiene todos los archivos del archivo. En lugar de tener que especificar este prefijo una y otra vez en build_file, este campo se puede usar para quitarlo de los archivos extraídos.
allow_fail default = False
Si se establece, indica el error en el valor que se muestra en lugar de generar un error para las descargas fallidas.
canonical_id default = ''
Si se establece, restringe los hits de caché a los casos en los que el archivo se agregó a la caché con el mismo ID canónico.
auth default = {}
Es un diccionario opcional que especifica la información de autenticación para algunas de las URLs.
integrity default = ''
Es la suma de comprobación esperada del archivo descargado, en formato de integridad de subrecursos. Debe coincidir con la suma de comprobación del archivo descargado. Omitir la suma de comprobación es un riesgo de seguridad, ya que los archivos remotos pueden cambiar. En el mejor de los casos, omitir este campo hará que tu compilación no sea hermética. Es opcional facilitar el desarrollo, pero se debe configurar antes del envío.
rename_files default = {}
Un diccionario opcional que especifica los archivos a los que se les cambiará el nombre durante la extracción. Los nombres de las entradas de archivo que coincidan exactamente con una clave se cambiarán al valor antes de cualquier ajuste de prefijo de directorio. Se puede usar para extraer archivos que contengan nombres que no sean Unicode o que tengan archivos que se extraerían en la misma ruta de acceso en sistemas de archivos que no distinguen mayúsculas de minúsculas.

ejecutar

exec_result module_ctx.execute(arguments, timeout=600, environment={}, quiet=True, working_directory="")

Ejecuta el comando que se proporciona en la lista de argumentos. El tiempo de ejecución del comando está limitado por timeout (en segundos, el valor predeterminado es de 600 segundos). Este método muestra una estructura exec_result que contiene el resultado del comando. El mapa environment se puede usar para anular algunas variables de entorno que se pasarán al proceso.

Parámetros

Parámetro Descripción
arguments obligatorio
Es una lista de argumentos, el primer elemento debe ser la ruta de acceso al programa que se ejecutará.
timeout default = 600
Es la duración máxima del comando en segundos (el valor predeterminado es de 600 segundos).
environment default = {}
fuerza que se configuren algunas variables de entorno para que se pasen al proceso.
quiet default = True
Si stdout y stderr se deben imprimir en la terminal.
working_directory default = ""
Es el directorio de trabajo para la ejecución de comandos. Puede ser absoluta o relativa a la raíz del repositorio.

extension_metadata

extension_metadata module_ctx.extension_metadata(root_module_direct_deps=None, root_module_direct_dev_deps=None)

Construye un objeto opaco que se puede mostrar desde la función de implementación de la extensión del módulo para proporcionar metadatos sobre los repositorios que genera la extensión a Bazel.

Parámetros

Parámetro Descripción
root_module_direct_deps sequence of strings; or string; or None; default = None
Son los nombres de los repositorios que la extensión considera dependencias directas del módulo raíz. Si el módulo raíz importa repositorios adicionales o no importa todos estos repositorios a través de use_repo, Bazel imprimirá una advertencia y un comando de corrección cuando se evalúe la extensión.

Si se especifica uno de root_module_direct_deps y root_module_direct_dev_deps, también se debe especificar el otro. Las listas especificadas por estos dos parámetros deben ser disjuntas.

Se puede establecer exactamente uno de root_module_direct_deps y root_module_direct_dev_deps en el valor especial "all", que se trata como si se hubiera especificado una lista con los nombres de todos los repositorios generados por la extensión como valor.

root_module_direct_dev_deps sequence of strings; or string; or None; default = None
Son los nombres de los repositorios que la extensión considera como dependencias directas del desarrollo del módulo raíz. Si el módulo raíz importa repositorios adicionales o no importa todos estos repositorios a través de use_repo en un proxy de extensión creado con use_extension(..., dev_dependency = True), Bazel imprimirá una advertencia y un comando de corrección cuando se evalúe la extensión.

Si se especifica uno de root_module_direct_deps y root_module_direct_dev_deps, también se debe especificar el otro. Las listas especificadas por estos dos parámetros deben ser disjuntas.

Se puede establecer exactamente uno de root_module_direct_deps y root_module_direct_dev_deps en el valor especial "all", que se trata como si se hubiera especificado una lista con los nombres de todos los repositorios generados por la extensión como valor.

archivo

None module_ctx.file(path, content='', executable=True, legacy_utf8=True)

Genera un archivo en el directorio del repositorio con el contenido proporcionado.

Parámetros

Parámetro Descripción
path string; or Label; or path; obligatorio
Es la ruta de acceso del archivo que se creará, en relación con el directorio del repositorio.
content default = ''
el contenido del archivo que se creará, vacío de forma predeterminada.
executable default = True
Establece la marca ejecutable en el archivo creado, que es verdadera de forma predeterminada.
legacy_utf8 default = True
codifica el contenido del archivo en UTF-8, verdadero de forma predeterminada. Las versiones futuras cambiarán el valor predeterminado y quitarán este parámetro.

is_dev_dependency

bool module_ctx.is_dev_dependency(tag)

Muestra si se especificó la etiqueta determinada en el resultado de una llamada use_extension con devDependency = True.

Parámetros

Parámetro Descripción
tag bazel_module_tag; obligatorio
Es una etiqueta obtenida de bazel_module.tags.

is_isolated

bool module_ctx.is_isolated

Indica si este uso particular de la extensión tenía especificado isolate = True y, por lo tanto, está aislado de todos los demás usos.

modules

list module_ctx.modules

Una lista de todos los módulos de Bazel en el gráfico de dependencias externas que usan esta extensión de módulo, cada uno de los cuales es un objeto bazel_module que expone todas las etiquetas que especificó para esta extensión. Se garantiza que el orden de iteración de este diccionario sea el mismo que el de la búsqueda en amplitud a partir del módulo raíz.

os

repository_os module_ctx.os

Es una estructura para acceder a la información del sistema.

ruta de acceso

path module_ctx.path(path)

Muestra una ruta de acceso a partir de una cadena, etiqueta o ruta. Si la ruta de acceso es relativa, se resolverá en función del directorio del repositorio. Si la ruta es una etiqueta, se resolverá en la ruta del archivo correspondiente. Ten en cuenta que los repositorios remotos se ejecutan durante la fase de análisis y, por lo tanto, no pueden depender de un resultado objetivo (la etiqueta debe apuntar a un archivo no generado). Si path es una ruta de acceso, se mostrará tal como está.

Parámetros

Parámetro Descripción
path string; or Label; or path; obligatorio
Es la cadena, la etiqueta o la ruta de acceso a partir de la cual se creará una ruta.

read

string module_ctx.read(path)

Lee el contenido de un archivo en el sistema de archivos.

Parámetros

Parámetro Descripción
path string; or Label; or path: Es la ruta
obligatoria del archivo desde el que se leerá.

report_progress

None module_ctx.report_progress(status='')

Actualiza el estado de progreso para la recuperación de este repositorio o extensión de módulo.

Parámetros

Parámetro Descripción
status string; default = ''
Es una cadena que describe el estado actual del progreso de recuperación.

root_module_has_non_dev_dependency

bool module_ctx.root_module_has_non_dev_dependency

Indica si el módulo raíz usa esta extensión como una dependencia no de desarrollador.

cuál

path module_ctx.which(program)

Muestra la ruta de acceso del programa correspondiente o None si no hay tal programa en la ruta.

Parámetros

Parámetro Descripción
program obligatorio
Es el programa que se debe encontrar en la ruta.
Es posible que se muestre None.