ตัวระบุเป้าหมายของ BUILD
สำหรับทุกๆ อินสแตนซ์ Label
l
ตัวแทนสตริง str(l)
จะมีพร็อพเพอร์ตี้ที่ Label(str(l)) == l
ไม่ว่าการเรียก Label()
จะเกิดขึ้นที่ใด
เมื่อส่งเป็นอาร์กิวเมนต์ตำแหน่งไปยัง print()
หรือ fail()
แล้ว Label
จะใช้การแสดงสตริงที่เพิ่มประสิทธิภาพเพื่อให้มนุษย์อ่านได้ง่ายแทน ตัวแทนนี้ใช้ชื่อที่เก็บที่ปรากฏจากมุมมองของที่เก็บหลัก หากเป็นไปได้
สมาชิก
ป้ายกำกับ
Label Label(input)
Label
ในบริบทของแพ็กเกจที่มีไฟล์ต้นฉบับการเรียกใช้ .bzl
หากค่าที่ระบุเป็น Label
อยู่แล้ว จะส่งกลับโดยไม่เปลี่ยนแปลงสำหรับมาโคร native.package_relative_label()
ซึ่งเป็นฟังก์ชันที่เกี่ยวข้องจะแปลงอินพุตเป็น Label
ในบริบทของแพ็กเกจที่กำลังสร้างอยู่ ใช้ฟังก์ชันดังกล่าวเพื่อเลียนแบบการแปลงสตริงเป็นป้ายกำกับที่ดำเนินการโดยแอตทริบิวต์กฎที่มีค่าป้ายกำกับโดยอัตโนมัติ
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
input
|
string; หรือ ป้ายกำกับ
จำเป็น สตริงป้ายกำกับอินพุตหรือออบเจ็กต์ป้ายกำกับ หากมีการส่งผ่านออบเจ็กต์ป้ายกำกับ จะส่งกลับตามที่เป็น |
ชื่อ
string Label.name
Label("@@foo//pkg/foo:abc").name == "abc"
พัสดุ
string Label.package
Label("@@repo//pkg/foo:abc").package == "pkg/foo"
ที่เกี่ยวข้อง
Label Label.relative(relName)
--+incompatible_enable_deprecated_label_apis
เลิกใช้งาน เมธอดนี้จะทำงานโดยไม่คาดคิดเมื่อใช้กับอาร์กิวเมนต์ที่มีชื่อที่เก็บที่ปรากฏ โปรดใช้
Label.same_package_label()
, native.package_relative_label()
หรือ Label()
แทนแก้ป้ายกำกับที่เป็นค่าสัมบูรณ์ (ขึ้นต้นด้วย //
) หรือสัมพันธ์กับแพ็กเกจปัจจุบัน หากป้ายกำกับนี้อยู่ในที่เก็บระยะไกล อาร์กิวเมนต์จะได้รับการแก้ไขที่เกี่ยวข้องกับที่เก็บนั้น หากอาร์กิวเมนต์มีชื่อที่เก็บ ระบบจะไม่สนใจป้ายกำกับปัจจุบันและระบบจะแสดงผลอาร์กิวเมนต์ตามที่เป็นอยู่ ยกเว้นว่าชื่อที่เก็บจะถูกเขียนใหม่หากอยู่ในการแมปที่เก็บปัจจุบัน ป้ายกำกับที่สงวนไว้ก็จะแสดงเหมือนเดิมด้วย
ตัวอย่างเช่น
Label("//foo/bar:baz").relative(":quux") == Label("//foo/bar:quux") Label("//foo/bar:baz").relative("//wiz:quux") == Label("//wiz:quux") Label("@repo//foo/bar:baz").relative("//wiz:quux") == Label("@repo//wiz:quux") Label("@repo//foo/bar:baz").relative("//visibility:public") == Label("//visibility:public") Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@other//wiz:quux")
หากมีการส่งการแมปที่เก็บคือ {'@other' : '@remapped'}
ระบบจะรีแมปต่อไปนี้
Label("@repo//foo/bar:baz").relative("@other//wiz:quux") == Label("@remapped//wiz:quux")
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
relName
|
string;
ต้องระบุ ป้ายกำกับที่จะแก้ปัญหาที่เกี่ยวข้องกับรายการนี้ |
repo_name
string Label.repo_name
@
) ตัวอย่างเช่น Label("@@foo//bar:baz").repo_name == "foo"
same_package_label
Label Label.same_package_label(target_name)
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
target_name
|
string;
ต้องระบุ ชื่อเป้าหมายของป้ายกำกับใหม่ |
workspace_name
string Label.workspace_name
--+incompatible_enable_deprecated_label_apis
เลิกใช้งาน ชื่อฟิลด์ "ชื่อพื้นที่ทำงาน" สะกดผิดเป็นคำอื่น ใช้
Label.repo_name
ที่ทํางานเหมือนกันแทนชื่อ Canonical ของที่เก็บซึ่งมีเป้าหมายที่ป้ายกำกับนี้อ้างถึง โดยไม่มีเครื่องหมาย @ นำหน้า (@
) ตัวอย่างเช่น
Label("@@foo//bar:baz").workspace_name == "foo"
workspace_root
string Label.workspace_root
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"