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

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

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

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

सदस्य

bool

BuildSetting config.bool(flag=False)

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

पैरामीटर

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

exec

ExecTransitionFactory config.exec(exec_group=None)

इससे एक्ज़ीक्यूशन ट्रांज़िशन बनता है.

पैरामीटर

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

int

BuildSetting config.int(flag=False)

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

पैरामीटर

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

string

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

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

पैरामीटर

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

string_list

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

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

पैरामीटर

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