template_ctx

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

सदस्य

आर्ग्युमेंट

Args template_ctx.args()

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

declare_file

File template_ctx.declare_file(filename, *, directory)

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

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

पैरामीटर

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

declare_subdirectory

File template_ctx.declare_subdirectory(subdirectory, *, directory)

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

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

पैरामीटर

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

रन

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

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

पैरामीटर

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

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

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

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