लेबल

हर Label इंस्टेंस l के लिए, स्ट्रिंग के तौर पर दिखाए जाने वाले str(l) में यह प्रॉपर्टी होती है कि Label(str(l)) == l, भले ही Label() कॉल कहीं भी हो.

print() या fail() को पोज़िशनल आर्ग्युमेंट के तौर पर पास किए जाने पर, Label इसके बजाय, स्ट्रिंग के तौर पर दिखाए जाने वाले ऐसे फ़ॉर्मैट का इस्तेमाल करता है जिसे आसानी से पढ़ा जा सके. अगर ऐसा किया जा सकता है, तो इस फ़ॉर्मैट में मुख्य डेटाबेस के नज़रिए से, डेटाबेस का कोई नाम इस्तेमाल किया जाता है.

सदस्य

• लेबल
• name
• पैकेज
• संबंधित
• 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"

पैकेज

string Label.package

Label("@@repo//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")

पैरामीटर

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

यह लेबल, जिस टारगेट के बारे में बताता है वह जिस डेटाबेस में मौजूद है उसका कैननिकल नाम. इसमें शुरुआती ऐट-साइन (@) शामिल नहीं होते. उदाहरण के लिए,

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

workspace_root

string Label.workspace_root

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