Label के हर इंस्टेंस l के लिए, स्ट्रिंग के तौर पर दिखाए जाने वाले str(l) में यह प्रॉपर्टी होती है कि Label(str(l)) == l. भले ही, Label() कॉल कहीं भी हो.
print() या fail() में पोज़िशनल आर्ग्युमेंट के तौर पर पास किए जाने पर, Label इसके बजाय, स्ट्रिंग के तौर पर दिखाए जाने वाले ऐसे फ़ॉर्मैट का इस्तेमाल करता है जिसे आसानी से पढ़ा जा सके. अगर ऐसा किया जा सकता है, तो इस फ़ॉर्मैट में मुख्य डेटाबेस के नज़रिए से, डेटाबेस का कोई नाम इस्तेमाल किया जाता है.
सदस्य
लेबल
Label Label(input)
Label ऑब्जेक्ट में बदलता है. यह उस पैकेज के संदर्भ में होता है जिसमें कॉल करने वाली .bzl सोर्स फ़ाइल मौजूद होती है. अगर दी गई वैल्यू पहले से ही Label है, तो उसे बिना किसी बदलाव के लौटा दिया जाता है.मैक्रो के लिए, इससे जुड़ा एक फ़ंक्शन, native.package_relative_label(), इनपुट को फ़िलहाल बनाए जा रहे पैकेज के संदर्भ में Label में बदलता है. स्ट्रिंग को लेबल में बदलने की उस प्रोसेस को कॉपी करने के लिए, इस फ़ंक्शन का इस्तेमाल करें जो लेबल-वैल्यू वाले नियम एट्रिब्यूट की मदद से अपने-आप होती है.
पैरामीटर
| पैरामीटर | ब्यौरा |
|---|---|
input
|
स्ट्रिंग; या लेबल;
ज़रूरी है इनपुट लेबल स्ट्रिंग या लेबल ऑब्जेक्ट. अगर कोई लेबल ऑब्जेक्ट पास किया जाता है, तो उसे उसी तरह लौटा दिया जाता है. |
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)
--+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
@) नहीं होता. उदाहरण के लिए, 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
--+incompatible_enable_deprecated_label_apis अब यह सुविधा उपलब्ध नहीं है. को सेट करना होगा यहां फ़ील्ड का नाम "workspace name" गलत है. इसके बजाय, एक जैसा काम करने वाले
Label.repo_name का इस्तेमाल करें.यह उस डेटाबेस का कैननिकल नाम है जिसमें इस लेबल से रेफ़र किया गया टारगेट मौजूद है. इसमें शुरुआत में कोई ऐट-साइन (@) नहीं होता. उदाहरण के लिए,
Label("@@foo//bar:baz").workspace_name == "foo"workspace_root
string Label.workspace_root
Label("@repo//pkg/foo:abc").workspace_root == "external/repo"