Métodos disponibles en los archivos MODULE.bazel.
Miembros
- archive_override
- bazel_dep
- git_override
- include
- inject_repo
- local_path_override
- module
- multiple_version_override
- override_repo
- register_execution_platforms
- register_toolchains
- single_version_override
- use_extension
- use_repo
- use_repo_rule
archive_override
None
archive_override(module_name, urls, integrity='', strip_prefix='', patches=[], patch_cmds=[], patch_strip=0)
Parámetros
Parámetro | Descripción |
---|---|
module_name
|
obligatorio Es el nombre de la dependencia del módulo de Bazel a la que se aplicará esta anulación. |
urls
|
cadena o iterable de cadenas;
obligatorio Las URLs del archivo; pueden ser URLs http(s):// o file://. |
integrity
|
El valor predeterminado es '' Es la suma de comprobación esperada del archivo de almacenamiento en búfer, en formato de integridad de subrecursos. |
strip_prefix
|
El valor predeterminado es '' Es un prefijo de directorio para quitar los archivos extraídos. |
patches
|
Iterable de string; el valor predeterminado es [] Una lista de etiquetas que apuntan a archivos de parche para aplicar en este módulo. Los archivos de parches deben existir en el árbol de origen del proyecto de nivel superior. Se aplican en el orden de lista. |
patch_cmds
|
Es un iterador de cadenas.
El valor predeterminado es [] . Es la secuencia de comandos de Bash que se aplicará en Linux/MacOS después de aplicar los parches. |
patch_strip
|
El valor predeterminado es 0 . Es igual que el argumento --strip del parche de Unix. |
bazel_dep
None
bazel_dep(name, version='', max_compatibility_level=-1, repo_name='', dev_dependency=False)
Parámetros
Parámetro | Descripción |
---|---|
name
|
obligatorio Es el nombre del módulo que se agregará como dependencia directa. |
version
|
el valor predeterminado es '' La versión del módulo que se agregará como dependencia directa. |
max_compatibility_level
|
el valor predeterminado es -1 El compatibility_level máximo admitido para que se agregue el módulo como dependencia directa. La versión del módulo implica el nivel de compatibilidad mínimo compatible, así como el máximo si no se especifica este atributo.
|
repo_name
|
El valor predeterminado es '' Es el nombre del repositorio externo que representa esta dependencia. Este es el nombre del módulo de forma predeterminada. |
dev_dependency
|
El valor predeterminado es False Si es verdadero, se ignorará esta dependencia si el módulo actual no es el módulo raíz o si está habilitado `--ignore_dev_dependency`. |
git_override
None
git_override(module_name, remote, commit='', patches=[], patch_cmds=[], patch_strip=0, init_submodules=False, strip_prefix='')
Parámetros
Parámetro | Descripción |
---|---|
module_name
|
obligatorio Es el nombre de la dependencia del módulo de Bazel a la que se aplicará esta anulación. |
remote
|
obligatorio Es la URL del repositorio de Git remoto. |
commit
|
El valor predeterminado es '' Es la confirmación que se debe consultar. |
patches
|
Es un iterador de cadenas.
El valor predeterminado es [] . Es una lista de etiquetas que apuntan a archivos de parches para aplicar a este módulo. Los archivos de parches deben existir en el árbol de origen del proyecto de nivel superior. Se aplican en el orden de lista. |
patch_cmds
|
Es un iterador de cadenas.
El valor predeterminado es [] . Es la secuencia de comandos de Bash que se aplicará en Linux/MacOS después de aplicar los parches. |
patch_strip
|
El valor predeterminado es 0 .Igual que el argumento --strip del parche de Unix. |
init_submodules
|
El valor predeterminado es False Indica si los submódulos de git en el repositorio recuperado deben inicializarse de forma recursiva. |
strip_prefix
|
El valor predeterminado es '' Es un prefijo de directorio para quitar los archivos extraídos. Se puede usar para orientar a un subdirectorio del repositorio de Git. Ten en cuenta que el subdirectorio debe tener su propio archivo "MODULE.bazel" con un nombre de módulo que sea el mismo que el argumento "module_name" que se pasa a esta "git_override". |
incluye
None
include(label)
include()
se comporta como si el archivo incluido se colocara de forma textual en la ubicación de la llamada a include()
, excepto que las vinculaciones de variables (como las que se usan para use_extension
) solo son visibles en el archivo en el que se producen, no en ningún archivo incluido o que incluye.Solo el módulo raíz puede usar include()
. Se produce un error si el archivo MODULE de un bazel_dep
usa include()
.
Solo se pueden incluir archivos en el repositorio principal.
include()
te permite segmentar el archivo del módulo raíz en varias partes, para evitar tener un archivo MODULE.bazel enorme o administrar mejor el control de acceso para segmentos semánticos individuales.
Parámetros
Parámetro | Descripción |
---|---|
label
|
obligatorio Es la etiqueta que apunta al archivo que se incluirá. La etiqueta debe apuntar a un archivo en el repositorio principal; en otras palabras, debe comenzar con barras diagonales dobles ( // ).
|
inject_repo
None
inject_repo(extension_proxy, *args, **kwargs)
En su lugar, usa override_repo
para anular un repo existente.
Parámetros
Parámetro | Descripción |
---|---|
extension_proxy
|
obligatorio Es un objeto de proxy de extensión de módulo que muestra una llamada a use_extension .
|
args
|
obligatorio Los repositorios visibles para el módulo actual que se deben insertar en la extensión con el mismo nombre. |
kwargs
|
obligatorio Los repositorios nuevos que se insertarán en la extensión, en los que los valores son los nombres de los repositorios en el alcance del módulo actual y las claves son el nombre con el que serán visibles en la extensión. |
local_path_override
None
local_path_override(module_name, path)
Parámetros
Parámetro | Descripción |
---|---|
module_name
|
obligatorio Es el nombre de la dependencia del módulo de Bazel a la que se aplicará esta anulación. |
path
|
obligatorio Es la ruta de acceso al directorio en el que se encuentra este módulo. |
module
None
module(name='', version='', compatibility_level=0, repo_name='', bazel_compatibility=[])
Se debe llamar como máximo una vez y, si se lo hace, debe ser la primera directiva del archivo MODULE.bazel. Se puede omitir solo si este módulo es el módulo raíz (como en el caso de que otro módulo no dependa de él).
Parámetros
Parámetro | Descripción |
---|---|
name
|
El valor predeterminado es '' Es el nombre del módulo. Se puede omitir solo si este módulo es el módulo raíz (es decir, si otro módulo no dependerá de él). Un nombre de módulo válido debe cumplir con los siguientes requisitos: 1) Solo debe contener letras minúsculas (a-z), números (0-9), puntos (.), guiones (-) y guiones bajos (_); 2) Debe comenzar con una letra minúscula; 3) Debe terminar con una letra minúscula o un número. |
version
|
El valor predeterminado es '' Es la versión del módulo. Se puede omitir solo si este módulo es el módulo raíz (como en el caso de que otro módulo no dependa de él). La versión debe estar en un formato SemVer relajado. Consulta la documentación para obtener más detalles. |
compatibility_level
|
El valor predeterminado es 0 Es el nivel de compatibilidad del módulo. Se debe cambiar cada vez que se introduce un cambio incompatible importante. Esta es, en esencia, la "versión principal" del módulo en términos de SemVer, excepto que no está incorporada en la cadena de versión, sino que existe como un campo independiente. Los módulos con diferentes niveles de compatibilidad participan en la resolución de versiones como si fueran módulos con nombres diferentes, pero el gráfico de dependencias final no puede contener varios módulos con el mismo nombre, pero con diferentes niveles de compatibilidad (a menos que multiple_version_override esté vigente). Para obtener más detalles, consulta la documentación.
|
repo_name
|
El valor predeterminado es '' . Es el nombre del repositorio que representa este módulo, tal como lo ve el módulo. De forma predeterminada, el nombre del repositorio es el nombre del módulo. Esto se puede especificar para facilitar la migración de los proyectos que han estado usando un nombre de repo para sí mismos que difiere del nombre de su módulo. |
bazel_compatibility
|
Iterable de string; el valor predeterminado es [] Una lista de versiones de Bazel que permite a los usuarios declarar qué versiones de Bazel son compatibles con este módulo. NO afecta la resolución de dependencias, pero bzlmod usará esta información para verificar si tu versión actual de Bazel es compatible. El formato de este valor es una cadena de algunos valores de restricción separados por comas. Se admiten tres restricciones: <=X.X.X: La versión de Bazel debe ser igual o anterior a X.X.X. Se usa cuando hay un cambio incompatible conocido en una versión más reciente. >=X.X.X: La versión de Bazel debe ser igual o posterior a X.X.X. Se usa cuando dependes de algunas funciones que solo están disponibles desde X.X.X. -X.X.X: La versión X.X.X de Bazel no es compatible. Se usa cuando hay un error en X.X.X que causa un error, pero se corrige en versiones posteriores. |
multiple_version_override
None
multiple_version_override(module_name, versions, registry='')
Parámetros
Parámetro | Descripción |
---|---|
module_name
|
obligatorio Es el nombre de la dependencia del módulo de Bazel a la que se aplicará esta anulación. |
versions
|
Es un iterador de cadenas;
obligatorio Especifica de forma explícita las versiones que pueden coexistir. Estas versiones ya deben estar presentes en la preselección del gráfico de dependencias. Las dependencias de este módulo se "actualizarán" a la versión permitida más cercana en el mismo nivel de compatibilidad, mientras que las dependencias que tengan una versión superior a cualquier versión permitida en el mismo nivel de compatibilidad generarán un error. |
registry
|
El valor predeterminado es '' Anula el registro de este módulo. En lugar de encontrar este módulo en la lista predeterminada de registros, se debe usar el registro determinado. |
override_repo
None
override_repo(extension_proxy, *args, **kwargs)
En su lugar, usa inject_repo
para agregar un repositorio nuevo.
Parámetros
Parámetro | Descripción |
---|---|
extension_proxy
|
obligatorio Un objeto de proxy de extensión de módulo que muestra una llamada a use_extension .
|
args
|
obligatorio Los repositorios de la extensión que se deben anular con los repositorios del mismo nombre en el módulo actual. |
kwargs
|
obligatorio Las anulaciones que se aplicarán a los repositorios generados por la extensión, en los que los valores son los nombres de los repositorios en el alcance del módulo actual y las claves son los nombres de los repositorios que anularán en la extensión. |
register_execution_platforms
None
register_execution_platforms(dev_dependency=False, *platform_labels)
@
o //
). Consulta resolución de cadena de herramientas para obtener más información.
Parámetros
Parámetro | Descripción |
---|---|
dev_dependency
|
El valor predeterminado es False Si es verdadero, las plataformas de ejecución no se registrarán si el módulo actual no es el módulo raíz o si está habilitada la opción `--ignore_dev_dependency`. |
platform_labels
|
secuencia de cadenas;
obligatorio Son las etiquetas de las plataformas que se registrarán. |
register_toolchains
None
register_toolchains(dev_dependency=False, *toolchain_labels)
@
o //
). Consulta resolución de cadena de herramientas para obtener más información.
Parámetros
Parámetro | Descripción |
---|---|
dev_dependency
|
default es False Si es verdadero, las cadenas de herramientas no se registrarán si el módulo actual no es el módulo raíz o si está habilitado `--ignore_dev_dependency`. |
toolchain_labels
|
secuencia de cadenas;
obligatorio Son las etiquetas de las cadenas de herramientas que se registrarán. Las etiquetas pueden incluir :all , en cuyo caso, todos los destinos que proporcionan la cadena de herramientas en el paquete se registrarán en orden alfabético por nombre.
|
single_version_override
None
single_version_override(module_name, version='', registry='', patches=[], patch_cmds=[], patch_strip=0)
Parámetros
Parámetro | Descripción |
---|---|
module_name
|
obligatorio Es el nombre de la dependencia del módulo de Bazel a la que se aplicará esta anulación. |
version
|
El valor predeterminado es '' Anula la versión declarada de este módulo en el gráfico de dependencias. En otras palabras, este módulo se “fijará” a esta versión de anulación. Este atributo se puede omitir si lo único que se quiere anular es el registro o los parches. |
registry
|
El valor predeterminado es '' Anula el registro de este módulo. En lugar de encontrar este módulo en la lista predeterminada de registros, se debe usar el registro determinado. |
patches
|
Es un iterador de cadenas.
El valor predeterminado es [] . Es una lista de etiquetas que apuntan a archivos de parches para aplicar a este módulo. Los archivos de parche deben existir en el árbol fuente del proyecto de nivel superior. Se aplican en el orden de la lista. Si un parche realiza cambios en el archivo MODULE.bazel, estos cambios solo serán efectivos si el módulo raíz proporciona el archivo de parche. |
patch_cmds
|
Iterable de strings; el valor predeterminado es [] La secuencia de comandos de Bash que se aplicará en Linux/Macos después de aplicar los parches. Los cambios en el archivo MODULE.bazel no se aplicarán. |
patch_strip
|
El valor predeterminado es 0 . Es igual que el argumento --strip del parche de Unix. |
use_extension
module_extension_proxy use_extension(extension_bzl_file, extension_name, *, dev_dependency=False, isolate=False)
Parámetros
Parámetro | Descripción |
---|---|
extension_bzl_file
|
requerido Una etiqueta para el archivo de Starlark que define la extensión del módulo. |
extension_name
|
obligatorio Es el nombre de la extensión del módulo que se usará. El archivo Starlark debe exportar un símbolo con este nombre. |
dev_dependency
|
El valor predeterminado es False Si es verdadero, se ignorará este uso de la extensión del módulo si el módulo actual no es el módulo raíz o si está habilitada la opción `--ignore_dev_dependency`. |
isolate
|
la configuración predeterminada es False Experimental. Este parámetro es experimental y puede cambiar en cualquier momento. No dependa de él. Se puede habilitar de forma experimental configurando ---experimental_isolated_extension_usages Si es verdadero, este uso de la extensión del módulo se aislará de todos los demás usos, tanto en este como en otros módulos. Las etiquetas creadas para este uso no afectan a otros usos, y los repositorios que genera la extensión para este uso serán distintos de todos los demás repositorios que genera la extensión. Por el momento, este parámetro es experimental y solo está disponible con la marca |
use_repo
None
use_repo(extension_proxy, *args, **kwargs)
Parámetros
Parámetro | Descripción |
---|---|
extension_proxy
|
obligatorio Es un objeto de proxy de extensión de módulo que muestra una llamada a use_extension .
|
args
|
obligatorio Son los nombres de los repositorios que se importarán. |
kwargs
|
required Especifica ciertos repositorios para importar al alcance del módulo actual con nombres diferentes. Las claves deben ser el nombre que se usará en el alcance actual, mientras que los valores deben ser los nombres originales que exporta la extensión del módulo. |
use_repo_rule
repo_rule_proxy use_repo_rule(repo_rule_bzl_file, repo_rule_name)
name
en el proxy. El atributo dev_dependency
booleano implícito también se puede usar en el proxy para indicar que un repositorio determinado solo se debe crear cuando el módulo actual es el módulo raíz.
Parámetros
Parámetro | Descripción |
---|---|
repo_rule_bzl_file
|
obligatorio Es una etiqueta para el archivo Starlark que define la regla del repositorio. |
repo_rule_name
|
obligatorio Es el nombre de la regla del repositorio que se usará. El archivo Starlark debe exportar un símbolo con este nombre. |