Global

Pelanggan

• semua
• analysis_test_transition
• apa pun
• archive_override
• aspek
• bazel_dep
• bind
• bool
• configuration_field
• dependensi
• dict
• dir
• enumerasi
• exec_group
• gagal
• float
• getattr
• git_override
• hasattr
• hash
• int
• len
• list
• local_path_override
• max
• mnt
• module
• module_extension
• multiple_version_override
• print
• penyedia
• range
• register_execution_platforms()
• register_execution_platforms(dev_dependency)
• register_toolchains()
• register_toolchains(dev_dependency)
• repository_rule
• repr
• dibalik
• aturan
• pilih
• single_version_override
• diurutkan
• str
• tag_class
• tuple
• jenis
• use_extension
• use_repo
• visibilitas
• ruang kerja
• zip

semua

bool all(elements)

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

Parameter

analysis_test_transition

transition analysis_test_transition(settings)

Membuat transisi konfigurasi untuk diterapkan pada dependensi aturan analysis-test. Transisi ini hanya dapat diterapkan pada atribut aturan dengan analysis_test = True. Kemampuan aturan tersebut dibatasi (misalnya, ukuran hierarki dependensinya terbatas), 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 Analysis Test Framework. Lihat dokumentasi (atau penerapannya) untuk mengetahui praktik terbaik.

Parameter

apa pun

bool any(elements)

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

Parameter

archive_override

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

bazel_dep

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

Parameter

bind

None bind(name, actual=None)

Peringatan: penggunaan bind() tidak direkomendasikan. Lihat Mempertimbangkan penghapusan ikatan untuk diskusi panjang tentang masalah dan alternatifnya.

Memberikan alias kepada target dalam paket //external.

Parameter

bool

bool bool(x=False)

Parameter

configuration_field

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

dependensi

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

Semua elemen (langsung dan tidak langsung) dari dependensi harus berjenis sama, seperti yang diperoleh dengan ekspresi type(x).

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

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

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

Catatan tentang kompatibilitas mundur/maju. Fungsi ini saat ini menerima parameter items posisi. Fungsi ini tidak digunakan lagi dan akan dihapus pada masa mendatang, dan setelah dihapus, direct akan menjadi satu-satunya parameter posisi untuk fungsi depset. Dengan demikian, kedua panggilan berikut setara dan siap menghadapi masa depan:

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

Parameter

dict

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

Parameter

{i>dir<i}

list dir(x)

Parameter

menghitung

list enumerate(list, start=0)

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

Parameter

exec_group

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 berupa float, float akan menampilkannya tanpa perubahan.
• Jika x adalah bool, float akan menampilkan 1,0 untuk Benar dan 0,0 untuk Salah.
• Jika x adalah 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 (mengabaikan huruf besar/kecil) dengan NaN, Inf, atau Infinity, yang 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_override

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 merupakan 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 sampai base - 1, dengan huruf a-z (atau ekuivalen, A-Z) digunakan sebagai digit untuk 10-35. Jika base adalah 2/8/16, <prefix> masing-masing bersifat opsional dan mungkin 0b/0o/0x (atau ekuivalen, 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 jika ada yang digunakan. Jika base adalah 0, tidak ada awalan yang digunakan, dan ada lebih dari satu digit, digit terdepan 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 menuju nol. Ini merupakan error jika x tidak terbatas (NaN atau tidak terhingga).

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=[])

Ini harus dipanggil paling banyak sekali. Elemen ini hanya dapat dihilangkan jika modul ini merupakan modul root (seperti halnya, jika tidak akan bergantung oleh modul lain).

Parameter

module_extension

unknown module_extension(implementation, *, tag_classes={}, doc='', environ=[], os_dependent=False, arch_dependent=False)

Parameter

multiple_version_override

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

Parameter

cetak

None print(sep=" ", *args)

Penggunaan print dalam kode produksi tidak disarankan karena spam yang dibuatnya untuk pengguna. Untuk penghentian penggunaan, pilih error sulit 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, menampilkan tuple yang berisi 2 elemen: nilai callable Provider dan nilai callable konstruktor raw. Lihat Aturan (Inisialisasi kustom penyedia kustom) dan pembahasan 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(dev_dependency)

None register_execution_platforms(dev_dependency=False, *platform_labels)

Parameter

register_toolchains()

None register_toolchains(*toolchain_labels)

Parameter

register_toolchains(dev_dependency)

None register_toolchains(dev_dependency=False, *toolchain_labels)

Parameter

repository_rule

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

Parameter

repr

string repr(x)

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

Parameter

terbalik

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, sedangkan semua aturan lainnya tidak boleh memiliki akhiran ini. (Pembatasan ini hanya berlaku untuk aturan, bukan targetnya.)

Parameter

pilih

unknown select(x, no_match_error='')

Parameter

single_version_override

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

tipe

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, isolate=False)

Parameter

use_repo

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

Parameter

visibilitas

None visibility(value)

Menyetel visibilitas pemuatan modul .bzl yang saat ini sedang diinisialisasi.

Visibilitas beban modul mengatur apakah file BUILD dan .bzl lain dapat memuatnya atau tidak. (Hal ini berbeda dengan visibilitas target file sumber .bzl yang mendasarinya, yang mengatur apakah file mungkin muncul sebagai dependensi dari target lainnya.) Visibilitas pemuatan berfungsi di level paket: Untuk memuat modul, file yang melakukan pemuatan harus aktif di 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 level teratas, 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 tanda --check_bzl_visibility disetel ke salah (false), pelanggaran visibilitas pemuatan akan memberikan 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 ada runfile foo/bar di repositori lokal dan file WORKSPACE berisi workspace(name = 'baz'), runfile akan tersedia di mytarget.runfiles/baz/foo/bar. Jika tidak ada nama ruang kerja yang ditentukan, runfile akan di-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 tidak 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