यह कॉन्फ़िगरेशन ट्रांज़िशन और बिल्ड सेटिंग डिस्क्रिप्टर बनाने के लिए, टॉप-लेवल मॉड्यूल है. इससे यह पता चलता है कि कोई नियम किस तरह की बिल्ड सेटिंग है (अगर कोई है).
उदाहरण: rule() फ़ंक्शन के build_setting पैरामीटर को सेट करके, नीचे दिए गए नियम को बिल्ड सेटिंग के तौर पर मार्क किया गया है. खास तौर पर, यह int टाइप की एक बिल्ड सेटिंग है और यह flag है. इसका मतलब है कि इस बिल्ड सेटिंग को कमांड लाइन पर कॉल किया जा सकता है.
my_rule = rule(
implementation = _impl,
build_setting = config.int(flag = True),
...
)सदस्य
बूल
BuildSetting config.bool(flag=False)
पैरामीटर
| पैरामीटर | ब्यौरा |
|---|---|
flag
|
bool;
डिफ़ॉल्ट रूप से Falseपर सेट होती है यह सेटिंग, कमांड लाइन से कॉल की जा सकती है या नहीं. |
exec
ExecTransitionFactory config.exec(exec_group=None)
पैरामीटर
| पैरामीटर | ब्यौरा |
|---|---|
exec_group
|
स्ट्रिंग या None;
डिफ़ॉल्ट तौर पर Noneउस एक्सेक्यूशन ग्रुप का नाम जिसका एक्सेक्यूशन प्लैटफ़ॉर्म इस ट्रांज़िशन का इस्तेमाल करेगा. अगर यह जानकारी नहीं दी जाती है, तो यह एक्सेक्यूशन ट्रांज़िशन, टारगेट के डिफ़ॉल्ट एक्सेक्यूशन प्लैटफ़ॉर्म का इस्तेमाल करेगा. |
int
BuildSetting config.int(flag=False)
पैरामीटर
| पैरामीटर | ब्यौरा |
|---|---|
flag
|
bool;
डिफ़ॉल्ट रूप से Falseपर सेट होती है यह बताता है कि इस बिल्ड सेटिंग को कमांड लाइन से कॉल किया जा सकता है या नहीं. |
कोई नहीं
transition config.none()
स्ट्रिंग
BuildSetting config.string(flag=False, allow_multiple=False)
पैरामीटर
| पैरामीटर | ब्यौरा |
|---|---|
flag
|
bool;
डिफ़ॉल्ट रूप से Falseपर सेट होती है यह सेटिंग, कमांड लाइन से कॉल की जा सकती है या नहीं. |
allow_multiple
|
bool;
डिफ़ॉल्ट रूप से Falseहोता है इस्तेमाल नहीं किया जा सकता. इसके बजाय, repeatable = True के साथ string_list सेटिंग का इस्तेमाल करें. अगर यह फ़्लैग सेट है, तो कमांड लाइन पर इसे कई बार सेट किया जा सकता है. ट्रांज़िशन और बिल्ड सेटिंग लागू करने वाले फ़ंक्शन में ऐक्सेस किए गए फ़्लैग की वैल्यू, स्ट्रिंग की सूची होगी. इंसर्शन ऑर्डर और दोहराई गई वैल्यू, दोनों को बनाए रखा जाता है. अगर आपको अलग तरह का व्यवहार चाहिए, तो इस सूची को बिल्ड सेटिंग लागू करने वाले फ़ंक्शन में पोस्ट-प्रोसेस किया जा सकता है.
|
string_list
BuildSetting config.string_list(flag=False, repeatable=False)
--//my/setting=foo,bar.
पैरामीटर
| पैरामीटर | ब्यौरा |
|---|---|
flag
|
bool;
डिफ़ॉल्ट रूप से Falseपर सेट होती है यह बताता है कि इस बिल्ड सेटिंग को कमांड लाइन से कॉल किया जा सकता है या नहीं. |
repeatable
|
bool;
डिफ़ॉल्ट रूप से Falseहै अगर सेट किया जाता है, तो कॉमा से अलग की गई वैल्यू के बजाय, इस फ़्लैग को कमांड लाइन पर कई बार सेट किया जा सकता है. साथ ही, सूची की वैल्यू में जोड़ने के लिए, हर वैल्यू को एक स्ट्रिंग के तौर पर माना जाता है. इंसर्शन ऑर्डर और दोहराई गई वैल्यू, दोनों को बनाए रखा जाता है. अगर आपको अलग तरह का व्यवहार चाहिए, तो इस सूची को बिल्ड सेटिंग लागू करने वाले फ़ंक्शन में पोस्ट-प्रोसेस किया जा सकता है. |
टारगेट
transition config.target()
attr.label() में cfg = "target" के बराबर.