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

यहां दिए गए फ़ंक्शन यहां से लोड किए जा सकते हैं @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 आवश्यक.

डेटा स्टोर करने की जगह के नियम का डेटा स्टोर करने की जगह का कॉन्टेक्स्ट, जिसमें इस सुविधा को कॉल किया गया है फ़ंक्शन का इस्तेमाल करना होगा.