config

Ini adalah modul tingkat atas untuk membuat transisi konfigurasi dan deskriptor 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 berjenis 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
• exec
• int
• none
• string
• string_list
• string_set
• target

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 exec 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.

none

transition config.none()

Membuat transisi yang menghapus semua konfigurasi, membatalkan setelan semua flag. Ditujukan untuk kasus ketika dependensi hanya berupa data dan tidak berisi kode yang perlu dibuat, tetapi hanya perlu dianalisis sekali.

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 sebagai gantinya. Jika ditetapkan, flag ini dapat ditetapkan beberapa kali di command line. Nilai flag seperti yang diakses dalam transisi dan fungsi penerapan setelan build akan berupa daftar string. Urutan penyisipan dan nilai berulang dipertahankan. Daftar ini dapat diproses pasca-pemrosesan dalam fungsi penerapan 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, bukan mengharapkan nilai yang dipisahkan koma, flag ini dapat ditetapkan beberapa kali di command line dengan setiap nilai individual diperlakukan sebagai satu string untuk ditambahkan ke nilai daftar. Urutan penyisipan dan nilai berulang dipertahankan. Daftar ini dapat diproses pasca-pemrosesan dalam fungsi penerapan setelan build jika perilaku yang berbeda diinginkan.

string_set

BuildSetting config.string_set(*, flag=False, repeatable=False)

Setelan build berjenis set string. Nilai setelan ini akan berupa kumpulan string di Starlark. Di command line, teruskan set menggunakan nilai yang dipisahkan koma seperti --//my/setting=foo,bar.

Tidak seperti string_list, urutan elemen tidak menjadi masalah dan hanya satu instance dari setiap elemen yang dipertahankan. Hal ini direkomendasikan daripada string_list untuk flag yang tidak memerlukan properti ini karena dapat meningkatkan performa build dengan menghindari konfigurasi yang tidak perlu.

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, bukan mengharapkan nilai yang dipisahkan koma, flag ini dapat ditetapkan beberapa kali di command line dengan setiap nilai individual diperlakukan sebagai satu string untuk ditambahkan ke nilai set. Hanya satu instance dari nilai berulang yang dipertahankan dan urutan penyisipan tidak menjadi masalah.

target

transition config.target()

Membuat transisi target. Ini adalah transisi no-op yang ditujukan untuk kasus ketika objek transisi diperlukan, tetapi tidak ingin mengubah apa pun. Setara dengan cfg = "target" di attr.label().