Este é um módulo de nível superior para criar transições de configuração e descritores de configuração de build que descrevem o tipo de configuração de compilação (se houver) de uma regra.
Exemplo: a regra a seguir é marcada como uma configuração de build definindo o parâmetro build_setting
da função rule()
. Especificamente, ela é uma configuração de build do tipo int
e um flag
, o que significa que é possível chamar essa configuração na linha de comando.
my_rule = rule( implementation = _impl, build_setting = config.int(flag = True), ... )
Membros
bool
BuildSetting config.bool(flag=False)Uma configuração de build do tipo booleano
Parâmetros
Parâmetro | Descrição |
---|---|
flag
|
bool;
o padrão é False Se essa configuração de compilação pode ser chamada ou não na linha de comando. |
exec
ExecTransitionFactory config.exec(exec_group=None)Cria uma transição de execução.
Parâmetros
Parâmetro | Descrição |
---|---|
exec_group
|
string; ou None
o padrão é None O nome do grupo de execução cuja plataforma de execução será usada pela transição. Se não for fornecida, esta transição de execução usará a plataforma de execução padrão do destino. |
int
BuildSetting config.int(flag=False)Uma configuração de build do tipo inteiro.
Parâmetros
Parâmetro | Descrição |
---|---|
flag
|
bool;
o padrão é False Se essa configuração de compilação pode ser chamada ou não na linha de comando. |
string
BuildSetting config.string(flag=False, allow_multiple=False)Uma configuração de build do tipo string
Parâmetros
Parâmetro | Descrição |
---|---|
flag
|
bool;
o padrão é False Se essa configuração de compilação pode ser chamada ou não na linha de comando. |
allow_multiple
|
bool;
o padrão é False Obsoleto. Use uma configuração string_list com repeatable = True . Se definida, essa sinalização poderá ser definida várias vezes na linha de comando. O valor da flag acessado nas transições e na função de implementação da configuração do build será uma lista de strings. A ordem de inserção e os valores repetidos são mantidos. Essa lista pode ser pós-processada na função de implementação da configuração do build se um comportamento diferente for desejado.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)Uma configuração de build do tipo lista de strings. Na linha de comando, transmita uma lista usando valores separados por vírgulas, como
--//my/setting=foo,bar
.
Parâmetros
Parâmetro | Descrição |
---|---|
flag
|
bool;
o padrão é False Se essa configuração de compilação pode ser chamada ou não na linha de comando. |
repeatable
|
bool;
o padrão é False Se definido, em vez de esperar um valor separado por vírgulas, essa sinalização poderá ser definida várias vezes na linha de comando, com cada valor individual tratado como uma única string para adicionar ao valor da lista. A ordem de inserção e os valores repetidos são mantidos. Essa lista pode ser pós-processada na função de implementação da configuração do build se um comportamento diferente for desejado. |
target
transition config.target()Cria uma transição de destino. Esta é uma transição de ambiente autônomo, que se destina ao caso em que um objeto de transição é necessário, mas não quer mudar nada. Equivalente a
cfg = "target"
em attr.label()
.