Ini adalah modul tingkat atas 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 dari 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
|
default adalah False Apakah setelan build ini dapat dipanggil atau tidak di command line. |
{i>exec<i}
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
|
default 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
|
default adalah False Apakah setelan build ini dapat dipanggil di command line atau tidak. |
allow_multiple
|
default adalah False Tidak digunakan lagi, 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. Urutan pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses pasca-pemrosesan dalam fungsi implementasi setelan build jika perilaku yang berbeda diinginkan.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)Setelan build bertipe 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 atau tidak di command line. |
repeatable
|
default adalah False Jika ditetapkan, bukan mengharapkan nilai yang dipisahkan koma, tanda ini boleh disetel beberapa kali pada command line dengan setiap nilai diperlakukan sebagai string tunggal untuk ditambahkan ke nilai daftar. Perjanjian pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses kembali dalam fungsi penerapan setelan build jika menginginkan perilaku yang berbeda. |