ทั่วโลก

สมาชิก

• all
• analysis_test_transition
• any
• archive_override
• aspect
• bazel_dep
• bind
• bool
• configuration_field
• depset
• dict
• dir
• enumerate
• exec_group
• fail
• float
• getattr
• git_override
• hasattr
• hash
• int
• len
• list
• local_path_override
• max
• นาที
• module
• module_extension
• multiple_version_override
• print
• provider
• range
• register_execution_platforms()
• register_execution_platforms(dev_dependency)
• register_toolchains()
• register_toolchains(dev_dependency)
• repository_rule
• repr
• reversed
• rule
• select
• single_version_override
• จัดเรียง
• str
• tag_class
• tuple
• type
• use_extension
• use_repo
• visibility
• workspace
• zip

ทั้งหมด

bool all(elements)

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

พารามิเตอร์

analysis_test_transition

transition analysis_test_transition(settings)

สร้างการเปลี่ยนการกำหนดค่าที่จะใช้กับทรัพยากร ของกฎการทดสอบการวิเคราะห์ การเปลี่ยนนี้ใช้ได้กับแอตทริบิวต์ของกฎที่มี analysis_test = True เท่านั้น กฎดังกล่าวมีข้อจำกัดด้านความสามารถ (เช่น ขนาดของต้นไม้ความเกี่ยวข้องถูกจำกัด) ดังนั้นทรานซิชันที่สร้างโดยใช้ฟังก์ชันนี้จะมีข้อจำกัดด้านขอบเขตที่เป็นไปได้เมื่อเทียบกับทรานซิชันที่สร้างโดยใช้ transition

ฟังก์ชันนี้ออกแบบมาเพื่ออำนวยความสะดวกให้กับไลบรารีหลักของ เฟรมเวิร์กการทดสอบการวิเคราะห์เป็นหลัก ดูแนวทางปฏิบัติแนะนำได้ในเอกสารประกอบ (หรือการใช้งาน)

พารามิเตอร์

ใดๆ

bool any(elements)

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

พารามิเตอร์

archive_override

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

พารามิเตอร์

เฉพาะด้าน

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)

พารามิเตอร์

bazel_dep

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

พารามิเตอร์

เชื่อมโยง

None bind(name, actual=None)

คำเตือน: ไม่แนะนำให้ใช้ bind() โปรดดูพิจารณานำการเชื่อมโยงออกเพื่อดูการพูดคุยเกี่ยวกับปัญหาและทางเลือกอื่นๆ ของการดำเนินการนี้

ตั้งชื่อแทนเป้าหมายในแพ็กเกจ //external

พารามิเตอร์

บูลีน

bool bool(x=False)

พารามิเตอร์

configuration_field

LateBoundDefault configuration_field(fragment, name)

ตัวอย่างการใช้งาน

การกําหนดแอตทริบิวต์ของกฎ:

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

การเข้าถึงในการนำกฎไปใช้:

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

พารามิเตอร์

depset

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

องค์ประกอบทั้งหมด (ทั้งโดยตรงและโดยอ้อม) ของชุดข้อมูล Dependency ต้องเป็นประเภทเดียวกันตามที่ได้จากนิพจน์ type(x)

เนื่องจากชุดที่อิงตามแฮชใช้เพื่อกำจัดรายการที่ซ้ำกันระหว่างการทำซ้ำ องค์ประกอบทั้งหมดของ depset จึงควรเป็นแฮชได้ อย่างไรก็ตาม ปัจจุบันยังไม่มีการตรวจสอบค่าคงที่นี้อย่างสม่ำเสมอในคอนสตรัคเตอร์ทั้งหมด ใช้ Flag --incompatible_always_check_depset_elements เพื่อเปิดใช้การตรวจสอบที่สอดคล้องกัน ซึ่งจะเป็นลักษณะการทำงานเริ่มต้นในรุ่นต่อๆ ไป ดูปัญหา 10313

นอกจากนี้ ขณะนี้องค์ประกอบต้องเป็นแบบคงที่ แต่เราจะผ่อนปรนข้อจำกัดนี้ในอนาคต

ลําดับของ depset ที่สร้างขึ้นควรเข้ากันได้กับลําดับของ depset transitive คำสั่งซื้อ "default" ใช้ได้กับคำสั่งซื้ออื่นๆ ทั้งหมด แต่คำสั่งซื้ออื่นๆ ใช้ได้เฉพาะกับคำสั่งซื้อนั้นๆ เท่านั้น

หมายเหตุเกี่ยวกับความเข้ากันได้แบบย้อนหลัง/ไปข้างหน้า ปัจจุบันฟังก์ชันนี้ยอมรับพารามิเตอร์ items ตามตำแหน่ง เราได้เลิกใช้งานและจะนำออกในอนาคต และหลังจากนำออกแล้ว direct จะกลายเป็นพารามิเตอร์ตำแหน่งเดียวของฟังก์ชัน depset ดังนั้นการเรียกใช้ทั้ง 2 รายการต่อไปนี้จึงเทียบเท่ากันและใช้ได้ในอนาคต

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

พารามิเตอร์

dict

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

พารามิเตอร์

dir

list dir(x)

พารามิเตอร์

แจกแจง

list enumerate(list, start=0)

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

พารามิเตอร์

exec_group

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

พารามิเตอร์

ล้มเหลว

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

พารามิเตอร์

จำนวนลอยตัว

float float(x=unbound)

• หาก x เป็นตัวเลขทศนิยมอยู่แล้ว float จะแสดงผลโดยไม่เปลี่ยนแปลง
• หาก x เป็นบูลีน float จะแสดงผล 1.0 สำหรับ True และ 0.0 สำหรับ False
• หาก x เป็น int float จะแสดงผลค่าทศนิยมที่มีค่าจำกัดซึ่งใกล้เคียงกับ x หรือแสดงข้อผิดพลาดหากค่าสัมบูรณ์มีขนาดใหญ่เกินไป
• หาก x เป็นสตริง สตริงดังกล่าวต้องเป็นค่าคงที่ทศนิยมที่ถูกต้อง หรือเท่ากับ (ไม่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่) NaN, Inf หรือ Infinity โดยอาจนำหน้าด้วยเครื่องหมาย + หรือ -

พารามิเตอร์

getattr

unknown getattr(x, name, default=unbound)

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

พารามิเตอร์

git_override

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

พารามิเตอร์

hasattr

bool hasattr(x, name)

hasattr(ctx.attr, "myattr")

พารามิเตอร์

แฮช

int hash(value)

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

พารามิเตอร์

int

int int(x, base=unbound)

• หาก x เป็น int อยู่แล้ว int จะแสดงผลโดยไม่เปลี่ยนแปลง
• หาก x เป็นบูลีน int จะแสดงค่า 1 สำหรับ "จริง" และ 0 สำหรับ "เท็จ"
• หาก x เป็นสตริง สตริงดังกล่าวต้องมีรูปแบบเป็น <sign><prefix><digits> <sign> เป็น "+", "-" หรือว่างเปล่า (ตีความว่าบวก) <digits> คือลำดับตัวเลขตั้งแต่ 0 ถึง base - 1 โดยตัวอักษร a-z (หรือเทียบเท่าคือ A-Z) จะใช้เป็นตัวเลขสำหรับ 10-35 ในกรณีที่ base เป็น 2/8/16 <prefix> จะระบุหรือไม่ก็ได้และอาจเป็น 0b/0o/0x (หรือเทียบเท่าคือ 0B/0O/0X) ตามลำดับ หาก base เป็นค่าอื่นนอกเหนือจากฐานเหล่านี้หรือค่าพิเศษ 0 ส่วนนำหน้าต้องว่าง ในกรณีที่ base เป็น 0 ระบบจะตีความสตริงเป็นค่าตัวเลขเต็มตามตัวอักษร ในแง่ที่ว่าระบบจะเลือกฐานใดฐานหนึ่งจาก 2/8/10/16 โดยขึ้นอยู่กับคำนำหน้าที่ใช้ (หากมี) หาก base เป็น 0 ระบบจะไม่ใช้คำนำหน้า และหากมีตัวเลขมากกว่า 1 ตัว ตัวเลขนำหน้าต้องไม่ใช่ 0 ทั้งนี้เพื่อไม่ให้เกิดความสับสนระหว่างฐาน 8 กับฐาน 10 ขนาดของตัวเลขที่แสดงโดยสตริงต้องอยู่ภายในช่วงที่อนุญาตสําหรับประเภท int
• หาก x เป็นตัวเลขทศนิยม int จะแสดงผลค่าจำนวนเต็มของตัวเลขทศนิยม โดยปัดเศษให้ใกล้กับ 0 ระบบจะแสดงข้อผิดพลาดหาก x ไม่ใช่จำนวนจำกัด (NaN หรือ Infinity)

ตัวอย่าง

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

พารามิเตอร์

len

int len(x)

พารามิเตอร์

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]

พารามิเตอร์

local_path_override

None local_path_override(module_name, path)

พารามิเตอร์

สูงสุด

unknown max(*args)

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

พารามิเตอร์

นาที

unknown min(*args)

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

พารามิเตอร์

โมดูล

None module(name='', version='', compatibility_level=0, repo_name='', bazel_compatibility=[])

ควรเรียกใช้ไม่เกิน 1 ครั้ง คุณละเว้นได้เฉพาะในกรณีที่โมดูลนี้เป็นโมดูลรูท (ในกรณีที่โมดูลอื่นจะไม่ใช้)

พารามิเตอร์

module_extension

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

พารามิเตอร์

multiple_version_override

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

พารามิเตอร์

พิมพ์

None print(sep=" ", *args)

ไม่แนะนำให้ใช้ print ในโค้ดเวอร์ชันที่ใช้งานจริงเนื่องจากจะทำให้เกิดสแปมสำหรับผู้ใช้ สําหรับการเลิกใช้งาน เราขอแนะนำให้ใช้ข้อผิดพลาดแบบฮาร์ดโดยใช้ fail() เมื่อเป็นไปได้

พารามิเตอร์

provider

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
    ...

โปรดดูคู่มือที่ครอบคลุมเกี่ยวกับวิธีใช้ผู้ให้บริการที่หัวข้อกฎ (ผู้ให้บริการ)

แสดงผลค่าที่เรียกใช้ได้ของ Provider หากไม่ได้ระบุ init

หากระบุ init ระบบจะแสดงผล tupple ที่มี 2 องค์ประกอบ ได้แก่ ค่าที่เรียกใช้ได้ของ Provider และค่าที่เรียกใช้ได้ของ ตัวสร้างแบบดิบ ดูรายละเอียดได้ที่กฎ (การเริ่มต้นที่กำหนดเองของผู้ให้บริการที่กำหนดเอง) และการพูดคุยเกี่ยวกับพารามิเตอร์ init ด้านล่าง

พารามิเตอร์

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

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

ช่วง

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]

พารามิเตอร์

register_execution_platforms()

None register_execution_platforms(*platform_labels)

พารามิเตอร์

register_execution_platforms(dev_dependency)

None register_execution_platforms(dev_dependency=False, *platform_labels)

พารามิเตอร์

register_toolchains()

None register_toolchains(*toolchain_labels)

พารามิเตอร์

register_toolchains(dev_dependency)

None register_toolchains(dev_dependency=False, *toolchain_labels)

พารามิเตอร์

repository_rule

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

พารามิเตอร์

repr

string repr(x)

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

พารามิเตอร์

ยกเลิก

list reversed(sequence)

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

พารามิเตอร์

กฎ

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)

คุณต้องกําหนดกฎให้กับตัวแปรส่วนกลางในไฟล์ .bzl โดยชื่อของตัวแปรส่วนกลางจะเป็นชื่อของกฎ

กฎทดสอบต้องมีชื่อที่ลงท้ายด้วย _test ส่วนกฎอื่นๆ ทั้งหมดต้องไม่มีคำต่อท้ายนี้ (ข้อจํากัดนี้มีผลกับกฎเท่านั้น โดยจะไม่มีผลกับเป้าหมายของกฎ)

พารามิเตอร์

เลือก

unknown select(x, no_match_error='')

พารามิเตอร์

single_version_override

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

พารามิเตอร์

จัดเรียง

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

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

พารามิเตอร์

str

string str(x)

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

พารามิเตอร์

tag_class

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

พารามิเตอร์

มัด

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)

พารามิเตอร์

ประเภท

string type(x)

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

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

พารามิเตอร์

use_extension

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

พารามิเตอร์

use_repo

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

พารามิเตอร์

การเปิดเผย

None visibility(value)

ตั้งค่าระดับการมองเห็นการโหลดของโมดูล .bzl ที่กําลังเริ่มต้น

ระดับการมองเห็นการโหลดของโมดูลจะกำหนดว่าไฟล์ BUILD และ .bzl อื่นๆ จะโหลดโมดูลนั้นหรือไม่ (การดำเนินการนี้แตกต่างจากระดับการเข้าถึงเป้าหมายของไฟล์ซอร์ส .bzl ที่เกี่ยวข้อง ซึ่งจะควบคุมว่าไฟล์อาจปรากฏเป็นข้อกำหนดของเป้าหมายอื่นๆ หรือไม่) การมองเห็นการโหลดจะทำงานในระดับแพ็กเกจ: หากต้องการโหลดโมดูล ไฟล์ที่ทำการโหลดต้องอยู่ในแพ็กเกจที่ได้รับสิทธิ์เข้าถึงโมดูล โมดูลจะโหลดภายในแพ็กเกจของตัวเองได้เสมอ ไม่ว่าจะมีการแสดงผลหรือไม่ก็ตาม

visibility() สามารถเรียกใช้ได้เพียงครั้งเดียวต่อไฟล์ .bzl และจะต้องอยู่ที่ระดับบนสุดเท่านั้น โดยต้องไม่อยู่ภายในฟังก์ชัน รูปแบบที่แนะนำคือวางการเรียกใช้นี้ไว้ใต้คำสั่ง load() โดยตรงและตรรกะสั้นๆ ที่จําเป็นต่อการกำหนดอาร์กิวเมนต์

หากตั้งค่า Flag --check_bzl_visibility เป็น "เท็จ" การละเมิดการแสดงผลของโหลดจะแสดงคำเตือนแต่ไม่ทำให้การบิลด์ล้มเหลว

พารามิเตอร์

พื้นที่ทำงาน

None workspace(name)

ฟังก์ชันนี้ใช้ได้เฉพาะในไฟล์ WORKSPACE และต้องประกาศก่อนฟังก์ชันอื่นๆ ทั้งหมดในไฟล์ WORKSPACE ไฟล์ WORKSPACE แต่ละไฟล์ควรมีฟังก์ชัน workspace

ตั้งชื่อพื้นที่ทํางานนี้ ชื่อเวิร์กスペースควรเป็นคำอธิบายโปรเจ็กต์ในรูปแบบแพ็กเกจ Java โดยใช้ขีดล่างเป็นตัวคั่น เช่น github.com/bazelbuild/bazel ควรใช้ com_github_bazelbuild_bazel

ชื่อนี้ใช้สำหรับไดเรกทอรีที่จัดเก็บไฟล์รันไทม์ของที่เก็บ ตัวอย่างเช่น หากมีไฟล์เรียกใช้ foo/bar ในที่เก็บข้อมูลในเครื่องและไฟล์ WORKSPACE มี workspace(name = 'baz') ไฟล์เรียกใช้จะอยู่ใน mytarget.runfiles/baz/foo/bar หากไม่ได้ระบุชื่อพื้นที่ทํางาน ระบบจะลิงก์ไฟล์เรียกใช้กับ bar.runfiles/foo/bar

ชื่อกฎที่เก็บระยะไกลต้องเป็นชื่อพื้นที่ทำงานที่ถูกต้อง เช่น คุณอาจมี maven_jar(name = 'foo') แต่ไม่มี maven_jar(name = 'foo%bar') เนื่องจาก Bazel จะพยายามเขียนไฟล์ WORKSPACE สำหรับ maven_jar ที่มี workspace(name = 'foo%bar')

พารามิเตอร์

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

พารามิเตอร์