Reglas del repositorio de utilidades

Las siguientes funciones se pueden cargar desde @bazel_tools//tools/build_defs/repo:utils.bzl.

maybe

maybe(repo_rule, name, kwargs)

Función de utilidad para agregar un repositorio solo si aún no está presente.

Esto es para implementar la macro safe repositories.bzl documentada en https://bazel.build/rules/deploying#dependencies.

Parámetros

repo_rule de procesamiento necesarios.

función de regla de repositorio.

name de procesamiento necesarios.

nombre del repositorio que se creará.

kwargs opcional.

argumentos restantes que se pasan a la función repo_rule.

parse_netrc

parse_netrc(contents, filename)

Función de utilidad para analizar al menos un archivo .netrc básico.

Parámetros

contents de procesamiento necesarios.

entrada para el analizador.

filename opcional. El valor predeterminado es None

nombre de archivo que se usará en los 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 a 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 no se especifican los parámetros patches, patch_tool, patch_args, patch_cmds y patch_cmds_win, se toman de ctx.attr.

Parámetros

ctx de procesamiento necesarios.

El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad función.

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 que se ejecutarán para aplicar parches, pasados de a uno a bash -c. Lista de cadenas

patch_cmds_win opcional. El valor predeterminado es None

Comandos de PowerShell que se ejecutarán para aplicar parches, pasados de a uno 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 parche que se ejecutará para aplicar parches. String.

patch_args opcional. El valor predeterminado es None

Argumentos para pasar a la herramienta de parche. 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 URLs.

read_netrc

read_netrc(ctx, filename)

Función de utilidad para analizar al menos un archivo .netrc básico.

Parámetros

ctx de procesamiento necesarios.

El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad función.

filename de procesamiento necesarios.

el nombre del archivo .netrc que se leerá

read_user_netrc

read_user_netrc(ctx)

Lee el archivo netrc predeterminado del usuario.

Parámetros

ctx de procesamiento necesarios.

El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad.

update_attrs

update_attrs(orig, keys, override)

Función de utilidad para modificar y agregar los atributos especificados a una invocación de regla de repositorio en particular.

Se usa para hacer que una regla sea reproducible.

Parámetros

orig de procesamiento necesarios.

diccionario de atributos configurados (ya sea de forma explícita o implícita) por una invocación de regla en particular

keys de procesamiento necesarios.

conjunto completo de atributos definidos en esta regla

override de procesamiento necesarios.

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 de procesamiento necesarios.

un archivo netrc ya analizado en un diccionario, p.ej., como se obtuvo de read_netrc

urls de procesamiento necesarios.

una lista de URLs.

patterns de procesamiento necesarios.

diccionario opcional de URL a 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. 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 de procesamiento necesarios.

El contexto del repositorio de la regla de repositorio que llama a esta función de utilidad función.