native

Modul bawaan untuk mendukung aturan native dan fungsi bantuan paket lainnya. Semua aturan native muncul sebagai fungsi dalam modul ini, misalnya native.cc_library. Perhatikan bahwa modul native hanya tersedia dalam fase pemuatan (yaitu untuk makro, bukan untuk penerapan aturan). Atribut akan mengabaikan nilai None, dan memperlakukannya seolah-olah atribut tidak ditetapkan.
Fungsi berikut juga tersedia:

Anggota

• existing_rule
• existing_rules
• exports_files
• glob
• module_name
• module_version
• package_group
• package_name
• package_relative_label
• repo_name
• repository_name
• subpaket

existing_rule

unknown native.existing_rule(name)

Di sini, objek seperti dict yang tidak dapat diubah berarti objek x yang tidak dapat diubah secara mendalam yang mendukung iterasi seperti dict, len(x), name in x, x[name], x.get(name), x.items(), x.keys(), dan x.values().

Hasilnya berisi entri untuk setiap atribut, dengan pengecualian atribut pribadi (yang namanya tidak diawali dengan huruf) dan beberapa jenis atribut lama yang tidak dapat direpresentasikan. Selain itu, kamus berisi entri untuk name dan kind instance aturan (misalnya, 'cc_binary').

Nilai hasil mewakili nilai atribut sebagai berikut:

• Atribut jenis str, int, dan bool direpresentasikan apa adanya.
• Label dikonversi menjadi string formulir ':foo' untuk target dalam paket yang sama atau '//pkg:name' untuk target dalam paket yang berbeda.
• Daftar direpresentasikan sebagai tuple, dan kamus dikonversi menjadi kamus baru yang dapat diubah. Elemennya dikonversi secara rekursif dengan cara yang sama.
• Nilai select ditampilkan dengan kontennya yang diubah seperti yang dijelaskan di atas.
• Atribut yang tidak memiliki nilai yang ditentukan selama pembuatan instance aturan dan nilai defaultnya dihitung akan dikecualikan dari hasil. (Default yang dihitung tidak dapat dihitung hingga fase analisis.).

Jika memungkinkan, gunakan fungsi ini hanya dalam fungsi implementasi makro simbolis finalisasi aturan. Penggunaan fungsi ini dalam konteks lain tidak direkomendasikan, dan akan dinonaktifkan dalam rilis Bazel mendatang; hal ini membuat file BUILD rapuh dan bergantung pada urutan. Selain itu, perhatikan bahwa konversi ini sedikit berbeda dari dua konversi nilai atribut aturan lainnya dari bentuk internal ke Starlark: satu digunakan oleh default yang dihitung, yang lainnya digunakan oleh ctx.attr.foo.

Parameter

existing_rules

unknown native.existing_rules()

Di sini, objek seperti dict yang tidak dapat diubah berarti objek x yang tidak dapat diubah secara mendalam yang mendukung iterasi seperti dict, len(x), name in x, x[name], x.get(name), x.items(), x.keys(), dan x.values().

Jika memungkinkan, gunakan fungsi ini hanya dalam fungsi implementasi makro simbolis finalisasi aturan. Penggunaan fungsi ini dalam konteks lain tidak direkomendasikan dan akan dinonaktifkan dalam rilis Bazel mendatang; fungsi ini membuat file BUILD rapuh dan bergantung pada urutan.

exports_files

None native.exports_files(srcs, visibility=None, licenses=None)

Parameter

glob

sequence native.glob(include=[], exclude=[], exclude_directories=1, allow_empty=unbound)

• Mencocokkan setidaknya satu pola di include.
• Tidak cocok dengan pola apa pun di exclude ([] default).

Parameter

module_name

string native.module_name()

module_version

string native.module_version()

package_group

None native.package_group(name, packages=[], includes=[])

Parameter

package_name

string native.package_name()

package_relative_label

Label native.package_relative_label(input)

Fungsi ini hanya dapat dipanggil saat mengevaluasi file BUILD dan makro yang dipanggil secara langsung atau tidak langsung; fungsi ini tidak boleh dipanggil dalam (misalnya) fungsi penerapan aturan.

Hasil dari fungsi ini adalah nilai Label yang sama seperti yang akan dihasilkan dengan meneruskan string yang diberikan ke atribut bernilai label dari target yang dideklarasikan dalam file BUILD.

Catatan penggunaan: Perbedaan antara fungsi ini dan Label() adalah Label() menggunakan konteks paket file .bzl yang memanggilnya, bukan paket file BUILD. Gunakan Label() saat Anda perlu merujuk ke target tetap yang di-hardcode ke dalam makro, seperti compiler. Gunakan package_relative_label() saat Anda perlu menormalisasi string label yang disediakan oleh file BUILD ke objek Label. (Tidak ada cara untuk mengonversi string menjadi Label dalam konteks paket selain file BUILD atau file .bzl panggilan. Oleh karena itu, makro luar harus selalu memilih untuk meneruskan objek Label ke makro dalam, bukan string label.)

Parameter

repo_name

string native.repo_name()

repository_name

string native.repository_name()

Nama kanonis repositori yang berisi paket yang saat ini sedang dievaluasi, dengan awalan tanda @ (@) tunggal. Misalnya, dalam paket yang dipanggil oleh stanza WORKSPACE local_repository(name='local', path=...), ini akan ditetapkan ke @local. Dalam paket di repositori utama, nilai ini akan ditetapkan ke @.

sub-paket

sequence native.subpackages(include, exclude=[], allow_empty=False)

Parameter