Ini adalah modul tingkat atas untuk membuat transisi konfigurasi dan deskripsi setelan build yang menjelaskan jenis setelan build (jika ada) yang merupakan aturan.
contoh: 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
|
bool;
default 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
|
bool;
default adalah False Apakah setelan build ini dapat dipanggil di command line atau tidak. |
tidak ada
transition config.none()Membuat transisi yang menghapus semua konfigurasi, menghapus semua tanda. Dimaksudkan untuk kasus saat dependensi hanya berisi data dan tidak berisi kode yang perlu di-build, tetapi hanya boleh dianalisis satu kali.
string
BuildSetting config.string(flag=False, allow_multiple=False)Setelan build berjenis string
Parameter
Parameter | Deskripsi |
---|---|
flag
|
bool;
default adalah False Apakah setelan build ini dapat dipanggil di command line atau tidak. |
allow_multiple
|
bool;
default adalah False Tidak digunakan lagi, gunakan setelan string_list dengan repeatable = True . Jika ditetapkan, tanda ini diizinkan untuk ditetapkan beberapa kali di 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 berjenis daftar string. Di command line, teruskan daftar menggunakan nilai yang dipisahkan koma seperti
--//my/setting=foo,bar
.
Parameter
Parameter | Deskripsi |
---|---|
flag
|
bool;
default adalah False Apakah setelan build ini dapat dipanggil di command line atau tidak. |
repeatable
|
bool;
default adalah False Jika ditetapkan, flag ini diizinkan untuk ditetapkan beberapa kali di command line, bukan mengharapkan nilai yang dipisahkan koma, dengan setiap nilai diperlakukan sebagai satu string untuk ditambahkan ke nilai daftar. Urutan pemasangan iklan dan nilai berulang dipertahankan. Daftar ini dapat diproses pasca-pemrosesan dalam fungsi implementasi setelan build jika perilaku yang berbeda diinginkan. |
target
transition config.target()Membuat transisi target. Ini adalah transisi tanpa operasi yang ditujukan untuk kasus saat objek transisi diperlukan, tetapi tidak ingin benar-benar mengubah apa pun. Setara dengan
cfg = "target"
di attr.label()
.