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 parámetro de configuración de compilación configurando 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 se puede llamar a este parámetro de 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)Un parámetro de configuración de compilación de tipo bool
Parámetros
| Parámetro | Descripción |
|---|---|
flag
|
bool;
El valor predeterminado es FalseIndica si se puede llamar a este parámetro de 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
|
cadena o None;
el valor predeterminado es NoneEs 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 de tipo número entero
Parámetros
| Parámetro | Descripción |
|---|---|
flag
|
bool;
El valor predeterminado es FalseIndica si se puede llamar a este parámetro de configuración de compilación en la línea de comandos. |
ninguno
transition config.none()Crea una transición que quita toda la configuración y anula todas las marcas. Se usa en el caso en que una dependencia solo tiene datos y no contiene código que se deba compilar, pero solo se debe analizar una vez.
string
BuildSetting config.string(flag=False, allow_multiple=False)Un parámetro de configuración de compilación de tipo de cadena
Parámetros
| Parámetro | Descripción |
|---|---|
flag
|
bool;
El valor predeterminado es FalseIndica si se puede llamar a este parámetro de configuración de compilación en la línea de comandos. |
allow_multiple
|
bool;
El valor predeterminado es False.Está obsoleto. En su lugar, usa una configuración string_list con repeatable = True. Si se establece, 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 la función de implementación de parámetros de 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 de tipo lista de cadenas. En la línea de comandos, pasa una lista con un valor separado por comas, como
--//my/setting=foo,bar.
Parámetros
| Parámetro | Descripción |
|---|---|
flag
|
bool;
El valor predeterminado es FalseIndica si se puede llamar a este parámetro de configuración de compilación en la línea de comandos. |
repeatable
|
bool;
El valor predeterminado es FalseSi se establece, en lugar de esperar un valor separado por comas, esta marca se puede establecer varias veces en la línea de comandos, y cada valor individual se considera 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 sin operaciones diseñada para el caso en el que se necesita un objeto de transición, pero no se quiere cambiar nada. Equivale a
cfg = "target" en attr.label().