implementation
.
Miembros
- attr
- borrar
- descargar
- download_and_extract
- ejecutar
- extraer
- archivo
- name
- SO
- patch
- path
- leer
- report_progress
- symlink
- plantilla
- cuál
- workspace_root
attr
struct repository_ctx.attr
delete
bool repository_ctx.delete(path)
Parámetros
Parámetro | Descripción |
---|---|
path
|
string; or path ;
obligatorioEs la ruta de acceso del archivo que se borrará, relativa al directorio del repositorio o absoluta. Puede ser una ruta de acceso o una cadena. |
descarga
struct repository_ctx.download(url, output='', sha256='', executable=False, allow_fail=False, canonical_id='', auth={}, *, integrity='')
success
, una marca que es true
si la descarga se completó correctamente y, si se realizó correctamente, un hash del archivo con los campos sha256
y integrity
.
Parámetros
Parámetro | Descripción |
---|---|
url
|
string; or Iterable of strings ;
obligatorioLista de URLs duplicadas que hacen referencia al mismo archivo. |
output
|
string; or Label; or path ;
predeterminado = ''de salida al archivo de salida, en relación con el directorio del repositorio. |
sha256
|
predeterminado = '' 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 facilitar el desarrollo, pero se debe configurar antes del envío. |
executable
|
predeterminado = Falso establece la marca ejecutable en el archivo creado; es falso de forma predeterminada. |
allow_fail
|
predeterminado = Falso Si se configura, indica el error en el valor que se muestra en lugar de generar un error para las descargas con errores |
canonical_id
|
predeterminado = '' Si se configura, restringe los aciertos de caché a aquellos casos en los que el archivo se haya agregado a la caché con el mismo ID canónico |
auth
|
default = {} Un diccionario opcional que especifica la información de autenticación para algunas de las URL. |
integrity
|
predeterminado = '' Suma de comprobación esperada del archivo descargado, en formato de integridad de los subrecursos. Debe coincidir con la suma de comprobación del archivo descargado. Omitir la suma de comprobación 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 facilitar el desarrollo, pero se debe configurar antes del envío. |
download_and_extract
struct repository_ctx.download_and_extract(url, output='', sha256='', type='', stripPrefix='', allow_fail=False, canonical_id='', auth={}, *, integrity='', rename_files={})
success
, una marca true
si la descarga se completó correctamente y, si se realizó correctamente, un hash del archivo con los campos sha256
y integrity
.
Parámetros
Parámetro | Descripción |
---|---|
url
|
string; or Iterable of strings ;
obligatorioLista de URLs duplicadas que hacen referencia al mismo archivo. |
output
|
string; or Label; or path ;
predeterminado = ''la ruta de acceso al directorio donde se descomprimirá el archivo, en relación con el directorio del repositorio. |
sha256
|
predeterminado = '' 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 facilitar el desarrollo, pero se debe configurar 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é. Si la descarga se realiza correctamente, el archivo se agregará a la caché. |
type
|
predeterminado = '' 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 explícitamente “zip”, “jar”, “war”, “aar”, “tar”, “tar.gz”, “tgz”, “tar.xz”, “txz”, “.tar.zst”, “.tzst”, “tar.bz2”, “.ar” o “.deb” aquí. |
stripPrefix
|
predeterminado = '' un prefijo de directorio para quitar de los archivos extraídos. Muchos archivos contienen un directorio de nivel superior que contiene todos los archivos en el archivo. En lugar de necesitar especificar este prefijo una y otra vez en build_file , se puede usar este campo para quitarlo de los archivos extraídos.
|
allow_fail
|
predeterminado = Falso Si se configura, indica el error en el valor que se muestra en lugar de generar un error para las descargas con errores |
canonical_id
|
predeterminado = '' Si se configura, restringe los aciertos de caché a aquellos casos en los que el archivo se haya agregado a la caché con el mismo ID canónico |
auth
|
default = {} Un diccionario opcional que especifica la información de autenticación para algunas de las URL. |
integrity
|
predeterminado = '' Suma de comprobación esperada del archivo descargado, en formato de integridad de los subrecursos. Debe coincidir con la suma de comprobación del archivo descargado. Omitir la suma de comprobación 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 facilitar el desarrollo, pero se debe configurar antes del envío. |
rename_files
|
default = {} Un dict opcional que especifica los archivos a los que se les debe cambiar el nombre durante la extracción. Se cambiará el nombre de las entradas de archivo con nombres que coincidan exactamente con una clave por el valor, antes de cualquier ajuste del prefijo del 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 repository_ctx.execute(arguments, timeout=600, environment={}, quiet=True, working_directory="")
timeout
(en segundos, el valor predeterminado es 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 Lista de argumentos. El primer elemento debe ser la ruta de acceso al programa que se ejecutará. |
timeout
|
valor predeterminado = 600 la duración máxima del comando en segundos (el valor predeterminado es 600 segundos). |
environment
|
default = {} fuerce la configuración de 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 = "" Directorio de trabajo para la ejecución del comando. Puede ser absoluta o relativa a la raíz del repositorio. |
extract
None repository_ctx.extract(archive, output='', stripPrefix='', *, rename_files={})
Parámetros
Parámetro | Descripción |
---|---|
archive
|
string; or Label; or path ;
obligatorioruta de acceso al archivo que se desempaquetará, en relación con el directorio del repositorio. |
output
|
string; or Label; or path ;
predeterminado = ''la ruta de acceso al directorio donde se descomprimirá el archivo, en relación con el directorio del repositorio. |
stripPrefix
|
predeterminado = '' un prefijo de directorio para quitar de los archivos extraídos. Muchos archivos contienen un directorio de nivel superior que contiene todos los archivos en el archivo. En lugar de necesitar especificar este prefijo una y otra vez en build_file , se puede usar este campo para quitarlo de los archivos extraídos.
|
rename_files
|
default = {} Un dict opcional que especifica los archivos a los que se les debe cambiar el nombre durante la extracción. Se cambiará el nombre de las entradas de archivo con nombres que coincidan exactamente con una clave por el valor, antes de cualquier ajuste del prefijo del 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. |
archivo
None repository_ctx.file(path, content='', executable=True, legacy_utf8=True)
Parámetros
Parámetro | Descripción |
---|---|
path
|
string; or Label; or path ;
obligatoriola ruta de acceso del archivo que se creará, en relación con el directorio del repositorio. |
content
|
predeterminado = '' el contenido del archivo que se creará, vacío de forma predeterminada. |
executable
|
default = True establece la marca ejecutable en el archivo creado (true) de forma predeterminada. |
legacy_utf8
|
default = True para codificar el contenido del archivo en UTF-8, el valor predeterminado es verdadero. Las versiones futuras cambiarán el valor predeterminado y quitarán este parámetro. |
nombre
string repository_ctx.name
os
repository_os repository_ctx.os
patch
None repository_ctx.patch(patch_file, strip=0)
Parámetros
Parámetro | Descripción |
---|---|
patch_file
|
string; or Label; or path ;
obligatorioEl archivo de parche que se aplicará, puede ser una etiqueta, una ruta de acceso relativa o una ruta absoluta. Si es una ruta de acceso relativa, se resolverá en el directorio del repositorio. |
strip
|
valor predeterminado = 0 elimina el número especificado de componentes iniciales de los nombres de archivos. |
ruta de acceso
path repository_ctx.path(path)
Parámetros
Parámetro | Descripción |
---|---|
path
|
string; or Label; or path ;
obligatoriocadena, etiqueta o ruta desde la que crear una ruta |
read
string repository_ctx.read(path)
Parámetros
Parámetro | Descripción |
---|---|
path
|
string; or Label; or path ;
obligatoriola ruta de acceso del archivo desde el que se leerá. |
report_progress
None repository_ctx.report_progress(status='')
Parámetros
Parámetro | Descripción |
---|---|
status
|
string ;
predeterminado = ''Cadena que describe el estado actual del progreso de la recuperación |
symlink
None repository_ctx.symlink(target, link_name)
Parámetros
Parámetro | Descripción |
---|---|
target
|
string; or Label; or path ;
obligatorioLa ruta de acceso a la que debe apuntar el symlink. |
link_name
|
string; or Label; or path ;
obligatorioLa ruta de acceso del symlink que se creará, en relación con el directorio del repositorio. |
plantilla
None repository_ctx.template(path, template, substitutions={}, executable=True)
template
. Cada caso en template
de una clave de substitutions
se reemplazará por el valor correspondiente. El resultado se escribe en path
. Se puede configurar un argumento executable
opcional (el valor predeterminado es verdadero) para activar o desactivar el bit ejecutable.
Parámetros
Parámetro | Descripción |
---|---|
path
|
string; or Label; or path ;
obligatoriola ruta de acceso del archivo que se creará, en relación con el directorio del repositorio. |
template
|
string; or Label; or path ;
obligatorioal archivo de plantilla. |
substitutions
|
default = {} sustituciones que hacer cuando se expande la plantilla. |
executable
|
default = True establece la marca ejecutable en el archivo creado (true) de forma predeterminada. |
cuál
path repository_ctx.which(program)
Parámetros
Parámetro | Descripción |
---|---|
program
|
obligatorio Programa para encontrar en la ruta. |
None
.
workspace_root
path repository_ctx.workspace_root