उपयोगकर्ता पैरामीटर

Android Comms Test Suite (ACTS) में, ACTS कॉन्फ़िगरेशन में जाकर टेस्ट की अतिरिक्त जानकारी या पैरामीटर की जानकारी दी जा सकती है. उपयोगकर्ता पैरामीटर, JSON के हिसाब से बने किसी भी फ़ॉर्मैट में हो सकते हैं. साथ ही, उन्हें Python में सही टाइप में डिकोड किया जा सकता है. जैसे, dict, list, और str. ऐसी दो जगहें होती हैं जहां उपयोगकर्ता पैरामीटर तय किए जा सकते हैं:

  • कॉन्फ़िगरेशन के रूट लेवल पर

    {
    "testbed": {
        ...
    },
    "my_user_param1": "my_value",
    "my_user_param2": {"another": ["value"]}
}

  • जांच के दौरान

    {
    "testbed": {
        "my_testbed": {
            "AndroidDevice": [...],
            ...,
            "my_user_param1": "my_value",
            "my_user_param2": {"another": ["value"]}
        }
    },
}

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

ACTS टेस्ट क्लास में लोग इसका इस्तेमाल करके इस जानकारी को पढ़ सकते हैं:

class MyActsTest
    def setup_class(self):
        self.my_param_1 = self.user_params['my_user_param1']

        # Get the parameter with a default value if not found within config.
        self.my_param_2 = self.user_params.get('my_user_param2', default={})

उपयोगकर्ता के लिए खास पैरामीटर

यहां ऐसे उपयोगकर्ता पैरामीटर की सूची दी गई है जो ज़रूरी नहीं हैं. ACTS में खास प्रॉपर्टी मौजूद हैं:

  • consecutive_failure_limit: एक ही टेस्ट क्लास में बचे हुए टेस्ट को ब्लॉक करने से पहले, टेस्ट फ़ेल होने की संख्या. अगर इसके बारे में नहीं बताया गया है, तो डिफ़ॉल्ट तौर पर यह काम होता है: सभी टेस्ट करना. भले ही, कोई गड़बड़ी न हो. यह पैरामीटर उन मामलों में काम आता है जहां टेस्टबेड को गलत तरीके से कॉन्फ़िगर किया गया है. इससे सभी टेस्ट फ़ेल हो जाते हैं.

  • quiet_tests: टेस्ट क्लास या टेस्ट केस की सूची, जो test_class या test_class.test_name फ़ॉर्मैट में दी गई है. उदाहरण के लिए, BleScanApiTest या BleScanApiTest.test_start_ble_scan_with_default_settings. इस सूची के हर टेस्ट केस में, टेस्ट फ़ेलियर से जुड़ा कोई आर्टफ़ैक्ट जनरेट नहीं होगा. उदाहरण के लिए, गड़बड़ी की रिपोर्ट, qxdm लॉग. अगर किसी टेस्ट क्लास का नाम बिना टेस्ट केस के दिया गया है, तो दी गई क्लास के सभी टेस्ट केस, गड़बड़ी की रिपोर्ट को छोड़कर आगे बढ़ने के लिए सेट हो जाते हैं. इस फ़्लैग का इस्तेमाल, टेस्ट के फ़ेल हो जाने वाले टेस्ट केस के लिए, आउटपुट को रोकने के लिए किया जा सकता है.

  • retry_tests: टेस्ट क्लास या टेस्ट केस की सूची, जो test_class या test_class.test_name फ़ॉर्मैट में दी गई है. उदाहरण के लिए, BleScanApiTest या BleScanApiTest.test_start_ble_scan_with_default_settings. इस सूची में दिए गए हर टेस्ट केस के लिए, अगर कोई टेस्ट फ़ेल होता है, तो एक बार फिर से कोशिश की जाती है. अगर जांच दूसरी बार फ़ेल होती है, तो उसे 'फ़ेल' के तौर पर मार्क किया जाता है.