สมาชิก
ป้ายกำกับ
Label Label(input)แปลงสตริงป้ายกํากับเป็นออบเจ็กต์
Label ในบริบทของแพ็กเกจที่มีไฟล์ต้นทาง .bzl อยู่ หากค่าที่ระบุเป็น Label อยู่แล้ว ระบบจะส่งค่ากลับมาโดยไม่มีการเปลี่ยนแปลงสําหรับมาโคร ซึ่งเป็นฟังก์ชันที่เกี่ยวข้อง native.package_relative_label() จะแปลงอินพุตเป็น Label ในบริบทของแพ็กเกจที่กําลังสร้างอยู่ ใช้ฟังก์ชันดังกล่าวเพื่อเลียนแบบ Conversion จากสตริงไปยังป้ายกํากับที่ดําเนินการโดยแอตทริบิวต์กฎที่มีค่าป้ายกํากับโดยอัตโนมัติ
พารามิเตอร์
| พารามิเตอร์ | คำอธิบาย |
|---|---|
input
|
string; or Label;
ต้องระบุสตริงป้ายกํากับอินพุตหรือออบเจ็กต์ป้ายกํากับ หากออบเจ็กต์ป้ายกํากับส่งผ่านไป ออบเจ็กต์นั้นจะแสดงผลตามที่เป็นอยู่ |
name
string Label.nameชื่อของป้ายกํากับนี้ภายในแพ็กเกจ ตัวอย่างเช่น:
Label("//pkg/foo:abc").name == "abc"
พัสดุ
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
|
ต้องระบุ ป้ายกํากับที่จะได้รับการแก้ไขให้เกี่ยวข้องกับป้ายกํากับนี้ |
ชื่อพื้นที่ทํางาน
string Label.workspace_nameส่วนที่เก็บของป้ายกํากับนี้ เช่น
Label("@foo//bar:baz").workspace_name == "foo"
พื้นที่ทํางาน
string Label.workspace_rootแสดงผลรากการดําเนินการสําหรับพื้นที่ทํางานของป้ายกํากับนี้ เมื่อเทียบกับ execroot ตัวอย่างเช่น:
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"