สมาชิก
ป้ายกำกับ
Label Label(label_string)สร้างป้ายกำกับที่อ้างถึงเป้าหมาย BUILD ใช้ฟังก์ชันนี้เมื่อคุณต้องการกำหนดค่าเริ่มต้นสำหรับแอตทริบิวต์ป้ายกำกับของกฎหรือเมื่ออ้างอิงเป้าหมายผ่านป้ายกำกับแบบสัมบูรณ์จากมาโคร อาร์กิวเมนต์ต้องอ้างอิงป้ายกำกับแบบสัมบูรณ์ ระบบจะตีความส่วนที่เก็บของป้ายกำกับ (หรือการไม่มีอยู่) ในบริบทของที่เก็บที่การเรียกใช้ Label() นี้ปรากฏ ตัวอย่าง:
Label("//tools:default")
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
label_string
|
ต้องระบุ สตริงป้ายกำกับ |
ชื่อ
string Label.nameชื่อของป้ายกำกับนี้ภายในแพ็กเกจ ตัวอย่างเช่น
Label("//pkg/foo:abc").name == "abc"
พัสดุ
string Label.packageส่วนแพ็กเกจของป้ายกำกับนี้ ตัวอย่างเช่น
Label("//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")
พารามิเตอร์
พารามิเตอร์ | คำอธิบาย |
---|---|
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"