टेस्ट हो रहा है

Starlark के लिए, टेस्टिंग इन्फ़्रास्ट्रक्चर को ऐक्सेस करने के हेल्पर तरीके.

सदस्य

• analysis_test
• ExecutionInfo
• TestEnvironment

analysis_test

None testing.analysis_test(name, implementation, attrs={}, fragments=[], toolchains=[], attr_values={})

विश्लेषण के लिए, नया टेस्ट टारगेट बनाता है.

टेस्ट की ट्रांज़िटिव डिपेंडेंसी की संख्या सीमित होती है. यह सीमा, --analysis_testing_deps_limit फ़्लैग से कंट्रोल की जाती है.

पैरामीटर

पैरामीटर	ब्यौरा
name	ज़रूरी है टारगेट का नाम. यह Starlark आइडेंटिफ़ायर होना चाहिए, जो '[A-Za-z_][A-Za-z0-9_]*' पैटर्न से मेल खाता हो.
implementation	ज़रूरी है यह Starlark फ़ंक्शन, विश्लेषण के इस टेस्ट को लागू करता है. इसमें सिर्फ़ एक पैरामीटर होना चाहिए: ctx. फ़ंक्शन को विश्लेषण के फ़ेज़ के दौरान कॉल किया जाता है. यह attrs से तय किए गए एट्रिब्यूट को ऐक्सेस कर सकता है. साथ ही, attr_values के ज़रिए पॉप्युलेट किए गए एट्रिब्यूट को भी ऐक्सेस कर सकता है. लागू करने वाला फ़ंक्शन, कार्रवाइयां रजिस्टर नहीं कर सकता. इसके बजाय, इसे AnalysisTestResultInfo उपलब्ध कराकर, पास/फ़ेल का नतीजा रजिस्टर करना होगा.
attrs	dict; डिफ़ॉल्ट वैल्यू {} यह डिक्शनरी, एट्रिब्यूट की जानकारी देती है. नियम को कॉल करना देखें. एट्रिब्यूट, analysis_test_transition का इस्तेमाल करके तय किए गए कॉन्फ़िगरेशन ट्रांज़िशन का इस्तेमाल कर सकते हैं.
fragments	स्ट्रिंग का क्रम; डिफ़ॉल्ट वैल्यू [] है यह कॉन्फ़िगरेशन के उन फ़्रैगमेंट की सूची है जो विश्लेषण के टेस्ट को लागू करने के लिए उपलब्ध हैं.
toolchains	sequence; डिफ़ॉल्ट वैल्यू [] है यह टूल चेन का वह सेट है जिसकी टेस्ट के लिए ज़रूरत होती है. नियम को कॉल करना देखें.
attr_values	स्ट्रिंग की डिक्शनरी; डिफ़ॉल्ट वैल्यू {} है यह एट्रिब्यूट की वैल्यू की डिक्शनरी है, जिसे लागू करने के लिए पास किया जाता है.

ExecutionInfo

ExecutionInfo testing.ExecutionInfo(requirements={}, exec_group='test')

testing.ExecutionInfo प्रोवाइडर की कुंजी/कंस्ट्रक्टर

TestEnvironment

RunEnvironmentInfo testing.TestEnvironment(environment, inherited_environment=[])

इस्तेमाल करने की सलाह नहीं दी जाती: इसके बजाय, RunEnvironmentInfo का इस्तेमाल करें. टेस्ट एनवायरमेंट का नया प्रोवाइडर बनाता है. टेस्ट के दौरान उपलब्ध कराए जाने वाले, एनवायरमेंट के अतिरिक्त वैरिएबल तय करने के लिए, इस प्रोवाइडर का इस्तेमाल करें.

पैरामीटर

पैरामीटर	ब्यौरा
environment	ज़रूरी है यह स्ट्रिंग की कुंजियों और वैल्यू का मैप है. यह एनवायरमेंट वैरिएबल और उनकी वैल्यू दिखाता है. ये वैरिएबल, टेस्ट के दौरान उपलब्ध कराए जाएंगे.
inherited_environment	स्ट्रिंग का क्रम; डिफ़ॉल्ट वैल्यू [] है यह एनवायरमेंट वैरिएबल के नामों का क्रम है. ये वैरिएबल, टेस्ट के दौरान उपलब्ध कराए जाते हैं. इनकी मौजूदा वैल्यू, शेल एनवायरमेंट से ली जाती है. अगर कोई वैरिएबल, environment और inherited_environment, दोनों में शामिल है, तो शेल एनवायरमेंट से मिली वैल्यू को प्राथमिकता दी जाएगी.