פרמטרים של משתמשים

ב-Android Comms Test Suite (ACTS) ניתן לציין מידע או פרמטרים נוספים של בדיקות מתוך הגדרת ACTS. פרמטרים של משתמשים יכולים להיות בכל פורמט שתואם ל-JSON, והם מקודדים לסוג המתאים ב-Python (לדוגמה, dict,‏ list ו-str). יש שני מקומות שבהם אפשר לציין פרמטרים של משתמשים:

  • ברמת הבסיס (root) של קובץ התצורה

    {
    "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"]}
        }
    },
}

אם פרמטר משתמש נמצא ברמת הבסיס (root) וגם במעבדת הבדיקה, המערכת תשתמש בערך הספציפי למעבדת הבדיקה.

בכיתה של בדיקת 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. לכל תרחיש בדיקה ברשימה הזו לא ייוצרו פריטי מידע שנוצרו בתהליך פיתוח (artifacts) של כשל בבדיקה (לדוגמה, דוחות באגים, יומני qxdm). אם יצוין שם של מחלקת בדיקה ללא תרחיש בדיקה, כל תרחישי הבדיקה במחלקה הזו יוגדרו לדלג על דוחות באגים. אפשר להשתמש בדגל הזה כדי להסתיר את הפלט במקרים של מקרי בדיקה בעייתיים שצפויים להיכשל.

  • retry_tests: רשימה של כיתות הבדיקה או מקרי הבדיקה שצוינו בפורמט test_class או test_class.test_name, לדוגמה BleScanApiTest או BleScanApiTest.test_start_ble_scan_with_default_settings. לכל מקרה בדיקה ברשימה הזו, אם בדיקה נכשלת, מתבצע ניסיון חוזר פעם אחת. אם הבדיקה נכשלת בפעם השנייה, היא מסומנת ככישלון.