attrs
dari rule()
dan aspect()
.Lihat halaman Aturan untuk informasi selengkapnya tentang menentukan dan menggunakan atribut.
Anggota
- bool
- int
- int_list
- label
- label_keyed_string_dict
- label_list
- output
- output_list
- string
- string_dict
- string_list
- string_list_dict
bool
Attribute attr.bool(default=False, doc='', mandatory=False)Membuat skema untuk atribut boolean.
Parameter
Parameter | Deskripsi |
---|---|
default
|
default = False Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
int
Attribute attr.int(default=0, doc='', mandatory=False, values=[])Membuat skema untuk atribut bilangan bulat. Nilai harus dalam rentang 32-bit yang ditandai.
Parameter
Parameter | Deskripsi |
---|---|
default
|
default = 0 Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
values
|
sequence of ints ;
default = []Daftar nilai yang diizinkan untuk atribut. Error terjadi jika ada nilai lain yang diberikan. |
int_list
Attribute attr.int_list(mandatory=False, allow_empty=True, *, default=[], doc='')Membuat skema untuk atribut daftar bilangan bulat. Setiap elemen harus berada dalam rentang 32-bit yang ditandai.
Parameter
Parameter | Deskripsi |
---|---|
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
default
|
sequence of ints ;
default = []Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
label
Attribute attr.label(default=None, doc='', executable=False, allow_files=None, allow_single_file=None, mandatory=False, providers=[], allow_rules=None, cfg=None, aspects=[])
Membuat skema untuk atribut label. Ini adalah atribut dependensi.
Atribut ini berisi nilai Label
yang unik. Jika string diberikan sebagai pengganti Label
, string tersebut akan dikonversi menggunakan konstruktor label. Bagian relatif dari jalur label, termasuk repositori (yang mungkin diganti namanya), diselesaikan sehubungan dengan paket target yang dibuat instance-nya.
Pada waktu analisis (dalam fungsi penerapan aturan), saat mengambil nilai atribut dari ctx.attr
, label akan diganti dengan Target
yang sesuai. Ini memungkinkan Anda mengakses penyedia dependensi target saat ini.
Selain file sumber biasa, atribut semacam ini sering digunakan untuk merujuk pada alat -- misalnya, compiler. Alat tersebut dianggap sebagai dependensi, seperti file sumber. Agar pengguna tidak perlu menentukan label alat setiap kali mereka menggunakan aturan di file BUILD, Anda dapat melakukan hard code pada label alat kanonis sebagai nilai default
atribut ini. Jika Anda juga ingin mencegah pengguna mengganti nilai default ini, Anda dapat membuat atribut menjadi pribadi dengan memberinya nama yang dimulai dengan garis bawah. Lihat halaman Aturan untuk informasi lebih lanjut.
Parameter
Parameter | Deskripsi |
---|---|
default
|
Label; or string; or LateBoundDefault; or NativeComputedDefault; or function; or None ;
default = NoneNilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan.Gunakan string atau fungsi Label untuk menentukan nilai default, misalnya, attr.label(default = "//a:b") .
|
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
executable
|
default = False True jika dependensi harus dapat dieksekusi. Artinya, label harus mengacu pada file yang dapat dieksekusi, atau aturan yang menghasilkan file yang dapat dieksekusi. Akses label dengan ctx.executable.<attribute_name> .
|
allow_files
|
bool; or sequence of strings; or None ;
default = Tidak adaApakah target File diizinkan. Dapat berupa True , False (default), atau daftar ekstensi file yang diizinkan (misalnya, [".cc", ".cpp"] ).
|
allow_single_file
|
default = None Mirip dengan allow_files , dengan batasan bahwa label harus sesuai dengan satu File. Akses melalui ctx.file.<attribute_name> .
|
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
providers
|
default = [] Penyedia yang harus diberikan oleh dependensi yang muncul dalam atribut ini. Format argumen ini adalah daftar daftar penyedia -- objek |
allow_rules
|
sequence of strings; or None ;
default = Tidak adaTarget aturan mana (nama class) yang diizinkan. Ini tidak digunakan lagi (disimpan hanya untuk kompatibilitas), sebagai gantinya gunakan penyedia. |
cfg
|
default = Tidak ada Konfigurasi atribut. Parameter ini dapat berupa "exec" , yang menunjukkan bahwa dependensi dibuat untuk execution platform , atau "target" , yang menunjukkan bahwa dependensi dibuat untuk target platform . Contoh umum perbedaannya adalah saat membuat aplikasi seluler, dengan target platform adalah Android atau iOS , sedangkan execution platform adalah Linux , macOS , atau Windows . Parameter ini diperlukan jika executable disetel ke Benar (True) untuk mencegah pembuatan alat host secara tidak sengaja dalam konfigurasi target. "target" tidak memiliki efek semantik, jadi jangan tetapkan jika executable bernilai Salah kecuali jika hal ini benar-benar membantu memperjelas maksud Anda.
|
aspects
|
sequence of Aspects ;
default = []Aspek yang harus diterapkan ke dependensi atau dependensi yang ditentukan oleh atribut ini. |
label_keyed_string_dict
Attribute attr.label_keyed_string_dict(allow_empty=True, *, default={}, doc='', allow_files=None, allow_rules=None, providers=[], flags=[], mandatory=False, cfg=None, aspects=[])
Membuat skema untuk atribut yang menyimpan kamus, dengan kunci sebagai label dan nilainya sebagai string. Ini adalah atribut dependensi.
Atribut ini berisi nilai Label
yang unik. Jika string diberikan sebagai pengganti Label
, string tersebut akan dikonversi menggunakan konstruktor label. Bagian relatif dari jalur label, termasuk repositori (yang mungkin diganti namanya), diselesaikan sehubungan dengan paket target yang dibuat instance-nya.
Pada waktu analisis (dalam fungsi penerapan aturan), saat mengambil nilai atribut dari ctx.attr
, label akan diganti dengan Target
yang sesuai. Ini memungkinkan Anda mengakses penyedia dependensi target saat ini.
Parameter
Parameter | Deskripsi |
---|---|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
default
|
dict; or function ;
default = {}Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan.Gunakan string atau fungsi Label untuk menentukan nilai default, misalnya, attr.label_keyed_string_dict(default = {"//a:b": "value", "//a:c": "string"}) .
|
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
allow_files
|
bool; or sequence of strings; or None ;
default = Tidak adaApakah target File diizinkan. Dapat berupa True , False (default), atau daftar ekstensi file yang diizinkan (misalnya, [".cc", ".cpp"] ).
|
allow_rules
|
sequence of strings; or None ;
default = Tidak adaTarget aturan mana (nama class) yang diizinkan. Ini tidak digunakan lagi (disimpan hanya untuk kompatibilitas), sebagai gantinya gunakan penyedia. |
providers
|
default = [] Penyedia yang harus diberikan oleh dependensi yang muncul dalam atribut ini. Format argumen ini adalah daftar daftar penyedia -- objek |
flags
|
sequence of strings ;
default = []Tidak digunakan lagi, akan dihapus. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
cfg
|
default = Tidak ada Konfigurasi atribut. Parameter ini dapat berupa "exec" , yang menunjukkan bahwa dependensi dibuat untuk execution platform , atau "target" , yang menunjukkan bahwa dependensi dibuat untuk target platform . Contoh umum perbedaannya adalah saat membuat aplikasi seluler, dengan target platform adalah Android atau iOS , sedangkan execution platform adalah Linux , macOS , atau Windows .
|
aspects
|
sequence of Aspects ;
default = []Aspek yang harus diterapkan ke dependensi atau dependensi yang ditentukan oleh atribut ini. |
label_list
Attribute attr.label_list(allow_empty=True, *, default=[], doc='', allow_files=None, allow_rules=None, providers=[], flags=[], mandatory=False, cfg=None, aspects=[])
Membuat skema untuk atribut daftar label. Ini adalah atribut dependensi.
Atribut ini berisi nilai Label
yang unik. Jika string diberikan sebagai pengganti Label
, string tersebut akan dikonversi menggunakan konstruktor label. Bagian relatif dari jalur label, termasuk repositori (yang mungkin diganti namanya), diselesaikan sehubungan dengan paket target yang dibuat instance-nya.
Pada waktu analisis (dalam fungsi penerapan aturan), saat mengambil nilai atribut dari ctx.attr
, label akan diganti dengan Target
yang sesuai. Ini memungkinkan Anda mengakses penyedia dependensi target saat ini.
Parameter
Parameter | Deskripsi |
---|---|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
default
|
sequence of Labels; or function ;
default = []Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan.Gunakan string atau fungsi Label untuk menentukan nilai default, misalnya, attr.label_list(default = ["//a:b", "//a:c"]) .
|
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
allow_files
|
bool; or sequence of strings; or None ;
default = Tidak adaApakah target File diizinkan. Dapat berupa True , False (default), atau daftar ekstensi file yang diizinkan (misalnya, [".cc", ".cpp"] ).
|
allow_rules
|
sequence of strings; or None ;
default = Tidak adaTarget aturan mana (nama class) yang diizinkan. Ini tidak digunakan lagi (disimpan hanya untuk kompatibilitas), sebagai gantinya gunakan penyedia. |
providers
|
default = [] Penyedia yang harus diberikan oleh dependensi yang muncul dalam atribut ini. Format argumen ini adalah daftar daftar penyedia -- objek |
flags
|
sequence of strings ;
default = []Tidak digunakan lagi, akan dihapus. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
cfg
|
default = Tidak ada Konfigurasi atribut. Parameter ini dapat berupa "exec" , yang menunjukkan bahwa dependensi dibuat untuk execution platform , atau "target" , yang menunjukkan bahwa dependensi dibuat untuk target platform . Contoh umum perbedaannya adalah saat membuat aplikasi seluler, dengan target platform adalah Android atau iOS , sedangkan execution platform adalah Linux , macOS , atau Windows .
|
aspects
|
sequence of Aspects ;
default = []Aspek yang harus diterapkan ke dependensi atau dependensi yang ditentukan oleh atribut ini. |
hasil
Attribute attr.output(doc='', mandatory=False)
Membuat skema untuk atribut output (label).
Atribut ini berisi nilai Label
yang unik. Jika string diberikan sebagai pengganti Label
, string tersebut akan dikonversi menggunakan konstruktor label. Bagian relatif dari jalur label, termasuk repositori (yang mungkin diganti namanya), diselesaikan sehubungan dengan paket target yang dibuat instance-nya.
Pada waktu analisis, File
yang sesuai dapat diambil menggunakan ctx.outputs
.
Parameter
Parameter | Deskripsi |
---|---|
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
output_list
Attribute attr.output_list(allow_empty=True, *, doc='', mandatory=False)Membuat skema untuk atribut list-of-output.
Atribut ini berisi nilai Label
yang unik. Jika string diberikan sebagai pengganti Label
, string tersebut akan dikonversi menggunakan konstruktor label. Bagian relatif dari jalur label, termasuk repositori (yang mungkin diganti namanya), diselesaikan sehubungan dengan paket target yang dibuat instance-nya.
Pada waktu analisis, File
yang sesuai dapat diambil menggunakan ctx.outputs
.
Parameter
Parameter | Deskripsi |
---|---|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
string
Attribute attr.string(default='', doc='', mandatory=False, values=[])Membuat skema untuk atribut string.
Parameter
Parameter | Deskripsi |
---|---|
default
|
string; or NativeComputedDefault ;
default = ''Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
values
|
sequence of strings ;
default = []Daftar nilai yang diizinkan untuk atribut. Error terjadi jika ada nilai lain yang diberikan. |
string_dict
Attribute attr.string_dict(allow_empty=True, *, default={}, doc='', mandatory=False)Membuat skema untuk atribut yang menyimpan kamus, dengan kunci dan nilai berupa string.
Parameter
Parameter | Deskripsi |
---|---|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
default
|
default = {} Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
string_list
Attribute attr.string_list(mandatory=False, allow_empty=True, *, default=[], doc='')Membuat skema untuk atribut list-of-string.
Parameter
Parameter | Deskripsi |
---|---|
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
default
|
sequence of strings; or NativeComputedDefault ;
default = []Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
string_list_dict
Attribute attr.string_list_dict(allow_empty=True, *, default={}, doc='', mandatory=False)Membuat skema untuk atribut yang menyimpan kamus, dengan kunci adalah string dan nilainya adalah daftar string.
Parameter
Parameter | Deskripsi |
---|---|
allow_empty
|
default = True Benar jika atribut boleh kosong. |
default
|
default = {} Nilai default yang akan digunakan jika tidak ada nilai yang diberikan untuk atribut ini saat membuat instance aturan. |
doc
|
default = '' Deskripsi atribut yang dapat diekstrak dengan alat pembuat dokumentasi. |
mandatory
|
default = False Jika benar, nilai harus ditentukan secara eksplisit (meskipun memiliki default ).
|