कॉन्फ़िगरेशन

किसी समस्या की शिकायत करें सोर्स देखें Nightly · 7.4 . 7.3 · 7.2 · 7.1 · 7.0 · 6.5

यह कॉन्फ़िगरेशन ट्रांज़िशन और बिल्ड सेटिंग डिस्क्रिप्टर बनाने के लिए, टॉप-लेवल मॉड्यूल है. इससे यह पता चलता है कि कोई नियम किस तरह की बिल्ड सेटिंग है (अगर कोई है).

उदाहरण: rule() फ़ंक्शन के build_setting पैरामीटर को सेट करके, इस नियम को बिल्ड सेटिंग के तौर पर मार्क किया गया है. खास तौर पर, यह int टाइप की बिल्ड सेटिंग है और flag इसका मतलब है कि इस बिल्ड सेटिंग को कमांड लाइन पर कॉल किया जा सकता है.

  my_rule = rule(
    implementation = _impl,
    build_setting = config.int(flag = True),
    ...
  )

सदस्य

बूल

BuildSetting config.bool(flag=False)

बूल-टाइप की गई बिल्ड सेटिंग

पैरामीटर

पैरामीटर ब्यौरा
flag डिफ़ॉल्ट रूप से False
है इस बिल्ड सेटिंग को कमांड लाइन पर कॉल किया जा सकता है या नहीं.

एक्ज़ेक्यूटिव

ExecTransitionFactory config.exec(exec_group=None)

एक ट्रांज़िशन बनाता है.

पैरामीटर

पैरामीटर ब्यौरा
exec_group स्ट्रिंग या None; डिफ़ॉल्ट तौर पर None
उस एक्सेक्यूशन ग्रुप का नाम जिसका एक्सेक्यूशन प्लैटफ़ॉर्म इस ट्रांज़िशन में इस्तेमाल किया जाएगा. अगर यह सेटिंग उपलब्ध नहीं कराई गई है, तो यह एक्ज़ेक्यूटिव ट्रांज़िशन, टारगेट के डिफ़ॉल्ट एक्ज़ीक्यूशन प्लैटफ़ॉर्म का इस्तेमाल करेगा.

int

BuildSetting config.int(flag=False)

पूर्णांक टाइप वाली बिल्ड सेटिंग

पैरामीटर

पैरामीटर ब्यौरा
flag डिफ़ॉल्ट रूप से, यह False
होता है इससे यह तय होता है कि इस बिल्ड सेटिंग को कमांड-लाइन से कॉल किया जा सकता है या नहीं.

स्ट्रिंग

BuildSetting config.string(flag=False, allow_multiple=False)

स्ट्रिंग टाइप की बिल्ड सेटिंग

पैरामीटर

पैरामीटर ब्यौरा
flag डिफ़ॉल्ट रूप से False
है इस बिल्ड सेटिंग को कमांड लाइन पर कॉल किया जा सकता है या नहीं.
allow_multiple डिफ़ॉल्ट False
है यह सेटिंग अब काम नहीं करती. इसके बजाय, repeatable = True के साथ string_list सेटिंग का इस्तेमाल करें. अगर सेट है, तो इस फ़्लैग को कमांड लाइन पर कई बार सेट किया जा सकता है. ट्रांज़िशन और बिल्ड सेटिंग लागू करने वाले फ़ंक्शन में ऐक्सेस किए गए फ़्लैग की वैल्यू, स्ट्रिंग की सूची होगी. इंसर्शन ऑर्डर और दोहराई गई वैल्यू, दोनों को बनाए रखा जाता है. अगर आपको अलग तरह का व्यवहार चाहिए, तो इस सूची को बिल्ड सेटिंग लागू करने वाले फ़ंक्शन में पोस्ट-प्रोसेस किया जा सकता है.

string_list

BuildSetting config.string_list(flag=False, repeatable=False)

स्ट्रिंग सूची के टाइप की बिल्ड सेटिंग. कमांड लाइन पर, --//my/setting=foo,bar जैसे कॉमा लगाकर अलग किए गए मान का इस्तेमाल करके एक सूची पास करें.

पैरामीटर

पैरामीटर ब्यौरा
flag डिफ़ॉल्ट रूप से False
है इस बिल्ड सेटिंग को कमांड लाइन पर कॉल किया जा सकता है या नहीं.
repeatable डिफ़ॉल्ट रूप से False
है अगर यह वैल्यू सेट की जाती है, तो कॉमा लगाकर अलग की गई वैल्यू की उम्मीद न करें. इस फ़्लैग को कमांड लाइन पर कई बार सेट किया जा सकता है. इसमें हर वैल्यू को एक स्ट्रिंग के तौर पर सेट किया जाता है, ताकि उसे सूची की वैल्यू में जोड़ा जा सके. इंसर्शन ऑर्डर और दोहराई गई वैल्यू, दोनों बनाए रखे जाते हैं. अगर आपको अलग तरह का व्यवहार चाहिए, तो इस सूची को बिल्ड सेटिंग लागू करने वाले फ़ंक्शन में पोस्ट-प्रोसेस किया जा सकता है.