ग्लोबल

पैसे चुकाकर बने सदस्य

• सभी
• analysis_test_transition
• कोई भी
• संग्रहित_बदलें
• जानकारी
• bazel_dep
• बाइंड
• bool
• config_field
• डेप्सेट
• शब्द
• dir
• एनूमरेट
• exec_group
• फ़ेल
• फ़्लोट
• getattr
• git_override
• hasattr
• हैश
• int
• लेन
• list
• local_path_override
• ज़्यादा से ज़्यादा
• मिनट
• मॉड्यूल
• module_extensions
• multiple_version_Override
• प्रिंट करें
• सेवा देने वाली कंपनी
• रेंज
• record_execution_platforms()
• record_execution_platforms()
• cancel_toolchains()
• cancel_toolchains()
• repository_rule(लागू करना, attr, लोकल, एनवायरमेंट, कॉन्फ़िगर, और बदला जा सकने वाला, दस्तावेज़)
• repository_rule(लागू करना, attr, लोकल, एनवायरमेंट, कॉन्फ़िगर, और बदला जा सकने वाला, दस्तावेज़)
• जवाब दें
• रिवर्स
• नियम
• चुनें
• single_version_Override
• क्रम से लगाया गया
• str
• tag_class
• टपल
• टाइप
• use_extensions
• use_repo
• किसको दिखे
• फ़ाइल फ़ोल्डर
• zip

सभी

bool all(elements)

all(["hello", 3, True]) == True
all([-1, 0, 1]) == False

पैरामीटर

विश्लेषण_टेस्ट_ट्रांज़िशन

transition analysis_test_transition(settings)

विश्लेषण-टेस्ट के नियम की डिपेंडेंसी पर लागू करने के लिए कॉन्फ़िगरेशन ट्रांज़िशन बनाता है. यह ट्रांज़िशन सिर्फ़ analysis_test = True के नियमों के एट्रिब्यूट पर लागू किया जा सकता है. ऐसे नियम क्षमताओं में प्रतिबंधित हैं (उदाहरण के लिए, उनके डिपेंडेंसी ट्री का आकार सीमित है), इसलिए इस फ़ंक्शन का इस्तेमाल करके बनाए गए ट्रांज़िशन, ट्रांज़िशन का इस्तेमाल करके बनाए गए ट्रांज़िशन की तुलना में संभावित दायरे में सीमित होते हैं.

यह फ़ंक्शन मुख्य रूप से विश्लेषण टेस्ट फ़्रेमवर्क को काम करने के लिए बनाया जाता है. सबसे सही तरीके जानने के लिए, इसके दस्तावेज़ (या इसे लागू करने से जुड़ा) देखें.

पैरामीटर

कोई भी

bool any(elements)

any([-1, 0, 1]) == True
any([False, 0, ""]) == False

पैरामीटर

संग्रहित_ओवरराइड करें

None archive_override(module_name, urls, integrity='', strip_prefix='', patches=[], patch_cmds=[], patch_strip=0)

पैरामीटर

आसपेक्ट

Aspect aspect(implementation, attr_aspects=[], attrs=None, required_providers=[], required_aspect_providers=[], provides=[], requires=[], fragments=[], host_fragments=[], toolchains=[], incompatible_use_toolchain_transition=False, doc='', *, apply_to_generating_rules=False, exec_compatible_with=[], exec_groups=None)

पैरामीटर

Bazel_dep

None bazel_dep(name, version='', repo_name='', dev_dependency=False)

पैरामीटर

बाइंड

None bind(name, actual=None)

चेतावनी: bind() के इस्तेमाल का सुझाव नहीं दिया जाता. समस्याओं और विकल्पों के बारे में ज़्यादा जानने के लिए, बाइंड हटाएं पर जाएं.

//external पैकेज में टारगेट को उपनाम देता है.

पैरामीटर

बूल

bool bool(x=False)

पैरामीटर

कॉन्फ़िगरेशन_फ़ील्ड

LateBoundDefault configuration_field(fragment, name)

इस्तेमाल का उदाहरण:

नियम की विशेषता तय करना:

'_foo': attr.label(default=configuration_field(fragment='java', name='toolchain'))

नियम लागू करने का ऐक्सेस:

  def _rule_impl(ctx):
    foo_info = ctx.attr._foo
    ...

पैरामीटर

डिसेट

depset depset(direct=None, order="default", *, transitive=None)

डिक्सेट के सभी एलिमेंट (डायरेक्ट और इनडायरेक्ट) एक ही तरह के होने चाहिए, जैसा कि एक्सप्रेशन type(x) में मिला है.

हैश-आधारित सेट का इस्तेमाल बार-बार होने वाले डुप्लीकेट को हटाने के लिए किया जाता है, इसलिए डिसेट के सभी एलिमेंट हैश किए जाने चाहिए. हालांकि, फ़िलहाल, सभी कंस्ट्रक्टर में इस वैरिएंट की जांच एक जैसी नहीं की जाती है. लगातार जांचने की सुविधा चालू करने के लिए, --insupported_always_check_depset_एलिमेंट फ़्लैग का इस्तेमाल करें; यह आगे की रिलीज़ में डिफ़ॉल्ट व्यवहार होगा; समस्या 10313 देखें.

इसके अलावा, फ़िलहाल एलिमेंट में बदलाव नहीं हो सकता. हालांकि, आने वाले समय में इस सीमा में छूट मिलेगी.

बनाए गए डेपसेट का ऑर्डर, उसके transitive डिसेट के क्रम के साथ काम करना चाहिए. "default" ऑर्डर किसी भी दूसरे ऑर्डर पर काम करता है. इसके अलावा, बाकी सभी ऑर्डर सिर्फ़ उनके साथ काम करते हैं.

नोट में पीछे/आगे जाने की सुविधा है. फ़िलहाल, यह फ़ंक्शन पोज़िशनल items पैरामीटर स्वीकार करता है. इसे रोका गया है. आने वाले समय में इसे हटा दिया जाएगा. इसके बाद, direct depset फ़ंक्शन का पोज़िशनल पैरामीटर बन जाएगा. इसलिए, ये दोनों कॉल एक जैसे हैं और आने वाले समय के लिए सुरक्षित हैं:

depset(['a', 'b'], transitive = [...])
depset(direct = ['a', 'b'], transitive = [...])

पैरामीटर

शब्द

dict dict(pairs=[], **kwargs)

पैरामीटर

Dir

list dir(x)

पैरामीटर

गिनती करो

list enumerate(list, start=0)

enumerate([24, 21, 84]) == [(0, 24), (1, 21), (2, 84)]

पैरामीटर

exec_group

exec_group exec_group(toolchains=[], exec_compatible_with=[], copy_from_rule=False)

पैरामीटर

फ़ेल

None fail(msg=None, attr=None, *args)

पैरामीटर

फ़्लोट

float float(x=unbound)

• अगर x पहले से ही फ़्लोट है, तो float इसे नहीं बदलता है.
• अगर x बूल है, तो float, True के लिए 1.0 और 'गलत' के लिए 0.0 दिखाता है.
• अगर x कोई पूर्णांक है, तो float सबसे पास के फ़्लोटिंग-पॉइंट की वैल्यू को x पर दिखाता है. अगर वैल्यू बहुत बड़ी होती है, तो गड़बड़ी दिखती है.
• अगर x एक स्ट्रिंग है, तो यह एक मान्य फ़्लोटिंग-पॉइंट लिटरल होना चाहिए या NaN (Inf), या Infinity के बराबर होना चाहिए. इसके आगे, + या - चिह्न होना चाहिए.

पैरामीटर

Getattr

unknown getattr(x, name, default=unbound)

getattr(ctx.attr, "myattr")
getattr(ctx.attr, "myattr", "mydefault")

पैरामीटर

git_Override

None git_override(module_name, remote, commit='', patches=[], patch_cmds=[], patch_strip=0)

पैरामीटर

Hasattr

bool hasattr(x, name)

hasattr(ctx.attr, "myattr")

पैरामीटर

हैश

int hash(value)

s[0] * (31^(n-1)) + s[1] * (31^(n-2)) + ... + s[n-1]

पैरामीटर

int

int int(x, base=unbound)

• अगर x पहले से ही int है, तो int इसे बिना किसी बदलाव के दिखाता है.
• अगर x बूल है, तो int, True के लिए 1 और 'गलत' के लिए 0 दिखाता है.
• अगर x एक स्ट्रिंग है, तो उसका फ़ॉर्मैट <sign><prefix><digits> होना चाहिए. <sign> या तो "+", "-" या खाली है (जिसे सही समझा जाता है). <digits>, 0 से लेकर base - 1 तक के अंकों का क्रम होते हैं, जिनमें a-z (या उसी तरह से A-Z) अक्षरों का इस्तेमाल 10-35 अंकों के लिए किया जाता है. base के 8/2/16 के मामले में, <prefix> ज़रूरी नहीं है. 0b/0o/0x (या इसके बराबर, 0B/0O/0X) हो सकता है. अगर इन आधारों या खास मान 0 के अलावा base कोई और वैल्यू है, तो प्रीफ़िक्स खाली होना चाहिए. जहां base 0 है, उस स्थिति में स्ट्रिंग को पूर्णांक लिटरल के तौर पर समझा जाता है. ऐसा इसलिए, क्योंकि अगर आधार का इस्तेमाल किया जाता है, तो 2/8/10/16 में से किसी एक आधार को चुना जाएगा. अगर base 0 है, तो प्रीफ़िक्स का इस्तेमाल नहीं किया जाता है और एक से ज़्यादा अंक होते हैं, तो पहला अंक 0 नहीं हो सकता. ऐसा करने से, ऑक्टल और दशमलव के बीच भ्रम की स्थिति से बचा जाता है. स्ट्रिंग से दिखाई गई संख्या, कितनी ही बड़ी होनी चाहिए, यह इंटेजर के लिए मंज़ूर की गई सीमा में होनी चाहिए.
• अगर x फ़्लोट है, तो int फ़्लोट का मान लौटाता है, जो शून्य की ओर पूर्णांक होता है. अगर x कोई सीमित नहीं (NaN या इनफ़िनिटी) है, तो यह एक गड़बड़ी है.

उदाहरण:

int("123") == 123
int("-123") == -123
int("+123") == 123
int("FF", 16) == 255
int("0xFF", 16) == 255
int("10", 0) == 10
int("-0x10", 0) == -16
int("-0x10", 0) == -16
int("123.456") == 123

पैरामीटर

लेन

int len(x)

पैरामीटर

सूची

list list(x=[])

list([1, 2]) == [1, 2]
list((2, 3, 2)) == [2, 3, 2]
list({5: "a", 2: "b", 4: "c"}) == [5, 2, 4]

पैरामीटर

local_path_Override

None local_path_override(module_name, path)

पैरामीटर

ज़्यादा से ज़्यादा

unknown max(*args)

max(2, 5, 4) == 5
max([5, 6, 3]) == 6

पैरामीटर

मि

unknown min(*args)

min(2, 5, 4) == 2
min([5, 6, 3]) == 3

पैरामीटर

मॉड्यूल

None module(name='', version='', compatibility_level=0, repo_name='', bazel_compatibility=[])

इसे ज़्यादा से ज़्यादा एक बार कॉल किया जाना चाहिए. इसे सिर्फ़ तभी छोड़ा जा सकता है, जब यह मॉड्यूल रूट मॉड्यूल हो (जैसे, अगर यह किसी दूसरे मॉड्यूल पर निर्भर न हो).

पैरामीटर

मॉड्यूल_एक्सटेंशन

unknown module_extension(implementation, *, tag_classes={}, doc='')

पैरामीटर

एकाधिक_वर्शन_ओवरराइड

None multiple_version_override(module_name, versions, registry='')

पैरामीटर

प्रिंट करें

None print(sep=" ", *args)

उपयोगकर्ताओं के लिए बनाए गए स्पैम की वजह से, प्रोडक्शन कोड में print का इस्तेमाल करने की सलाह नहीं दी जाती. समर्थन नहीं होने या रोके जाने के मामले में, fail() का इस्तेमाल करके हार्ड गड़बड़ी ढूंढें.

पैरामीटर

सामग्री देने वाले का नाम

unknown provider(doc='', *, fields=None, init=None)

MyInfo = provider()
...
def _my_library_impl(ctx):
    ...
    my_info = MyInfo(x = 2, y = 3)
    # my_info.x == 2
    # my_info.y == 3
    ...

सेवा देने वाली कंपनियों के इस्तेमाल के तरीके से जुड़ी पूरी जानकारी देने वाली गाइड के लिए, नियम (सेवा देने वाली कंपनी) देखें.

अगर init नहीं बताया गया है, तो Provider कॉल किया जा सकने वाला मान दिखाता है.

अगर init तय किया गया है, तो दो एलिमेंट का एक ट्यूपल रिटर्न करता है: Provider कॉल किया जा सकने वाला मान और एक रॉ कंस्ट्रक्टर कॉल किया जा सकने वाला वैल्यू. ज़्यादा जानकारी के लिए, नियम (कस्टम प्रोवाइडर का कस्टम शुरू करना) और init पैरामीटर पर चर्चा देखें.

पैरामीटर

MyInfo = provider()
m = MyInfo(foo = 1)

MyInfo, _new_myinfo = provider(init = ...)

सीमा

sequence range(start_or_stop, stop_or_none=None, step=1)

range(4) == [0, 1, 2, 3]
range(3, 9, 2) == [3, 5, 7]
range(3, 0, -1) == [3, 2, 1]

पैरामीटर

रजिस्टर_execution_platforms()

None register_execution_platforms(*platform_labels)

पैरामीटर

रजिस्टर_execution_platforms()

None register_execution_platforms(*platform_labels)

पैरामीटर

रजिस्टर_टूलचेन(())

None register_toolchains(*toolchain_labels)

पैरामीटर

रजिस्टर_टूलचेन(())

None register_toolchains(*toolchain_labels)

पैरामीटर

रिपॉज़िटरी_नियम(लागू करना, attr, लोकल, एनवायरमेंट, कॉन्फ़िगर करना, और बदलाव करने लायक, दस्तावेज़)

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc='')

पैरामीटर

रिपॉज़िटरी_नियम(लागू करना, attr, लोकल, एनवायरमेंट, कॉन्फ़िगर करना, और बदलाव करने लायक, दस्तावेज़)

callable repository_rule(implementation, *, attrs=None, local=False, environ=[], configure=False, remotable=False, doc='')

पैरामीटर

जवाब दें

string repr(x)

repr("ab") == '"ab"'

पैरामीटर

वापस किया गया

list reversed(sequence)

reversed([3, 5, 4]) == [4, 5, 3]

पैरामीटर

नियम

callable rule(implementation, test=False, attrs=None, outputs=None, executable=False, output_to_genfiles=False, fragments=[], host_fragments=[], _skylark_testable=False, toolchains=[], incompatible_use_toolchain_transition=False, doc='', *, provides=[], exec_compatible_with=[], analysis_test=False, build_setting=None, cfg=None, exec_groups=None, compile_one_filetype=None, name=None)

नियमों को .bzl फ़ाइल में ग्लोबल वैरिएबल को असाइन किया जाना चाहिए; ग्लोबल वैरिएबल का नाम नियम का नाम होता है.

टेस्ट के नियमों के लिए, _test से खत्म होने वाला नाम ज़रूरी है, जबकि बाकी सभी नियमों में यह सफ़िक्स नहीं होना चाहिए. (यह पाबंदी सिर्फ़ नियमों पर लागू होती है, उनके टारगेट पर नहीं.)

पैरामीटर

चुनें

unknown select(x, no_match_error='')

पैरामीटर

सिंगल_वर्शन_ओवरराइड

None single_version_override(module_name, version='', registry='', patches=[], patch_cmds=[], patch_strip=0)

पैरामीटर

क्रम से लगाएं

list sorted(iterable, *, key=None, reverse=False)

sorted([3, 5, 4]) == [3, 4, 5]

पैरामीटर

एसटीआर

string str(x)

str("ab") == "ab"
str(8) == "8"

पैरामीटर

टैग_क्लास

tag_class tag_class(attrs={}, *, doc='')

पैरामीटर

Tuple

tuple tuple(x=())

tuple([1, 2]) == (1, 2)
tuple((2, 3, 2)) == (2, 3, 2)
tuple({5: "a", 2: "b", 4: "c"}) == (5, 2, 4)

पैरामीटर

टाइप करें

string type(x)

type(2) == "int"
type([1]) == "list"
type(struct(a = 2)) == "struct"

if type(x) == type([]):  # if x is a list

पैरामीटर

यूज़_एक्सटेंशन

module_extension_proxy use_extension(extension_bzl_file, extension_name, *, dev_dependency=False)

पैरामीटर

इस्तेमाल_रिपो

None use_repo(extension_proxy, *args, **kwargs)

पैरामीटर

कैसा दिखाई दे

None visibility(value)

अभी .bzl मॉड्यूल की लोड होने की सेटिंग सेट करता है.

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

visibility() को हर .bzl फ़ाइल के लिए सिर्फ़ एक बार, और किसी फ़ंक्शन के अंदर नहीं, बल्कि सिर्फ़ टॉप लेवल पर कॉल किया जा सकता है. इस कॉल को load() स्टेटमेंट के ठीक नीचे और तर्क को तय करने के लिए ज़रूरी किसी भी तर्क को प्राथमिकता दी जाती है.

अगर फ़्लैग --check_bzl_visibility को 'गलत है' पर सेट किया जाता है, तो लोड 'किसको दिखे' के उल्लंघन होने पर चेतावनियां भेजी जाएंगी. हालांकि, ये बिल्ड सफल नहीं होंगे.

पैरामीटर

कार्यस्थान

None workspace(name)

इस फ़ंक्शन का इस्तेमाल सिर्फ़ WORKSPACE फ़ाइल में किया जा सकता है. WORKSPACE फ़ाइल में, दूसरे सभी फ़ंक्शन से पहले इसका एलान किया जाना चाहिए. हर WORKSPACE फ़ाइल में workspace फ़ंक्शन होना चाहिए.

इस फ़ाइल फ़ोल्डर का नाम सेट करता है. फ़ाइल फ़ोल्डर के नाम, Java-पैकेज की शैली में होने चाहिए.इसमें अंडरस्कोर का इस्तेमाल करके, सेपरेटर का इस्तेमाल करें. जैसे, github.com/bazelbuild/bazel में com_github_bazelbuild_bazel का इस्तेमाल किया जाना चाहिए.

इस नाम का इस्तेमाल उस डायरेक्ट्री के लिए किया जाता है जिसमें रिपॉज़िटरी की रनफ़ाइल सेव की जाती हैं. उदाहरण के लिए, अगर लोकल रिपॉज़िटरी में रन फ़ाइल foo/bar है और Workspace की फ़ाइल में workspace(name = 'baz') शामिल है, तो रन फ़ाइल mytarget.runfiles/baz/foo/bar में उपलब्ध होगी. अगर कोई फ़ाइल फ़ोल्डर नाम नहीं दिया गया है, तो रनफ़ाइल को bar.runfiles/foo/bar से जोड़ दिया जाएगा.

रिमोट (रिपॉज़िटरी) डेटा स्टोर करने की जगह के नियम के नाम, फ़ाइल फ़ोल्डर के मान्य नाम होने चाहिए. उदाहरण के लिए, आपके पास maven_jar(name = 'foo') हो सकता है, लेकिन maven_jar(name = 'foo%bar') नहीं, क्योंकि Bazel, maven_jar वाले workspace(name = 'foo%bar') के लिए एक Workspace फ़ाइल लिखने की कोशिश करेगा.

पैरामीटर

zip

list zip(*args)

zip()  # == []
zip([1, 2])  # == [(1,), (2,)]
zip([1, 2], [3, 4])  # == [(1, 3), (2, 4)]
zip([1, 2], [3, 4, 5])  # == [(1, 3), (2, 4)]

पैरामीटर