config

Laporkan masalah Lihat sumber Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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