config

. 7.3 · 7.2 · 7.1 · 7.0 · 6.5

Ini adalah modul tingkat teratas untuk membuat transisi konfigurasi dan membuat deskriptor setelan yang menjelaskan jenis setelan build (jika ada) sebuah aturan.

misalnya: aturan berikut ditandai sebagai setelan build dengan menetapkan parameter build_setting dari fungsi rule(). Secara khusus, ini adalah setelan build jenis int dan merupakan flag yang berarti setelan build ini dapat dipanggil di command line.

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

Anggota

bool

BuildSetting config.bool(flag=False)

Setelan build berjenis bool

Parameter

Parameter Deskripsi
flag defaultnya adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.

exec

ExecTransitionFactory config.exec(exec_group=None)

Membuat transisi eksekusi.

Parameter

Parameter Deskripsi
exec_group string; atau None; default adalah None
Nama grup exec yang platform eksekusinya akan digunakan oleh transisi ini. Jika tidak disediakan, transisi eksekusi ini akan menggunakan platform eksekusi default target.

int

BuildSetting config.int(flag=False)

Setelan build berjenis bilangan bulat

Parameter

Parameter Deskripsi
flag defaultnya adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.

string

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

Setelan build berjenis string

Parameter

Parameter Deskripsi
flag defaultnya adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.
allow_multiple defaultnya adalah False
Tidak digunakan lagi, sebagai gantinya gunakan setelan string_list dengan repeatable = True. Jika disetel, tanda ini boleh disetel beberapa kali pada command line. Nilai tanda seperti yang diakses dalam transisi dan fungsi implementasi setelan build akan berupa daftar string. Perjanjian pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses kembali dalam fungsi penerapan setelan build jika menginginkan perilaku yang berbeda.

string_list

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

Setelan build berjenis daftar string. Pada command line, teruskan daftar menggunakan nilai yang dipisahkan koma seperti --//my/setting=foo,bar.

Parameter

Parameter Deskripsi
flag default adalah False
Apakah setelan build ini dapat dipanggil di command line atau tidak.
repeatable defaultnya adalah False
Jika ditetapkan, daripada mengharapkan nilai yang dipisahkan koma, flag ini diizinkan untuk disetel beberapa kali pada command line dengan setiap nilai diperlakukan sebagai string tunggal untuk ditambahkan ke nilai daftar. Pesanan pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses pasca-pemrosesan dalam fungsi implementasi setelan build jika perilaku yang berbeda diinginkan.