Global

Pelanggan

• semua
• analisis_pengujian_transisi
• apa pun
• arsip_ganti
• aspek
• bazel_dep
• pengikat
• bool
• kolom_konfigurasi
• depset
• dikte
• dir
• enumerasi
• grup_exec
• gagal
• float
• getattr
• git_ganti
• hasattr
• hash
• int
• kita
• list
• local_path_override
• maks
• mnt
• modul
• ekstensi_modul
• beberapa_versi_ganti
• print
• penyedia
• rentang
• register_eksekusi_platforms()
• register_eksekusi_platforms()
• register_ETags()
• register_ETags()
• repository_rule(penerapan, attr, lokal, lingkungan, konfigurasi, jarak jauh, dokumen)
• repository_rule(penerapan, attr, lokal, lingkungan, konfigurasi, jarak jauh, dokumen)
• PR
• terbalik
• aturan
• pilih
• ganti_versi_tunggal
• diurutkan
• str
• tag_class
• tuple
• jenis
• penggunaan_ekstensi
• penggunaan_repo
• visibilitas
• ruang kerja
• zip

all

bool all(elements)

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

Parameter

analisis_pengujian_transisi

transition analysis_test_transition(settings)

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

Fungsi ini dirancang terutama untuk memfasilitasi library inti Analysis Test Framework. 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_cmds=[], 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

baz_dep

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

Parameter

mengikat

None bind(name, actual=None)

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

Memberi target alias 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 dalam 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 menghapus duplikat selama iterasi, semua elemen depset harus dapat di-hash. Namun, invarian ini saat ini tidak diperiksa secara konsisten di semua konstruktor. Gunakan flag --incompatible_always_check_depset_elements untuk mengaktifkan pemeriksaan yang konsisten; ini akan menjadi perilaku default dalam rilis mendatang; lihat Masalah 10313.

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

Urutan depset yang dibuat harus kompatibel dengan urutan depset transitive. Pesanan "default" kompatibel dengan pesanan lain, semua pesanan lainnya hanya kompatibel dengan pesanan mereka sendiri.

Catatan tentang kompatibilitas mundur/maju. Fungsi ini saat ini menerima parameter items posisi. Metode ini tidak digunakan lagi dan akan dihapus pada masa mendatang, dan setelah dihapus, direct akan menjadi parameter posisi tunggal dari fungsi depset. Dengan demikian, kedua panggilan berikut bernilai setara dan dapat diandalkan di masa mendatang:

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

Parameter

Dikte

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

Parameter

kotor

list dir(x)

Parameter

menghitung

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 menjadi float, float akan menampilkannya tanpa perubahan.
• Jika x adalah bool, float akan menampilkan 1.0 untuk True dan 0.0 untuk False.
• Jika x adalah int, float akan menampilkan nilai floating point terbatas 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, (opsional) dengan tanda + atau -.

Parameter

getattr

unknown getattr(x, name, default=unbound)

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

Parameter

penggantian_git

None git_override(module_name, remote, commit='', patches=[], patch_cmds=[], 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 menjadi int, int akan menampilkannya tanpa perubahan.
• Jika x adalah bool, int akan menampilkan 1 untuk Benar dan 0 untuk Salah.
• Jika x adalah string, string tersebut harus memiliki format <sign><prefix><digits>. <sign> adalah "+", "-", atau kosong (diinterpretasikan sebagai positif). <digits> adalah urutan digit dari 0 hingga base - 1, dengan huruf a-z (atau setara, A-Z) digunakan sebagai angka untuk 10-35. Jika base adalah 2/8/16, <prefix> bersifat opsional dan dapat 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. Jika base adalah 0, string akan ditafsirkan sebagai literal integer, dalam arti bahwa salah satu basis 2/8/10/16 dipilih bergantung pada awalan mana jika digunakan. Jika base adalah 0, tidak ada awalan yang digunakan, dan ada lebih dari satu digit, digit pertama 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. Akan 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, repo_name='', bazel_compatibility=[])

Nama harus dipanggil maksimal sekali. Ini dapat dihilangkan hanya jika modul ini adalah modul root (seperti pada, jika tidak akan bergantung oleh modul lain).

Parameter

modul_ekstensi

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

Parameter

beberapa_versi_ganti

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

Parameter

cetak

None print(sep=" ", *args)

Menggunakan print dalam kode produksi tidak disarankan karena spam yang dibuatnya 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 mentah. 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_Execution_platforms()

None register_execution_platforms(*platform_labels)

Parameter

register_Execution_platforms()

None register_execution_platforms(*platform_labels)

Parameter

register_Toolchain

None register_toolchains(*toolchain_labels)

Parameter

register_Toolchain

None register_toolchains(*toolchain_labels)

Parameter

repositori_rule(implementasi, atribut, lokal, lingkungan, konfigurasi, jarak jauh, dokumen)

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

Parameter

repositori_rule(implementasi, atribut, lokal, lingkungan, konfigurasi, jarak jauh, dokumen)

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

Parameter

PR

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 untuk aturan, bukan untuk target.)

Parameter

pilih

unknown select(x, no_match_error='')

Parameter

penggantian versi tunggal

None single_version_override(module_name, version='', registry='', patches=[], patch_cmds=[], 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

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

Parameter

gunakan_repo

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

Parameter

visibilitas

None visibility(value)

Menetapkan visibilitas pemuatan modul .bzl yang sedang diinisialisasi.

Visibilitas pemuatan modul mengatur apakah file BUILD dan .bzl lainnya dapat memuatnya atau tidak. (Ini berbeda dengan visibilitas target file sumber .bzl yang mendasarinya, yang mengatur apakah file tersebut dapat muncul sebagai dependensi target lain.) Visibilitas pemuatan bekerja pada level paket: Untuk memuat modul, file yang melakukan pemuatan harus berada dalam paket yang telah diberi visibilitas ke modul. Modul selalu dapat dimuat dalam paketnya sendiri, terlepas dari visibilitasnya.

visibility() hanya dapat dipanggil sekali per file .bzl, dan hanya di tingkat atas, bukan di dalam fungsi. Gaya yang lebih disukai adalah menempatkan panggilan ini tepat di bawah pernyataan load() dan logika singkat apa pun yang diperlukan untuk menentukan argumen.

Jika flag --check_bzl_visibility disetel ke salah (false), pelanggaran visibilitas pemuatan akan menampilkan peringatan, tetapi tidak menggagalkan build.

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, menggunakan garis bawah sebagai pemisah, misalnya github.com/bazelbuild/bazel harus menggunakan com_github_bazelbuild_bazel.

Nama ini digunakan untuk direktori tempat runfile repositori disimpan. Misalnya, jika terdapat foo/bar runfile di repositori lokal dan file WORKSPACE berisi workspace(name = 'baz'), maka runfile akan tersedia di bagian mytarget.runfiles/baz/foo/bar. Jika nama ruang kerja tidak ditentukan, runfile akan symlink 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