config

Reportar um problema Ver código-fonte Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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.

Por exemplo, a regra a seguir é marcada como uma configuração de build ao definir o parâmetro build_setting da função rule(). Especificamente, é uma configuração de build do tipo int e é um flag, o que significa que essa configuração de build pode ser chamada na linha de comando.

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

bool

BuildSetting config.bool(flag=False)

Uma configuração de build do tipo booleano

Parâmetros

Parâmetro	Descrição
`flag`	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`	default é `False` Indica se essa configuração de build pode ser chamada 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 default é False
Indica se essa configuração de build pode ser chamada na linha de comando.

allow_multiple O padrão é False
Status de descontinuado. Use uma configuração string_list com repeatable = True. Se definida, essa sinalização pode ser definida várias vezes na linha de comando. O valor da flag, conforme 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 processada após a função de implementação de configurações de 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 o padrão é False
Se essa configuração de compilação pode ser chamada ou não na linha de comando.

repeatable o padrão é False
Se definido, em vez de esperar um valor separado por vírgulas, essa sinalização pode 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 processada posteriormente na função de implementação de configurações de build se um comportamento diferente for desejado.