ग्लोबल

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

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

सभी

bool all(elements)

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

पैरामीटर

विश्लेषण_test_transition

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 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)

पैरामीटर

दीर

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

पैरामीटर

Lens

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 कॉल करने लायक वैल्यू और RAW कंस्ट्रक्टर कॉल करने लायक वैल्यू. नियम बनाने वाली कंपनी (कस्टम सेवा देने वाली कंपनियों के हिसाब से शुरू करने की सुविधा) के नियम और नीचे 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 फ़ाइल में ग्लोबल वैरिएबल के लिए नियम असाइन किए जाने चाहिए; ग्लोबल वैरिएबल का नाम नियम's का नाम है.

जांच के नियमों के नाम में खत्म होने वाला _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]

पैरामीटर

str

string str(x)

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

पैरामीटर

Tag_class

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

पैरामीटर

टपल

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

पैरामीटर

Use_extensions का उपयोग करें

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

पैरामीटर

Use_repo

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

पैरामीटर

कैसा दिखाई दे

None visibility(value)

.bzl मॉड्यूल की bzl-विज़िबिलिटी अभी सेट की जाती है.

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

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

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

पैरामीटर

कार्यस्थान

None workspace(name)

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

इस फ़ाइल फ़ोल्डर का नाम सेट करता है. Workspace के नामों में, प्रोजेक्ट का Java-package का ब्यौरा होना चाहिए.इसमें सेपरेटर के तौर पर अंडरस्कोर का इस्तेमाल किया जाना चाहिए. उदाहरण के लिए, 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') नहीं, क्योंकि बैज़ेल 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)]

पैरामीटर