Global

Anggota

• semua
• analisis_pengujian
• analisis_pengujian_transisi
• apa pun
• arsip_ganti
• aspek
• bazel_dep
• pengikat
• bool
• kolom_konfigurasi
• depset
• dikte
• dir
• enumerasi
• grup_exec
• gagal
• float
• getattr
• git_Override
• hasattr
• hash
• int
• Len
• list
• local_path_Override
• maks
• mnt
• modul
• ekstensi_modul
• multi_versi_ganti
• print
• penyedia
• rentang
• register_eksekusi_platforms()
• register_eksekusi_platforms()
• register_toolchains()
• register_toolchains()
• repository_rule(implementation, attrs, lokal, environ, konfigurasikan, remotable, doc)
• repository_rule(implementation, attrs, lokal, environ, konfigurasikan, remotable, doc)
• repr
• dibalik
• aturan
• pilih
• single_version_Override
• diurutkan
• str
• class_tag
• tuple
• jenis
• use_extension
• use_repo
• visibilitas
• ruang kerja
• zip

all

bool all(elements)

all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

Parameter

analytics_test

None analysis_test(name, implementation, attrs=None, fragments=[], toolchains=[], attr_values={})

Jumlah dependensi transitif pengujian dibatasi. Batas dikontrol oleh flag --analysis_testing_deps_limit.

Parameter

Analysis_test_transition

transition analysis_test_transition(settings)

Membuat transisi konfigurasi yang akan diterapkan pada dependensi aturan pengujian analisis. Transisi ini hanya dapat diterapkan untuk atribut aturan dengan analysis_test = True. Aturan tersebut memiliki batasan kemampuan (misalnya, ukuran hierarki dependensinya dibatasi), sehingga transisi yang dibuat menggunakan fungsi ini memiliki cakupan potensial yang terbatas jika dibandingkan dengan transisi yang dibuat menggunakan transisi.

Fungsi ini terutama dirancang untuk memfasilitasi library inti Framework Pengujian Analisis. Lihat dokumentasinya (atau penerapannya) untuk mengetahui praktik terbaik.

Parameter

Sembarang

bool any(elements)

any([-1, 0, 1]) == True
any([False, 0, ""]) == False

Parameter

arsip_ganti

None archive_override(module_name, urls, integrity='', strip_prefix='', patches=[], patch_strip=0)

Parameter

aspek

Aspect aspect(implementation, attr_aspects=[], attrs=None, required_providers=[], required_aspect_providers=[], provides=[], requires=[], fragments=[], host_fragments=[], toolchains=[], incompatible_use_toolchain_transition=False, doc='', *, apply_to_generating_rules=False, exec_compatible_with=[], exec_groups=None)

Parameter

Bazel_dep

None bazel_dep(name, version='', repo_name='', dev_dependency=False)

Parameter

mengikat

None bind(name, actual=None)

Peringatan: penggunaan bind() tidak direkomendasikan. Lihat Mempertimbangkan untuk menghapus binding guna mengetahui diskusi panjang tentang masalah dan alternatifnya.

Memberi alias target dalam paket //external.

Parameter

bool

bool bool(x=False)

Parameter

kolom_konfigurasi

LateBoundDefault configuration_field(fragment, name)

Contoh penggunaan:

Menentukan atribut aturan:

'_foo': attr.label(default=configuration_field(fragment='java', name='toolchain'))

Mengakses di penerapan aturan:

  def _rule_impl(ctx):
    foo_info = ctx.attr._foo
    ...

Parameter

depset

depset depset(direct=None, order="default", *, transitive=None)

Semua elemen (langsung dan tidak langsung) dari depset harus memiliki jenis yang sama, seperti yang diperoleh oleh ekspresi type(x).

Karena set berbasis hash digunakan untuk menghilangkan duplikat selama iterasi, semua elemen depset harus dapat di-hash. Namun, invarian ini saat ini tidak diperiksa secara konsisten di semua konstruktor. Gunakan tanda --incompatible_always_check_depset_elements untuk memungkinkan pemeriksaan yang konsisten; ini akan menjadi perilaku default dalam rilis mendatang; lihat Masalah 10313.

Selain itu, elemen harus tidak dapat diubah saat ini, meskipun pembatasan ini akan dilonggarkan di masa mendatang.

Urutan depset yang dibuat harus kompatibel dengan urutan depset transitive-nya. Pesanan "default" kompatibel dengan pesanan lainnya, semua pesanan lainnya hanya kompatibel dengan pesanan itu sendiri.

Perhatikan kompatibilitas mundur/maju. Fungsi ini saat ini menerima parameter items posisi. API ini sudah tidak digunakan lagi dan akan dihapus di masa mendatang, dan direct akan dihapus sebagai parameter posisi tunggal dari fungsi depset. Dengan demikian, kedua panggilan berikut setara dan tidak akan berakhir lagi:

depset(['a', 'b'], transitive = [...])
depset(direct = ['a', 'b'], transitive = [...])

Parameter

Dikte

dict dict(pairs=[], **kwargs)

Parameter

dir

list dir(x)

Parameter

enumerasi

list enumerate(list, start=0)

enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

Parameter

grup_exec

exec_group exec_group(toolchains=[], exec_compatible_with=[], copy_from_rule=False)

Parameter

fail

None fail(msg=None, attr=None, *args)

Parameter

float

float float(x=unbound)

• Jika x sudah mengambang, float tidak akan menampilkan perubahan.
• Jika x adalah bool, float akan menampilkan 1.0 untuk True dan 0.0 untuk False.
• Jika x berupa int, float akan menampilkan nilai floating-point terbatas yang terdekat ke x, atau error jika magnitudonya terlalu besar.
• Jika x adalah string, string tersebut harus berupa literal floating point yang valid, atau sama dengan (abaikan huruf besar/kecil) dengan NaN, Inf, atau Infinity, secara opsional diawali dengan tanda + atau -.

Parameter

getattr

unknown getattr(x, name, default=unbound)

getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

Parameter

git_ganti

None git_override(module_name, remote, commit='', patches=[], patch_strip=0)

Parameter

Hasattr

bool hasattr(x, name)

hasattr(ctx.attr, "myattr")

Parameter

hash

int hash(value)

s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]

Parameter

int

int int(x, base=unbound)

• Jika x sudah int, int tidak akan menampilkan perubahan tersebut.
• Jika x adalah bool, int akan menampilkan 1 untuk Benar dan 0 untuk Salah.
• Jika x adalah string, format tersebut harus <sign><prefix><digits>. <sign> adalah "+", "-", atau kosong (diinterpretasikan sebagai positif). <digits> adalah urutan angka dari 0 hingga base - 1, dengan huruf a-z (atau yang setara, A-Z) digunakan sebagai angka untuk 10-35. Jika base adalah 2/8/16, <prefix> bersifat opsional dan mungkin masing-masing 0b/0o/0x (atau setara, 0B/0O/0X); jika base adalah nilai lain selain basis ini atau nilai khusus 0, awalan harus kosong. Dalam kasus di mana base adalah 0, string ditafsirkan sebagai literal bilangan bulat, dalam arti bahwa salah satu basis 2/8/10/16 dipilih bergantung pada awalan mana yang digunakan. Jika base adalah 0, tidak ada awalan yang digunakan, dan ada lebih dari satu digit, digit utama tidak boleh 0; ini untuk menghindari kebingungan antara oktal dan desimal. Besarnya angka yang diwakili oleh string harus berada dalam rentang yang diizinkan untuk jenis int.
• Jika x adalah float, int akan menampilkan nilai bilangan bulat float, yang dibulatkan ke nol. Ini dianggap error jika x tidak terbatas (NaN atau tidak terbatas).

Contoh:

int("123") == 123
int("-123") == -123
int("+123") == 123
int("FF", 16) == 255
int("0xFF", 16) == 255
int("10", 0) == 10
int("-0x10", 0) == -16
int("-0x10", 0) == -16
int("123.456") == 123

Parameter

Len

int len(x)

Parameter

list

list list(x=[])

list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

Parameter

local_path_Override

None local_path_override(module_name, path)

Parameter

maks

unknown max(*args)

max(2, 5, 4) == 5
max([5, 6, 3]) == 6

Parameter

mnt

unknown min(*args)

min(2, 5, 4) == 2
min([5, 6, 3]) == 3

Parameter

modul

None module(name='', version='', compatibility_level=0, execution_platforms_to_register=[], toolchains_to_register=[])

Seharusnya dipanggil paling banyak satu kali. Ini dapat dihilangkan hanya jika modul ini adalah modul root (seperti pada, jika tidak akan bergantung pada modul lain).

Parameter

modul_ekstensi

unknown module_extension(implementation, *, tag_classes={}, doc='')

Parameter

versi_penggantian beberapa

None multiple_version_override(module_name, versions, registry='')

Parameter

cetak

None print(sep=" ", *args)

Menggunakan print dalam kode produksi tidak disarankan karena spam yang dibuat untuk pengguna. Untuk penghentian penggunaan, pilih error yang berat menggunakan fail() jika memungkinkan.

Parameter

penyedia

unknown provider(doc='', *, fields=None, init=None)

MyInfo = provider()
...
def _my_library_impl(ctx):
    ...
    my_info = MyInfo(x = 2, y = 3)
    # my_info.x == 2
    # my_info.y == 3
    ...

Lihat Aturan (Penyedia) untuk panduan komprehensif tentang cara menggunakan penyedia.

Menampilkan nilai callable Provider jika init tidak ditentukan.

Jika init ditentukan, akan menampilkan tuple 2 elemen: nilai callable Provider dan nilai callable konstruktor. Lihat Aturan (Inisialisasi kustom penyedia kustom) dan diskusi tentang parameter init di bawah untuk mengetahui detailnya.

Parameter

MyInfo = provider()
m = MyInfo(foo = 1)

MyInfo, _new_myinfo = provider(init = ...)

rentang

sequence range(start_or_stop, stop_or_none=None, step=1)

range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

Parameter

register_eksekusi_platforms()

None register_execution_platforms(*platform_labels)

Parameter

register_eksekusi_platforms()

None register_execution_platforms(*platform_labels)

Parameter

register_toolchains()

None register_toolchains(*toolchain_labels)

Parameter

register_toolchains()

None register_toolchains(*toolchain_labels)

Parameter

repositori_rule(implementation, attrs, lokal, environ, konfigurasikan, remotable, doc)

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc='')

Parameter

repositori_rule(implementation, attrs, lokal, environ, konfigurasikan, remotable, doc)

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc='')

Parameter

repr

string repr(x)

repr("ab") == '"ab"'

Parameter

dibalik

list reversed(sequence)

reversed([3, 5, 4]) == [4, 5, 3]

Parameter

aturan

callable rule(implementation, test=False, attrs=None, outputs=None, executable=False, output_to_genfiles=False, fragments=[], host_fragments=[], _skylark_testable=False, toolchains=[], incompatible_use_toolchain_transition=False, doc='', *, provides=[], exec_compatible_with=[], analysis_test=False, build_setting=None, cfg=None, exec_groups=None, compile_one_filetype=None, name=None)

Aturan harus ditetapkan ke variabel global dalam file .bzl; nama variabel global adalah nama aturan.

Aturan pengujian harus memiliki nama yang diakhiri dengan _test, sementara semua aturan lainnya tidak boleh memiliki akhiran ini. (Pembatasan ini hanya berlaku pada aturan, bukan targetnya.)

Parameter

pilih

unknown select(x, no_match_error='')

Parameter

versi_penggantian tunggal

None single_version_override(module_name, version='', registry='', patches=[], patch_strip=0)

Parameter

diurutkan

list sorted(iterable, *, key=None, reverse=False)

sorted([3, 5, 4]) == [3, 4, 5]

Parameter

Str

string str(x)

str("ab") == "ab"
str(8) == "8"

Parameter

tag_class

tag_class tag_class(attrs={}, *, doc='')

Parameter

tuple

tuple tuple(x=())

tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

Parameter

jenis

string type(x)

type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"

if type(x) == type([]):  # if x is a list

Parameter

use_extension [ekstensi_penggunaan]

module_extension_proxy use_extension(extension_bzl_file, extension_name, *, dev_dependency=False)

Parameter

use_repo

None use_repo(extension_proxy, *args, **kwargs)

Parameter

visibilitas

None visibility(value)

Menetapkan visibilitas bzl untuk modul .bzl yang saat ini diinisialisasi.

Visibilitas bzl modul .bzl (jangan samakan dengan visibilitas target) mengatur apakah load() dari .bzl tersebut diizinkan dari dalam file BUILD dan .bzl paket tertentu. Nilai yang diizinkan mencakup:

• "public" (default): .bzl dapat dimuat di mana saja.
• "private": .bzl hanya dapat dimuat oleh file dalam paket yang sama (sub-paket dikecualikan).
• daftar spesifikasi paket (misalnya ["//pkg1","//pkg2/subpkg/..."]): .bzl dapat dimuat oleh file dalam paket apa pun yang cocok dengan salah satu spesifikasi yang tercantum. Spesifikasi paket dapat berupa jalur paket, atau jalur paket dengan "/..." di akhir untuk menyertakan semua sub-paket; pola yang diabaikan saat ini tidak didukung. Semua spesifikasi paket berada dalam repositori saat ini; sintaksis "@" tidak diizinkan.

Biasanya, visibility() dipanggil di bagian atas file .bzl, tepat setelah pernyataan load(). (Menerapkan gaya deklarasi ini nanti dalam file atau dalam metode helper adalah hal yang buruk.) Ini tidak boleh dipanggil lebih dari sekali per .bzl, atau setelah kode level teratas .bzl' selesai dijalankan.

Perhatikan bahwa modul .bzl yang memiliki visibilitas bzl publik tidak selalu berarti bahwa target file yang sesuai memiliki visibilitas publik. Artinya, Anda dapat load() file .bzl tanpa dapat bergantung padanya di filegroup atau target lainnya.

Parameter

ruang kerja

None workspace(name)

Fungsi ini hanya dapat digunakan dalam file WORKSPACE dan harus dideklarasikan sebelum semua fungsi lain dalam file WORKSPACE. Setiap file WORKSPACE harus memiliki fungsi workspace.

Menetapkan nama untuk ruang kerja ini. Nama Workspace harus berupa deskripsi project bergaya paket Java, yang menggunakan garis bawah sebagai pemisah, misalnya, github.com/bazelbuild/bazel harus menggunakan com_github_bazelbuild_bazel.

Nama ini digunakan untuk direktori tempat file runtime repositori disimpan. Misalnya, jika ada runfile foo/bar di repositori lokal dan file WORKSPACE berisi workspace(name = 'baz'), maka file run akan tersedia di bagian mytarget.runfiles/baz/foo/bar. Jika tidak ada nama ruang kerja yang ditentukan, runfile akan ditautkan ke bar.runfiles/foo/bar.

Nama aturan repositori jarak jauh harus berupa nama ruang kerja yang valid. Misalnya, Anda dapat memiliki maven_jar(name = 'foo'), tetapi bukan maven_jar(name = 'foo%bar'), karena Bazel akan mencoba menulis file WORKSPACE untuk maven_jar yang berisi workspace(name = 'foo%bar').

Parameter

zip

list zip(*args)

zip()  # == []
zip([1, 2])  # == [(1,), (2,)]
zip([1, 2], [3, 4])  # == [(1, 3), (2, 4)]
zip([1, 2], [3, 4, 5])  # == [(1, 3), (2, 4)]

Parameter