डेटा स्टोर करने की जगह के नियमों का इस्तेमाल करता है

समस्या की शिकायत करें सोर्स देखें

ये फ़ंक्शन @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

download_remote_files(ctx, auth)

रिमोट फ़ाइलें डाउनलोड करने के लिए यूटिलिटी फ़ंक्शन.

इस नियम का इस्तेमाल, डेटा स्टोर करने के नियम को लागू करने के लिए किया जाना चाहिए. यह मान लेता है कि ctx.attr में remote_file_urls और remote_file_integrity पैरामीटर मौजूद हैं.

पैरामीटर

ctx	आवश्यक. रिपॉज़िटरी के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस यूटिलिटी फ़ंक्शन को कॉल किया गया है.
auth	ज़रूरी नहीं. यह डिफ़ॉल्ट तौर पर None पर सेट होता है कुछ यूआरएल के लिए, पुष्टि करने की जानकारी देने वाला ऐसा डिक्शनरी जो ज़रूरी नहीं है.

get_auth

get_auth(ctx, urls)

उपयोगिता फ़ंक्शन.

अगर उपलब्ध हो, तो वैकल्पिक netrc और auth_patterns एट्रिब्यूट के साथ भी एट्रिब्यूट जोड़ा जा सकता है.

पैरामीटर

ctx	आवश्यक. रिपॉज़िटरी के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस यूटिलिटी फ़ंक्शन को कॉल किया गया है.
urls	आवश्यक. पढ़ने के लिए यूआरएल की सूची

सामान लौटाना

अधिकार के बारे में बताने वाला निर्देश, जिसे रिपॉज़िटरी_ctx.download में भेजा जा सकता है

शायद

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	आवश्यक. रिपॉज़िटरी के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस यूटिलिटी फ़ंक्शन को कॉल किया गया है.