ป้ายกำกับ

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

เมื่อส่งผ่านเป็นอาร์กิวเมนต์ตำแหน่งไปยัง print() หรือ fail() Label จะใช้การแสดงสตริงที่ปรับให้เหมาะกับการอ่านของมนุษย์แทน การแสดงนี้จะใช้ชื่อที่เก็บที่เห็นได้ชัดจากมุมมองของที่เก็บหลักหากเป็นไปได้

สมาชิก

• ป้ายกำกับ
• name
• package
• relative
• repo_name
• same_package_label
• workspace_name
• workspace_root

ป้ายกำกับ

Label Label(input)

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

พารามิเตอร์

name

string Label.name

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

package

string Label.package

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

relative

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

พารามิเตอร์

repo_name

string Label.repo_name

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

same_package_label

Label Label.same_package_label(target_name)

พารามิเตอร์

workspace_name

string Label.workspace_name

ชื่อ Canonical ของที่เก็บที่มีเป้าหมายที่ป้ายกำกับนี้อ้างถึง โดยไม่มีเครื่องหมายแอด (@) นำหน้า เช่น

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

workspace_root

string Label.workspace_root

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