config

Informar um problema Ver fonte Nightly · 8.3 · 8.2 · 8.1 · 8.0 · 7.6

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 build (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),
    ...
  )

Membros

• bool
• exec
• int
• none
• string
• string_list
• target

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 Indica se essa configuração de build pode ser chamada 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 que a plataforma de execução desta transição vai usar. Se não for fornecida, essa transição de execução vai 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 Indica se essa configuração de build pode ser chamada na linha de comando.

nenhum

transition config.none()

Cria uma transição que remove toda a configuração, cancelando a definição de todas as flags. Destinado ao caso em que uma dependência é apenas de dados e não contém código que precise ser criado, mas deve ser analisado apenas uma vez.

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 Indica se essa configuração de build pode ser chamada na linha de comando.
allow_multiple	bool; o padrão é False Obsoleto. Use uma configuração string_list com repeatable = True. Se definido, essa flag poderá ser definida várias vezes na linha de comando. O valor da flag acessada nas transições e na função de implementação da configuração de 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 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 um valor separado por vírgulas, como --//my/setting=foo,bar.

Parâmetros

Parâmetro	Descrição
flag	bool; o padrão é False Indica se essa configuração de build pode ser chamada na linha de comando.
repeatable	bool; o padrão é False Se definido, em vez de esperar um valor separado por vírgulas, essa flag pode ser definida várias vezes na linha de comando, com cada valor individual tratado como uma única string a ser adicionada 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 de build se um comportamento diferente for desejado.

target

transition config.target()

Cria uma transição de destino. Essa é uma transição nula destinada ao caso em que um objeto de transição é necessário, mas não se quer mudar nada. Equivalente a cfg = "target" em attr.label().