template_ctx

यह एक कॉन्टेक्स्ट ऑब्जेक्ट है, जिसे ऐक्शन टेंप्लेट के एक्सपैंशन फ़ंक्शन में पास किया जाता है.

सदस्य

आर्ग्युमेंट

Args template_ctx.args()

यह एक Args ऑब्जेक्ट दिखाता है. इसका इस्तेमाल, मेमोरी के हिसाब से कम जगह लेने वाली कमांड लाइन बनाने के लिए किया जा सकता है.

declare_file

File template_ctx.declare_file(filename, *, directory)

इससे पता चलता है कि लागू करने की प्रोसेस, बताई गई डायरेक्ट्री में दिए गए फ़ाइल नाम से एक फ़ाइल बनाती है.

ध्यान रखें कि फ़ाइल की जानकारी देने के अलावा, आपको एक ऐसा ऐक्शन भी बनाना होगा जो फ़ाइल को एमिट करता हो. वह ऐक्शन बनाने के लिए, आपको दिखाए गए File ऑब्जेक्ट को ऐक्शन के कंस्ट्रक्शन फ़ंक्शन में पास करना होगा.

पैरामीटर

पैरामीटर ब्यौरा
filename string; ज़रूरी है
डायरेक्ट्री में मौजूद फ़ाइल का रेलेटिव पाथ.
directory फ़ाइल; ज़रूरी है
वह डायरेक्ट्री जिसमें फ़ाइल बनाई जानी चाहिए.

रन

None template_ctx.run(*, outputs, inputs=[], executable, tools=None, arguments=[], progress_message=None)

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

पैरामीटर

पैरामीटर ब्यौरा
outputs फ़ाइलों का क्रम; ज़रूरी है
ऐक्शन की आउटपुट फ़ाइलों की सूची.
inputs फ़ाइलों का क्रम; या depset; डिफ़ॉल्ट वैल्यू []
है ऐक्शन की इनपुट फ़ाइलों की सूची या depset.
executable File; या string; या FilesToRunProvider; ज़रूरी है
वह एक्ज़ीक्यूटेबल फ़ाइल जिसे ऐक्शन से कॉल किया जाना है.
tools sequence; या depset; या None; डिफ़ॉल्ट वैल्यू None
है ऐक्शन के लिए ज़रूरी किसी भी टूल की सूची या depset. टूल, एक्ज़ीक्यूटेबल इनपुट होते हैं. इनकी अपनी रनफ़ाइलें हो सकती हैं. ये रनफ़ाइलें, ऐक्शन के लिए अपने-आप उपलब्ध हो जाती हैं.

अगर कोई सूची दी जाती है, तो यह अलग-अलग तरह के कलेक्शन हो सकते हैं:

  • Files
  • FilesToRunProvider इंस्टेंस
  • Files के depset
Files from ctx.executable और सूची में सीधे तौर पर मौजूद FilesToRunProviders की रनफ़ाइलें अपने-आप जुड़ जाएंगी. सभी टूल, इनपुट के तौर पर अपने-आप जुड़ जाते हैं.

arguments sequence; डिफ़ॉल्ट वैल्यू []
है ऐक्शन के कमांड लाइन आर्ग्युमेंट. यह स्ट्रिंग या actions.args() ऑब्जेक्ट की सूची होनी चाहिए.
progress_message string; या None; डिफ़ॉल्ट वैल्यू None
है बिल्ड के दौरान, उपयोगकर्ता को दिखाने के लिए प्रोग्रेस मैसेज.