ป้ายกำกับ

วันที่ รายงานปัญหา ดูแหล่งที่มา ตอนกลางคืน · 7.3 · 7.2 · 7.1 · 7.0 · 6.5

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

สำหรับทุกๆ อินสแตนซ์ Label l ตัวแทนสตริง str(l) จะมีพร็อพเพอร์ตี้ที่ Label(str(l)) == l ไม่ว่าการเรียก 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)

ทดลอง API นี้อยู่ในขั้นทดลองและอาจเปลี่ยนแปลงได้ตลอดเวลา โปรดอย่าพึ่งพา ซึ่งอาจเปิดใช้ในการทดสอบโดยการตั้งค่า --+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 ต้องระบุ
ป้ายกำกับที่จะแก้ปัญหาที่เกี่ยวข้องกับรายการนี้

repo_name

string Label.repo_name

ชื่อ Canonical ของที่เก็บซึ่งมีเป้าหมายที่ป้ายกำกับนี้อ้างถึง โดยไม่มีเครื่องหมาย @ นำหน้า (@) ตัวอย่างเช่น 
Label("@@foo//bar:baz").repo_name == "foo"

same_package_label

Label Label.same_package_label(target_name)

สร้างป้ายกำกับในแพ็กเกจเดียวกับป้ายกำกับนี้พร้อมด้วยชื่อเป้าหมายที่ระบุ

พารามิเตอร์

พารามิเตอร์ คำอธิบาย
target_name ต้องระบุ
ชื่อเป้าหมายของป้ายกำกับใหม่

workspace_name

string Label.workspace_name

ทดลอง API นี้อยู่ในขั้นทดลองและอาจเปลี่ยนแปลงได้ตลอดเวลา โปรดอย่าพึ่งพา ซึ่งอาจเปิดใช้ในการทดสอบโดยการตั้งค่า --+incompatible_enable_deprecated_label_apis
เลิกใช้งาน ชื่อฟิลด์ "ชื่อพื้นที่ทำงาน" สะกดผิดเป็นคำอื่น ใช้ Label.repo_name ที่ทํางานเหมือนกันแทน

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

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

workspace_root

string Label.workspace_root

แสดงรูทของการดำเนินการสำหรับที่เก็บซึ่งมีเป้าหมายที่ป้ายกำกับนี้อ้างอิงถึง ซึ่งเกี่ยวข้องกับ execroot ตัวอย่างเช่น:
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"