config

Informar un problema Ver fuente Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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

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

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

Miembros

bool

BuildSetting config.bool(flag=False)

Un parámetro de configuración de compilación de tipo booleano

Parámetros

Parámetro Descripción
flag bool; el valor predeterminado es False
Indica si este parámetro de configuración de compilación se puede llamar desde 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 cadena o None; El valor predeterminado es None
Es 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)

Un parámetro de configuración de compilación con tipo de número entero

Parámetros

Parámetro Descripción
flag bool; el valor predeterminado es False
Indica si este parámetro de configuración de compilación se puede llamar desde la línea de comandos.

ninguno

transition config.none()

Crea una transición que quita toda la configuración y anula todos los parámetros. Se usa en el caso en que una dependencia es solo de datos y no contiene código que deba compilarse, sino que solo debe analizarse una vez.

string

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

Un parámetro de configuración de compilación de tipo cadena

Parámetros

Parámetro Descripción
flag bool; el valor predeterminado es False
Indica si este parámetro de configuración de compilación se puede llamar desde la línea de comandos.
allow_multiple bool; el valor predeterminado es False
Obsoleto. En su lugar, usa un parámetro de configuración de string_list con repeatable = True. Si se configura, esta marca se puede establecer varias veces en la línea de comandos. El valor de la marca al que se accede en las transiciones y en la función de implementación de la configuración de compilación será una lista de cadenas. Se mantienen el orden de inserción y los valores repetidos. Esta lista se puede procesar posteriormente en la función de implementación de la configuración de compilación si se desea un comportamiento diferente.

string_list

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

Es un parámetro de configuración de compilación con tipo de 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 bool; el valor predeterminado es False
Indica si este parámetro de configuración de compilación se puede llamar desde la línea de comandos.
repeatable bool; el valor predeterminado es False
Si se configura, en lugar de esperar un valor separado por comas, se permite que esta marca se establezca varias veces en la línea de comandos con cada valor individual tratado como una sola cadena para agregar al valor de la lista. Se mantienen el orden de inserción y los valores repetidos. Esta lista se puede procesar posteriormente en la función de implementación de la configuración de compilación si se desea un comportamiento diferente.

objetivo

transition config.target()

Crea una transición de destino. Esta es una transición no operativa diseñada para el caso en que se necesita un objeto de transición, pero no se desea cambiar nada. Equivale a cfg = "target" en attr.label().