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

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

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