ป้ายกำกับ

ตัวระบุเป้าหมายของ BUILD

สำหรับอินสแตนซ์ Label ทุกรายการ l การแสดงสตริง str(l) จะมีพร็อพเพอร์ตี้ Label(str(l)) == l ไม่ว่าการเรียก Label() จะเกิดขึ้นที่ใดก็ตาม

สมาชิก

• ป้ายกำกับ
• name
• package
• ที่เกี่ยวข้อง
• workspace_name
• workspace_root

ป้ายกำกับ

Label Label(input)

แปลงสตริงป้ายกำกับเป็นออบเจ็กต์ Label ในบริบทของแพ็กเกจที่ไฟล์ต้นฉบับ .bzl ที่เรียกอยู่ หากค่าที่ระบุเป็น Label อยู่แล้ว ระบบจะแสดงผลค่าเดิม

สำหรับมาโคร ฟังก์ชันที่เกี่ยวข้อง native.package_relative_label() จะแปลงอินพุตเป็น Label ในบริบทของแพ็กเกจที่กำลังสร้าง ใช้ฟังก์ชันดังกล่าวเพื่อจำลองการแปลงสตริงเป็นป้ายกำกับที่แอตทริบิวต์กฎที่มีค่าเป็นป้ายกำกับจะดำเนินการโดยอัตโนมัติ

พารามิเตอร์

พารามิเตอร์	คำอธิบาย
input	สตริง หรือ ป้ายกำกับ (ต้องระบุ) สตริงป้ายกำกับหรือออบเจ็กต์ป้ายกำกับอินพุต หากส่งออบเจ็กต์ป้ายกำกับ ระบบจะแสดงผลออบเจ็กต์ดังกล่าวตามเดิม

name

string Label.name

ชื่อของป้ายกำกับนี้ภายในแพ็กเกจ เช่น

Label("//pkg/foo:abc").name == "abc"

package

string Label.package

ส่วนแพ็กเกจของป้ายกำกับนี้ เช่น

Label("//pkg/foo:abc").package == "pkg/foo"

ที่เกี่ยวข้อง

Label Label.relative(relName)

แก้ปัญหาป้ายกำกับที่เป็นแบบสัมบูรณ์ (ขึ้นต้นด้วย //) หรือที่เกี่ยวข้องกับแพ็กเกจปัจจุบัน หากป้ายกำกับนี้อยู่ในที่เก็บระยะไกล ระบบจะแก้ปัญหาอาร์กิวเมนต์ที่เกี่ยวข้องกับที่เก็บดังกล่าว หากอาร์กิวเมนต์มีชื่อที่เก็บ ระบบจะละเว้นป้ายกำกับปัจจุบันและแสดงผลอาร์กิวเมนต์ตามเดิม ยกเว้นว่าจะมีการเขียนชื่อที่เก็บใหม่หากชื่อนั้นอยู่ในการแมปที่เก็บปัจจุบัน ระบบจะแสดงผลป้ายกำกับที่สงวนไว้ตามเดิมด้วย
ตัวอย่างเช่น

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	ต้องระบุ ป้ายกำกับที่จะแก้ปัญหาที่เกี่ยวข้องกับป้ายกำกับนี้

workspace_name

string Label.workspace_name

ส่วนที่เก็บของป้ายกำกับนี้ เช่น

Label("@foo//bar:baz").workspace_name == "foo"

workspace_root

string Label.workspace_root

แสดงผลรูทการดำเนินการสำหรับพื้นที่ทำงานของป้ายกำกับนี้ที่เกี่ยวข้องกับ execroot เช่น

Label("@repo//pkg/foo:abc").workspace_root == "external/repo"