Las siguientes funciones se pueden cargar desde @bazel_tools//tools/build_defs/repo:utils.bzl
.
tal vez
maybe(repo_rule, name, kwargs)
Es una función de utilidad solo para agregar un repositorio si aún no está presente.
Esto tiene como objetivo implementar la macro Repositories.bzl segura documentada en https://bazel.build/rules/deploying#Dependencies.
Parámetros
repo_rule |
o API.
función de regla de repositorio. |
name |
o API.
del repositorio que se creará. |
kwargs |
opcional.
los argumentos restantes que se pasan a la función repo_rule. |
parse_netrc
parse_netrc(contents, filename)
Es una función de utilidad para analizar al menos un archivo .netrc básico.
Parámetros
contents |
o API.
para el analizador. |
filename |
opcional. El valor predeterminado es None .
nombre de archivo para utilizarlo en mensajes de error, si corresponde. |
patch
patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)
Implementación de la aplicación de parches en un repositorio ya extraído.
Esta regla está diseñada para usarse en la función de implementación de una regla de repositorio. Si los parámetros patches
, patch_tool
, patch_args
, patch_cmds
y patch_cmds_win
no se especifican, se toman de ctx.attr
.
Parámetros
ctx |
o API.
El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad. |
patches |
opcional. El valor predeterminado es None .
Los archivos de parche que se aplicarán. Lista de cadenas, etiquetas o rutas de acceso. |
patch_cmds |
opcional. El valor predeterminado es None .
Comandos de Bash para ejecutar para la aplicación de parches, que se pasan uno a la vez a bash -c. Lista de strings |
patch_cmds_win |
opcional. El valor predeterminado es None .
Comandos de PowerShell para ejecutar para la aplicación de parches, que se pasan uno a la vez a powershell /c Lista de cadenas. Si el valor booleano de este parámetro es falso, se usará patch_cmds y se ignorará este parámetro. |
patch_tool |
opcional. El valor predeterminado es None .
Ruta de acceso de la herramienta de parches que se ejecutará para aplicar parches. String. |
patch_args |
opcional. El valor predeterminado es None .
Argumentos para pasar a la herramienta de parches. Lista de cadenas. |
auth |
opcional. El valor predeterminado es None .
Un diccionario opcional que especifica la información de autenticación para algunas de las URL. |
read_netrc
read_netrc(ctx, filename)
Es una función de utilidad para analizar al menos un archivo .netrc básico.
Parámetros
ctx |
o API.
El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad. |
filename |
o API.
el nombre del archivo .netrc que se leerá |
read_user_netrc
read_user_netrc(ctx)
Leer el archivo netrc predeterminado del usuario
Parámetros
ctx |
o API.
El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad. |
update_attrs
update_attrs(orig, keys, override)
Es una función de utilidad para modificar y agregar los atributos especificados a una invocación de regla de repositorio en particular.
Se usa para que una regla sea reproducible.
Parámetros
orig |
o API.
de atributos establecidos (de forma explícita o implícita) a través de la invocación de una regla en particular |
keys |
o API.
conjunto completo de atributos definidos en esta regla |
override |
o API.
diccionario de atributos para anular o agregar a Orig |
use_netrc
use_netrc(netrc, urls, patterns)
Calcula un diccionario de autenticación a partir de un archivo netrc analizado y una lista de URLs.
Parámetros
netrc |
o API.
un archivo netrc ya analizado como un dict, p.ej., como obtenido de read_netrc |
urls |
o API.
una lista de URLs. |
patterns |
o API.
diccionario opcional de URL para patrones de autorización |
workspace_and_buildfile
workspace_and_buildfile(ctx)
Función de utilidad para escribir WORKSPACE y, si se solicita, un archivo BUILD.
Esta regla está diseñada para usarse en la función de implementación de una regla de repositorio.
Se supone que los parámetros name
, build_file
, build_file_content
, workspace_file
y workspace_file_content
están presentes en ctx.attr
; los últimos cuatro posiblemente con el valor None.
Parámetros
ctx |
o API.
El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad. |