Todos los archivos de Bazel

Informar un problema

Métodos disponibles en todos los archivos de Bazel, incluidos los archivos .bzl, BUILD, MODULE.bazel y WORKSPACE.

Miembros

abs

unknown abs(x)

Muestra el valor absoluto de un número (un número no negativo con la misma magnitud).
abs(-2.3) == 2.3

Parámetros

Parámetro Descripción
x int; o float; obligatorio
Un número (int o float)

todos

bool all(elements)

El resultado es verdadero si todos los elementos se evalúan como verdaderos o si la colección está vacía. Los elementos se convierten en booleanos con la función bool.
all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parámetros

Parámetro Descripción
elements obligatorio
Es una string o una colección de elementos.

cualquiera

bool any(elements)

El resultado es verdadero si al menos un elemento se evalúa como verdadero. Los elementos se convierten en booleanos con la función bool.
any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parámetros

Parámetro Descripción
elements obligatorio
Es una string o una colección de elementos.

bool

bool bool(x=False)

Constructor del tipo bool. Muestra False si el objeto es None, False, una string vacía (""), el número 0 o una colección vacía (p.ej., (), []). De lo contrario, muestra True.

Parámetros

Parámetro Descripción
x el valor predeterminado es False
La variable que se convertirá.

dict

dict dict(pairs=[], **kwargs)

Crea un diccionario a partir de un argumento posicional opcional y un conjunto opcional de argumentos de palabras clave. Si se proporciona la misma clave varias veces, se usará el último valor. Se considera que las entradas proporcionadas a través de los argumentos de palabra clave provienen de las entradas proporcionadas a través del argumento posicional.

Parámetros

Parámetro Descripción
pairs el valor predeterminado es []
Un dict o un iterable cuyos elementos son cada uno de longitud 2 (clave, valor).
kwargs obligatorio
Diccionario de entradas adicionales.

dir

list dir(x)

Muestra una lista de cadenas: los nombres de los atributos y los métodos del objeto de parámetro.

Parámetros

Parámetro Descripción
x required
El objeto que se verificará.

enumerar

list enumerate(list, start=0)

Muestra una lista de pares (tuplas de dos elementos), con el índice (int) y el elemento de la secuencia de entrada. 
enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parámetros

Parámetro Descripción
list secuencia de entrada
requerida.
start el valor predeterminado es 0
índice de inicio.

desaprobado

None fail(msg=None, attr=None, *args)

Hace que la ejecución falle con un error.

Parámetros

Parámetro Descripción
msg el valor predeterminado es None
Obsoleta: usa argumentos posicionales. Este argumento actúa como un argumento posicional inicial implícito.
attr string; o None; el valor predeterminado es None
dejó de estar disponible. Hace que un prefijo opcional que contiene esta cadena se agregue al mensaje de error.
args required
Es una lista de valores, formateados con debugPrint (que equivale a str de forma predeterminada) y combinados con espacios, que aparecen en el mensaje de error.

float

float float(x=unbound)

Muestra x como un valor de número de punto flotante.
  • Si x ya es un número de punto flotante, float no lo muestra sin cambios.
  • Si x es un bool, float muestra 1.0 para verdadero y 0.0 para Falso.
  • Si x es un número entero, float muestra el valor de punto flotante finito más cercano a x, o bien un error si la magnitud es demasiado grande.
  • Si x es una string, debe ser un literal de punto flotante válido o ser igual (sin distinguir entre mayúsculas y minúsculas) a NaN, Inf o Infinity, precedido opcionalmente por un signo + o -.
Cualquier otro valor generará un error. Sin argumentos, float() muestra 0.0.

Parámetros

Parámetro Descripción
x el valor predeterminado es unbound
El valor que se va a convertir.

getattr

unknown getattr(x, name, default=unbound)

Muestra el campo de la estructura del nombre dado, si existe. De lo contrario, muestra default (si se especifica) o genera un error. getattr(x, "foobar") equivale a x.foobar.
getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parámetros

Parámetro Descripción
x required
La estructura a cuyo atributo se accede.
name obligatorio
Es el nombre del atributo struct.
default El valor predeterminado es unbound.
El valor predeterminado que se muestra en caso de que el struct no tenga un atributo con el nombre determinado.

Hasattr

bool hasattr(x, name)

Muestra el valor True si el objeto x tiene un atributo o método del name determinado; de lo contrario, muestra el valor False. Ejemplo:
hasattr(ctx.attr, "myattr")

Parámetros

Parámetro Descripción
x required
El objeto que se verificará.
name obligatorio
Es el nombre del atributo.

hash

int hash(value)

Muestra un valor de hash para una string. Esto se calcula de forma determinista con el mismo algoritmo que String.hashCode() de Java, es decir: 
s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]
Actualmente, no se admite el hash de valores que no sean strings.

Parámetros

Parámetro Descripción
value obligatorio
El valor de la string para el hash.

int

int int(x, base=unbound)

Muestra x como un valor int.
  • Si x ya es un número entero, int lo muestra sin cambios.
  • Si x es un bool, int muestra 1 para verdadero y 0 para Falso.
  • Si x es una string, debe tener el formato <sign><prefix><digits>. <sign> es "+", "-" o está vacío (se interpreta como positivo). <digits> es una secuencia de dígitos del 0 al base-1, en la que las letras a-z (o equivalentes, A-Z) se usan como dígitos del 10 al 35. Cuando base sea 2/8/16, <prefix> es opcional y puede ser 0b/0o/0x (o equivalente, 0B/0O/0X) respectivamente. Si base es cualquier otro valor además de estas bases o el valor especial 0, el prefijo debe estar vacío. Cuando base es 0, la string se interpreta como un literal de número entero, en el sentido de que se elige una de las bases 2/8/10/16 según el prefijo que se use. Si base es 0, no se usa ningún prefijo y si hay más de un dígito, el primer dígito no puede ser 0; esto es para evitar confusiones entre el octal y el decimal. La magnitud del número que representa la cadena debe estar dentro del rango permitido para el tipo int.
  • Si x es un número de punto flotante, int muestra el valor entero del número de punto flotante, que se redondea hacia cero. Es un error si x no es finito (NaN o infinito).
Esta función falla si x es de otro tipo o si el valor es una string que no cumple con el formato anterior. A diferencia de la función int de Python, esta no permite cero argumentos ni espacios en blanco irrelevantes para los argumentos de string.

Ejemplos:

int("123") == 123
int("-123") == -123
int("+123") == 123
int("FF", 16) == 255
int("0xFF", 16) == 255
int("10", 0) == 10
int("-0x10", 0) == -16
int("-0x10", 0) == -16
int("123.456") == 123

Parámetros

Parámetro Descripción
x obligatorio
Cadena que se convertirá.
base El valor predeterminado es unbound.
La base que se usa para interpretar un valor de cadena; el valor predeterminado es 10. Debe estar entre 2 y 36 (inclusive), o 0 para detectar la base como si x fuera un literal de número entero. No se debe proporcionar este parámetro si el valor no es una cadena.

len

int len(x)

Muestra la longitud de una string, una secuencia (como una lista o una tupla), un dict o algún otro iterable.

Parámetros

Parámetro Descripción
x obligatorio
Es el valor cuya longitud se va a informar.

list

list list(x=[])

Muestra una lista nueva con los mismos elementos que el valor iterable especificado.
list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

Parámetros

Parámetro Descripción
x el valor predeterminado es []
El objeto que se convertirá.

max

unknown max(*args)

Muestra el mayor de todos los argumentos especificados. Si solo se proporciona un argumento, debe ser un iterable que no esté vacío.Es un error si los elementos no son comparables (por ejemplo, int con string) o si no se proporcionan argumentos. 
max(2, 5, 4) == 5
max([5, 6, 3]) == 6

Parámetros

Parámetro Descripción
args obligatorio
Los elementos que se deben comprobar.

min

unknown min(*args)

Muestra el más pequeño de todos los argumentos especificados. Si solo se proporciona un argumento, debe ser un iterable que no esté vacío. Es un error si los elementos no son comparables (por ejemplo, int con string) o si no se proporcionan argumentos. 
min(2, 5, 4) == 2
min([5, 6, 3]) == 3

Parámetros

Parámetro Descripción
args obligatorio
Los elementos que se deben comprobar.

imprimir

None print(sep=" ", *args)

Imprime args como resultado de depuración. Tendrá el prefijo de la cadena "DEBUG" y la ubicación (archivo y número de línea) de esta llamada. No se especifica la forma exacta en que los argumentos se convierten en cadenas, y puede cambiar en cualquier momento. En particular, puede ser diferente del formato que usan str() y repr(), además de ser más detallado.

No se recomienda el uso de print en el código de producción debido al spam que crea para los usuarios. Para las bajas, te recomendamos que uses fail() ante un error grave siempre que sea posible.

Parámetros

Parámetro Descripción
sep el valor predeterminado es " "
Es la cadena de separador entre los objetos y el valor predeterminado es el espacio (" ").
args required
Son los objetos que se imprimirán.

rango

sequence range(start_or_stop, stop_or_none=None, step=1)

Crea una lista en la que los elementos pasan de start a stop con un incremento de step. Si se proporciona un solo argumento, los elementos variarán de 0 a ese elemento.
range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

Parámetros

Parámetro Descripción
start_or_stop obligatorio
Valor del elemento de inicio si se proporciona una parada; de lo contrario, el valor de la parada y el inicio real son 0.
stop_or_none int; o None; el valor predeterminado es None
índice opcional del primer elemento que no se incluirá en la lista resultante; la generación de la lista se detiene antes de llegar a stop.
step La configuración predeterminada es 1.
El incremento (el valor predeterminado es 1). Es posible que sea negativo.

repr

string repr(x)

Convierte cualquier objeto en una representación de string. Esto es útil para la depuración.
repr("ab") == '"ab"'

Parámetros

Parámetro Descripción
x required
El objeto que se convertirá.

Revertida

list reversed(sequence)

Muestra una lista nueva, no congelada que contiene los elementos de la secuencia iterable original en orden inverso.
reversed([3, 5, 4]) == [4, 5, 3]

Parámetros

Parámetro Descripción
sequence required
La secuencia iterable (p.ej., lista) que se revertirá.

ordenado

list sorted(iterable, *, key=None, reverse=False)

Muestra una lista ordenada nueva que contiene todos los elementos de la secuencia iterable proporcionada. Puede producirse un error si cualquier par de elementos x e y no se pueden comparar usando x < y. Los elementos se ordenan en orden ascendente, a menos que el argumento inverso sea True, en cuyo caso el orden es descendente. La ordenación es estable: los elementos que comparan igual mantienen su orden relativo original. 
sorted([3, 5, 4]) == [3, 4, 5]

Parámetros

Parámetro Descripción
iterable required
La secuencia iterable que se debe ordenar.
key el valor predeterminado es None
Es una función opcional que se aplica a cada elemento antes de la comparación.
reverse el valor predeterminado es False
Muestra los resultados en orden descendente.

str

string str(x)

Convierte cualquier objeto en string. Esto es útil para la depuración.
str("ab") == "ab"
str(8) == "8"

Parámetros

Parámetro Descripción
x required
El objeto que se convertirá.

tuple

tuple tuple(x=())

Muestra una tupla con los mismos elementos que el valor iterable dado.
tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

Parámetros

Parámetro Descripción
x el valor predeterminado es ()
El objeto que se convertirá.

tipo

string type(x)

Muestra el nombre de tipo de su argumento. Esto es útil para la depuración y la comprobación de tipos. Ejemplos:
type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"
Esta función podría cambiar en el futuro. Si quieres escribir un código compatible con Python y prepararte para el futuro, úsalo solo para comparar valores que se muestran: 
if type(x) == type([]):  # if x is a list

Parámetros

Parámetro Descripción
x obligatorio
El objeto del que se verificará el tipo.

zip

list zip(*args)

Muestra un list de tuple, en el que la tupla i-th contiene el i-ésimo elemento de cada una de las secuencias de argumentos o los elementos iterables. La lista tiene el tamaño de la entrada más corta. Con un solo argumento iterable, muestra una lista de 1-tuplas. Sin argumentos, muestra una lista vacía. Ejemplos:
zip()  # == []
zip([1, 2])  # == [(1,), (2,)]
zip([1, 2], [3, 4])  # == [(1, 3), (2, 4)]
zip([1, 2], [3, 4, 5])  # == [(1, 3), (2, 4)]

Parámetros

Parámetro Descripción
args las listas necesarias
que se comprimirán.