गिट रिपॉज़िटरी के नियम

7.3 · 7.2 · 7.1 · 7.0 · 6.5

ये फ़ंक्शन, @bazel_tools//tools/build_defs/repo:git.bzl से लोड किए जा सकते हैं.

git_repository

git_repository(name, branch, build_file, build_file_content, commit, init_submodules, patch_args,
               patch_cmds, patch_cmds_win, patch_tool, patches, recursive_init_submodules, remote,
               shallow_since, strip_prefix, tag, verbose, workspace_file, workspace_file_content)

किसी बाहरी Git डेटा स्टोर करने की जगह को क्लोन करना.

यह किसी Git रिपॉज़िटरी को क्लोन करता है, तय किए गए टैग की जांच करता है या कमिट करता है. साथ ही, अपने टारगेट को बाइंड करने के लिए उपलब्ध कराता है. साथ ही, चेक आउट किए गए टास्क का आईडी और उसकी तारीख भी तय करें. साथ ही, पैरामीटर के साथ एक डिसक्वेंट दिखाएं जो इस नियम का फिर से बनाया जा सकने वाला वर्शन उपलब्ध कराता हो (ज़रूरी नहीं है कि टैग ही ऐसा हो).

विशेषताएं

name नाम; ज़रूरी है

इस रिपॉज़िटरी के लिए कोई यूनीक नाम.

branch स्ट्रिंग; ज़रूरी नहीं

शाखा को चेक आउट किया जा सकता है. ब्रांच, टैग या कमिट में से किसी एक को सटीक रूप से बताया जाना चाहिए.

build_file लेबल; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए, BUILD फ़ाइल के तौर पर इस्तेमाल की जाने वाली फ़ाइल. यह एट्रिब्यूट एक एब्सोल्यूट लेबल है. मुख्य रिपॉज़िटरी के लिए, '@//' का इस्तेमाल करें. फ़ाइल का नाम BUILD होना ज़रूरी नहीं है. हालांकि, इसे BUILD रखा जा सकता है. जैसे, BUILD.new-repo-name, जिससे इसे रिपॉज़िटरी की असल BUILD फ़ाइलों से अलग किया जा सकता है. build_file या build_file_content में से किसी एक की जानकारी देना ज़रूरी है.

build_file_content स्ट्रिंग; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए BUILD फ़ाइल का कॉन्टेंट. build_file या build_file_content में से किसी एक की जानकारी देना ज़रूरी है.

commit स्ट्रिंग; ज़रूरी नहीं

खास कमिट को चेक आउट किया जा सकता है. ब्रैंच, टैग या कमिट में से किसी एक की जानकारी देना ज़रूरी है.

init_submodules बूलियन; ज़रूरी नहीं

डेटा स्टोर करने की जगह में सब-मॉड्यूल को क्लोन करना है या नहीं.

patch_args स्ट्रिंग की सूची; ज़रूरी नहीं

पैच टूल को दिए गए आर्ग्युमेंट. डिफ़ॉल्ट रूप से -p0 पर सेट होता है. हालांकि, git से जनरेट किए गए पैच के लिए आम तौर पर -p1 की ज़रूरत होगी. अगर एक से ज़्यादा -p आर्ग्युमेंट दिए जाते हैं, तो आखिरी आर्ग्युमेंट लागू होगा. अगर -p के अलावा कोई अन्य आर्ग्युमेंट दिया जाता है, तो Bazel, Bazel-नेटिव पैच लागू करने के बजाय, पैच कमांड लाइन टूल का इस्तेमाल करेगा. अगर पैच कमांड लाइन टूल का इस्तेमाल किया जा रहा है और patch_tool एट्रिब्यूट की वैल्यू नहीं दी गई है, तो `patch` का इस्तेमाल किया जाएगा.

patch_cmds स्ट्रिंग की सूची; वैकल्पिक

पैच लागू होने के बाद, Linux/Macos पर Bash कमांड का क्रम.

patch_cmds_win स्ट्रिंग की सूची; ज़रूरी नहीं

पैच लागू होने के बाद, Windows पर लागू किए जाने वाले Powershell निर्देशों का क्रम. अगर यह एट्रिब्यूट सेट नहीं है, तो patch_cmds को Windows पर चलाया जाएगा. इसके लिए, Bash बाइनरी मौजूद होनी चाहिए.

patch_tool स्ट्रिंग; ज़रूरी नहीं

इस्तेमाल करने के लिए पैच(1) की सुविधा. अगर यह जानकारी दी गई है, तो Bazel, Bazel के पैच लागू करने के बजाय, बताए गए पैच टूल का इस्तेमाल करेगा.

patches लेबल की सूची; ज़रूरी नहीं

उन फ़ाइलों की सूची जिन्हें संग्रह को निकालने के बाद, पैच के तौर पर लागू करना है. डिफ़ॉल्ट रूप से, यह Baज़ल-नेटिव पैच लागू करने की सुविधा का इस्तेमाल करता है, जो फ़ज़ मैच और बाइनरी पैच के साथ काम नहीं करता. हालांकि, अगर `patch_tool` एट्रिब्यूट के बारे में बताया गया है या `patch_orgs` एट्रिब्यूट में `-p` के अलावा कोई अन्य आर्ग्युमेंट हैं, तो Baज़र, पैच कमांड लाइन टूल का इस्तेमाल करने लगेगा.

recursive_init_submodules बूलियन; ज़रूरी नहीं

डेटा स्टोर करने की जगह में सब-मोड्यूल को बार-बार क्लोन करना है या नहीं.

remote स्ट्रिंग; आवश्यक है

रिमोट Git डेटा स्टोर करने की जगह का यूआरआई

shallow_since स्ट्रिंग; ज़रूरी नहीं

यह तारीख ज़रूरी नहीं है. यह तारीख, बताए गए कमिट के बाद की नहीं होनी चाहिए. अगर कोई टैग दिया गया है, तो इस आर्ग्युमेंट की अनुमति नहीं है. टैग की मदद से, डेप्थ 1 के साथ क्लोन किया जा सकता है. तय किए गए कमिट के आस-पास की तारीख सेट करने पर, रिपॉज़िटरी का ज़्यादा छोटा क्लोन बनाया जा सकता है. इससे बैंडविड्थ और समय की बचत होती है.

strip_prefix स्ट्रिंग; ज़रूरी नहीं

निकाली गई फ़ाइलों से हटाने के लिए, डायरेक्ट्री का प्रीफ़िक्स.

tag स्ट्रिंग; ज़रूरी नहीं

टैग को रिमोट रिपॉज़िटरी में चेक आउट किया गया है. ब्रैंच, टैग या कमिट में से किसी एक की जानकारी देना ज़रूरी है.

verbose बूलियन; ज़रूरी नहीं
workspace_file लेबल; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए, `WORKSPACE` फ़ाइल के तौर पर इस्तेमाल की जाने वाली फ़ाइल. `workspace_file` या `workspace_file_content`, दोनों में से किसी को बताया जा सकता है या दोनों में से कोई भी नहीं बताया जा सकता है.

workspace_file_content स्ट्रिंग; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए WORKSPACE फ़ाइल का कॉन्टेंट. `workspace_file` या `workspace_file_content`, दोनों में से किसी को बताया जा सकता है या दोनों में से कोई भी नहीं बताया जा सकता है.

new_git_repository

new_git_repository(name, branch, build_file, build_file_content, commit, init_submodules,
                   patch_args, patch_cmds, patch_cmds_win, patch_tool, patches,
                   recursive_init_submodules, remote, shallow_since, strip_prefix, tag, verbose,
                   workspace_file, workspace_file_content)

किसी बाहरी Git डेटा स्टोर करने की जगह को क्लोन करना.

यह किसी Git रिपॉज़िटरी को क्लोन करता है, तय किए गए टैग की जांच करता है या कमिट करता है. साथ ही, अपने टारगेट को बाइंड करने के लिए उपलब्ध कराता है. साथ ही, चेक आउट किए गए टास्क का आईडी और उसकी तारीख भी तय करें. साथ ही, पैरामीटर के साथ एक डिसक्वेंट दिखाएं जो इस नियम का फिर से बनाया जा सकने वाला वर्शन उपलब्ध कराता हो (ज़रूरी नहीं है कि टैग ही ऐसा हो).

विशेषताएं

name नाम; ज़रूरी है

इस रिपॉज़िटरी के लिए कोई यूनीक नाम.

branch स्ट्रिंग; ज़रूरी नहीं

ब्रांच में जाकर उससे चेक आउट किया जा सकता है. ब्रैंच, टैग या कमिट में से किसी एक की जानकारी देना ज़रूरी है.

build_file लेबल; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए, BUILD फ़ाइल के तौर पर इस्तेमाल की जाने वाली फ़ाइल. यह एट्रिब्यूट एक एब्सोल्यूट लेबल है. मुख्य रिपॉज़िटरी के लिए, '@//' का इस्तेमाल करें. फ़ाइल का नाम BUILD होना ज़रूरी नहीं है. हालांकि, इसे BUILD रखा जा सकता है. जैसे, BUILD.new-repo-name, जिससे इसे रिपॉज़िटरी की असल BUILD फ़ाइलों से अलग किया जा सकता है. build_file या build_file_content में से किसी एक की जानकारी देना ज़रूरी है.

build_file_content स्ट्रिंग; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए BUILD फ़ाइल का कॉन्टेंट. build_file या build_file_content में से किसी एक की जानकारी देना ज़रूरी है.

commit स्ट्रिंग; ज़रूरी नहीं

खास कमिट को चेक आउट किया जा सकता है. ब्रैंच, टैग या कमिट में से किसी एक की जानकारी देना ज़रूरी है.

init_submodules बूलियन; ज़रूरी नहीं

डेटा स्टोर करने की जगह में सब-मॉड्यूल को क्लोन करना है या नहीं.

patch_args स्ट्रिंग की सूची; ज़रूरी नहीं

पैच टूल को दिए गए आर्ग्युमेंट. डिफ़ॉल्ट रूप से -p0 पर सेट होता है. हालांकि, git से जनरेट किए गए पैच के लिए आम तौर पर -p1 की ज़रूरत होगी. अगर एक से ज़्यादा -p आर्ग्युमेंट दिए जाते हैं, तो आखिरी आर्ग्युमेंट लागू होगा. अगर -p के अलावा कोई अन्य आर्ग्युमेंट दिया जाता है, तो Bazel, Bazel-नेटिव पैच लागू करने के बजाय, पैच कमांड लाइन टूल का इस्तेमाल करेगा. अगर पैच कमांड लाइन टूल का इस्तेमाल किया जा रहा है और patch_tool एट्रिब्यूट की वैल्यू नहीं दी गई है, तो `patch` का इस्तेमाल किया जाएगा.

patch_cmds स्ट्रिंग की सूची; वैकल्पिक

पैच लागू होने के बाद, Linux/Macos पर Bash कमांड का क्रम.

patch_cmds_win स्ट्रिंग की सूची; ज़रूरी नहीं

पैच लागू होने के बाद, Windows पर लागू किए जाने वाले Powershell निर्देशों का क्रम. अगर यह एट्रिब्यूट सेट नहीं है, तो patch_cmds को Windows पर चलाया जाएगा. इसके लिए, Bash बाइनरी मौजूद होनी चाहिए.

patch_tool स्ट्रिंग; ज़रूरी नहीं

इस्तेमाल की जाने वाली पैच(1) सुविधा. अगर यह जानकारी दी गई है, तो Bazel, Bazel के पैच लागू करने के बजाय, बताए गए पैच टूल का इस्तेमाल करेगा.

patches लेबल की सूची; ज़रूरी नहीं

उन फ़ाइलों की सूची जिन्हें संग्रह को निकालने के बाद, पैच के तौर पर लागू करना है. डिफ़ॉल्ट रूप से, यह Baज़ल-नेटिव पैच लागू करने की सुविधा का इस्तेमाल करता है, जो फ़ज़ मैच और बाइनरी पैच के साथ काम नहीं करता. हालांकि, अगर `patch_tool` एट्रिब्यूट के बारे में बताया गया है या `patch_orgs` एट्रिब्यूट में `-p` के अलावा कोई अन्य आर्ग्युमेंट हैं, तो Baज़र, पैच कमांड लाइन टूल का इस्तेमाल करने लगेगा.

recursive_init_submodules बूलियन; ज़रूरी नहीं

डेटा स्टोर करने की जगह में सब-मोड्यूल को बार-बार क्लोन करना है या नहीं.

remote स्ट्रिंग; आवश्यक है

रिमोट Git डेटा स्टोर करने की जगह का यूआरआई

shallow_since स्ट्रिंग; ज़रूरी नहीं

यह तारीख ज़रूरी नहीं है. यह तारीख, बताए गए कमिट के बाद की नहीं होनी चाहिए. अगर कोई टैग दिया गया है, तो इस आर्ग्युमेंट की अनुमति नहीं है. टैग की मदद से, डेप्थ 1 के साथ क्लोन किया जा सकता है. तय किए गए कमिट के आस-पास की तारीख सेट करने पर, रिपॉज़िटरी का ज़्यादा छोटा क्लोन बनाया जा सकता है. इससे बैंडविड्थ और समय की बचत होती है.

strip_prefix स्ट्रिंग; ज़रूरी नहीं

निकाली गई फ़ाइलों से हटाने के लिए, डायरेक्ट्री का प्रीफ़िक्स.

tag स्ट्रिंग; ज़रूरी नहीं

टैग को रिमोट रिपॉज़िटरी में चेक आउट किया गया है. ब्रैंच, टैग या कमिट में से किसी एक की जानकारी देना ज़रूरी है.

verbose बूलियन; ज़रूरी नहीं
workspace_file लेबल; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए, `WORKSPACE` फ़ाइल के तौर पर इस्तेमाल की जाने वाली फ़ाइल. `workspace_file` या `workspace_file_content` में से किसी एक का इस्तेमाल किया जा सकता है. इसके अलावा, दोनों का इस्तेमाल नहीं किया जा सकता.

workspace_file_content स्ट्रिंग; ज़रूरी नहीं

इस रिपॉज़िटरी के लिए WORKSPACE फ़ाइल का कॉन्टेंट. `workspace_file` या `workspace_file_content` में से किसी एक का इस्तेमाल किया जा सकता है. इसके अलावा, दोनों का इस्तेमाल नहीं किया जा सकता.