template_ctx

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

सदस्य

आर्ग्युमेंट

Args template_ctx.args()

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

declare_file

File template_ctx.declare_file(filename, *, directory)

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

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

पैरामीटर

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

declare_subdirectory

File template_ctx.declare_subdirectory(subdirectory, *, directory)

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

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

पैरामीटर

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

रन

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
है बिल्ड के दौरान, उपयोगकर्ता को दिखाने के लिए प्रोग्रेस मैसेज.