ये फ़ंक्शन @bazel_tools//tools/build_defs/repo:utils.bzl
से लोड किए जा सकते हैं.
फ़ेच किए जाने के बाद, बाहरी डेटा स्टोर करने की जगहों में बदलाव करने के तरीके.
सेटअप
इन उपयोगिताओं का इस्तेमाल, डेटा स्टोर करने की जगह के अन्य नियमों के लिए किया जा सकता है. इन्हें इस तरह से लोड किया जा सकता है.
load(
"@bazel_tools//tools/build_defs/repo:utils.bzl",
"workspace_and_buildfile",
"patch",
"update_attrs",
)
शायद
maybe(repo_rule, name, kwargs)
यूटिलिटी फ़ंक्शन, सिर्फ़ रिपॉज़िटरी को जोड़ने के लिए होता है. ऐसा तब किया जाता है, जब यह पहले से मौजूद न हो.
यह सुरक्षित repositories.bzl मैक्रो लागू करने के लिए है, जिसे https://batz.build/rules/deploying#dependencies में दस्तावेज़ किया गया है.
पैरामीटर
repo_rule |
आवश्यक.
रिपॉज़िटरी नियम फ़ंक्शन का इस्तेमाल करना होगा. |
name |
आवश्यक.
बनाने के लिए रिपॉज़िटरी का नाम. |
kwargs |
ज़रूरी नहीं.
बचे हुए आर्ग्युमेंट, जिन्हें repo_रूल फ़ंक्शन को पास किया जाता है. |
सामान लौटाना
इनमें से कुछ भी नहीं, ज़रूरत पड़ने पर रिपॉज़िटरी (डेटा स्टोर करने की जगह) को साइड इफ़ेक्ट के तौर पर परिभाषित करता है.
parse_netrc
parse_netrc(contents, filename)
उपयोगिता फ़ंक्शन, जो कम से कम एक बुनियादी .netrc फ़ाइल को पार्स करता है.
पैरामीटर
contents |
आवश्यक.
पार्सर के लिए इनपुट. |
filename |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
फ़ाइल नाम का इस्तेमाल किया जा सकता है. |
सामान लौटाना
ऐसा कोडिंग है जिसमें मशीन के नाम को उसके बारे में दी गई जानकारी की मदद से मैप किया जाता है
पैच
patch(ctx, patches, patch_cmds, patch_cmds_win, patch_tool, patch_args, auth)
पहले से एक्सट्रैक्ट किए गए डेटा स्टोर करने की जगह को पैच करने का काम.
इस नियम का इस्तेमाल, डेटा स्टोर करने के नियम को लागू करने के लिए किया जाना चाहिए. अगर patches
, patch_tool
,
patch_args
, patch_cmds
, और patch_cmds_win
पैरामीटर नहीं दिए गए हैं,
तो उन्हें ctx.attr
से लिया जाता है.
पैरामीटर
ctx |
आवश्यक.
रिपॉज़िटरी के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस यूटिलिटी फ़ंक्शन को कॉल किया गया है. |
patches |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
लागू की जाने वाली पैच फ़ाइलें. स्ट्रिंग, लेबल या पाथ की सूची. |
patch_cmds |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
बैश कमांड को पैच करने के लिए चलाया जाता है, bash -c में एक बार में एक को पास किया जाता है. स्ट्रिंग की सूची |
patch_cmds_win |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
पैचिंग के लिए चलाने के लिए PowerShell आदेश, पावरशेल /c को एक बार में एक पास किया जाता है. स्ट्रिंग की सूची. अगर इस पैरामीटर की बूलियन वैल्यू गलत है, तो Pat_cmds का इस्तेमाल किया जाएगा और इस पैरामीटर को अनदेखा कर दिया जाएगा. |
patch_tool |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
पैच लागू करने के लिए, पैच टूल का पाथ. स्ट्रिंग. |
patch_args |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
पैच टूल को पास करने के लिए तर्क. स्ट्रिंग की सूची. |
auth |
ज़रूरी नहीं.
यह डिफ़ॉल्ट तौर पर None पर सेट होता है
कुछ यूआरएल के लिए, पुष्टि करने की जानकारी देने वाला ऐसा डिक्शनरी जो ज़रूरी नहीं है. |
read_netrc
read_netrc(ctx, filename)
उपयोगिता फ़ंक्शन, जो कम से कम एक बुनियादी .netrc फ़ाइल को पार्स करता है.
पैरामीटर
ctx |
आवश्यक.
रिपॉज़िटरी के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस यूटिलिटी फ़ंक्शन को कॉल किया गया है. |
filename |
आवश्यक.
पढ़ने के लिए .netrc फ़ाइल का नाम |
सामान लौटाना
ऐसा कोडिंग है जिसमें मशीन के नाम को उसके बारे में दी गई जानकारी की मदद से मैप किया जाता है
read_user_netrc
read_user_netrc(ctx)
उपयोगकर्ता की डिफ़ॉल्ट netrc फ़ाइल पढ़ें.
पैरामीटर
ctx |
आवश्यक.
इस यूटिलिटी फ़ंक्शन को कॉल करने वाले रिपॉज़िटरी नियम का रिपॉज़िटरी संदर्भ. |
सामान लौटाना
ऐसा कोडिंग है जिसमें मशीन के नाम को उसके बारे में दी गई जानकारी की मदद से मैप किया जाता है.
update_attrs
update_attrs(orig, keys, override)
उपयोगिता फ़ंक्शन, डेटा स्टोर करने के किसी खास नियम को लागू करने के दौरान, खास एट्रिब्यूट में बदलाव करके उन्हें जोड़ता है.
इसका इस्तेमाल इसलिए किया जाता है, ताकि किसी नियम को दोबारा जनरेट किया जा सके.
पैरामीटर
orig |
आवश्यक.
किसी खास नियम को लागू करके, एट्रिब्यूट (साफ़ तौर पर या अनुमान से) सेट करने का |
keys |
आवश्यक.
इस नियम पर तय की गई विशेषताओं का पूरा सेट |
override |
आवश्यक.
ऑरिग में जोड़ने या बदलने के लिए एट्रिब्यूट का उच्चारण |
सामान लौटाना
शामिल किए गए/अपडेट किए गए बदलावों की कुंजियों के साथ एट्रिब्यूट का उच्चारण
use_netrc
use_netrc(netrc, urls, patterns)
किसी पार्स की गई netrc फ़ाइल और यूआरएल की सूची से, कोई ऑथेंटिकेशन प्रोसेस करें.
पैरामीटर
netrc |
आवश्यक.
ऐसी netrc फ़ाइल जिसे पहले से ही किसी शब्दकोश में पार्स किया गया हो. उदाहरण के लिए, read_netrc से |
urls |
आवश्यक.
सेट अप कर सकते हैं. |
patterns |
आवश्यक.
ऑथराइज़ेशन पैटर्न के लिए, यूआरएल का वैकल्पिक उच्चारण |
सामान लौटाना
ctx.download के लिए पुष्टि के तर्क के रूप में सही उच्चारण लिखा जा सकता है; ज़्यादा सटीक तौर पर, यह डिक्शनरी उन सभी यूआरएल को मैप करेगी जहां netrc फ़ाइल, उससे जुड़े लॉगिन, पासवर्ड, और वैकल्पिक ऑथराइज़ेशन पैटर्न के साथ लॉगिन और पासवर्ड उपलब्ध कराती है. साथ ही, "टाइप" को "बेसिक" या "पैटर्न" पर मैप करने की भी अनुमति देती है.
workspace_and_buildfile
workspace_and_buildfile(ctx)
वर्कस्पेस और अनुरोध किए जाने पर एक BUILD फ़ाइल बनाने के लिए इस्तेमाल होने वाली सुविधा.
इस नियम का इस्तेमाल, डेटा स्टोर करने की जगह के नियम को लागू करने के लिए किया जाता है.
यह मानकर चलता है कि ctx.attr
में name
, build_file
, build_file_content
, workspace_file
, और workspace_file_content
पैरामीटर मौजूद हैं. बाद के चार पैरामीटर, जिनके लिए कोई नहीं वैल्यू हो सकती है.
पैरामीटर
ctx |
आवश्यक.
रिपॉज़िटरी के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस यूटिलिटी फ़ंक्शन को कॉल किया गया है. |