config

Informar un problema Ver fuente

Este es un módulo de nivel superior para crear transiciones de configuración y compilar descriptores de configuración que describen qué tipo de configuración de compilación (si existe) es una regla.

P. ej., la siguiente regla se marca como una configuración de compilación mediante la configuración del parámetro build_setting de la función rule(). Específicamente, es una configuración de compilación de tipo int y es un flag, lo que significa que se puede llamar a esta configuración de compilación en la línea de comandos.

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

Miembros

bool

BuildSetting config.bool(flag=False)

Una configuración de compilación de tipo bool

Parámetros

Parámetro Descripción
flag el valor predeterminado es False
Indica si se puede llamar a esta configuración de compilación en la línea de comandos.

exec

ExecTransitionFactory config.exec(exec_group=None)

Crea una transición de ejecución.

Parámetros

Parámetro Descripción
exec_group string o None; el valor predeterminado es None
El nombre del grupo de ejecución cuya plataforma de ejecución usará esta transición. Si no se proporciona, esta transición de ejecución usará la plataforma de ejecución predeterminada del destino.

int

BuildSetting config.int(flag=False)

Una configuración de compilación de tipo de número entero

Parámetros

Parámetro Descripción
flag el valor predeterminado es False
Indica si se puede llamar a esta configuración de compilación en la línea de comandos.

cadena

BuildSetting config.string(flag=False, allow_multiple=False)

Una configuración de compilación de tipo cadena

Parámetros

Parámetro Descripción
flag el valor predeterminado es False
Indica si se puede llamar a esta configuración de compilación en la línea de comandos.
allow_multiple el valor predeterminado es False
Obsoleto, usa un parámetro de configuración string_list con repeatable = True en su lugar. Si se establece, esta marca se puede configurar varias veces en la línea de comandos. El valor de la marca como se accede en las transiciones y la función de implementación del parámetro de compilación será una lista de cadenas. El pedido de inserción y los valores repetidos se mantienen. Esta lista se puede procesar con posterioridad en la función de implementación de la configuración de la compilación si se desea un comportamiento diferente.

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

Una configuración de compilación tipo lista de cadenas. En la línea de comandos, pasa una lista con valores separados por comas, como --//my/setting=foo,bar.

Parámetros

Parámetro Descripción
flag el valor predeterminado es False
Indica si se puede llamar a esta configuración de compilación en la línea de comandos.
repeatable el valor predeterminado es False
Si se establece, en lugar de esperar un valor separado por comas, esta marca se puede configurar varias veces en la línea de comandos y cada valor individual se trata como una sola cadena que se agrega al valor de la lista. El pedido de inserción y los valores repetidos se mantienen. Esta lista se puede procesar con posterioridad en la función de implementación de la configuración de la compilación si se desea un comportamiento diferente.