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