Parametry użytkownika

W pakiecie Android Comms Test Suite (ACTS) dodatkowe informacje lub parametry testowe można określić z poziomu konfiguracji ACTS. Parametry użytkownika mogą być w dowolnym formacie zgodnym z JSON i są dekodowane do odpowiedniego typu w Pythonie (na przykład dict , list i str ). Parametry użytkownika można określić w dwóch miejscach:

  • Na poziomie głównym konfiguracji

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

  • Na stanowisku testowym

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

Jeśli parametr użytkownika zostanie znaleziony na poziomie głównym i w środowisku testowym, zostanie użyta wartość specyficzna dla środowiska testowego.

Podczas zajęć testowych ACTS użytkownicy mogą przeczytać te informacje, korzystając z następujących metod:

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={})

Specjalne parametry użytkownika

Poniżej znajduje się lista przydatnych opcjonalnych parametrów użytkownika, które mają specjalne właściwości w ACTS:

  • consecutive_failure_limit : Liczba kolejnych niepowodzeń testów, do których należy dopuścić przed zablokowaniem pozostałych testów w tej samej klasie testów. Jeśli nie określono, domyślnym zachowaniem jest uruchomienie wszystkich testów, niezależnie od błędów. Parametr ten jest przydatny w przypadkach, gdy stanowisko testowe jest nieprawidłowo skonfigurowane, co powoduje niepowodzenie wszystkich testów.

  • quiet_tests : Lista klas testowych lub przypadków testowych określonych w formacie test_class lub test_class . test_name , na przykład BleScanApiTest lub BleScanApiTest.test_start_ble_scan_with_default_settings . W każdym przypadku testowym na tej liście nie zostaną wygenerowane żadne artefakty niepowodzenia testu (na przykład raporty o błędach, dzienniki qxdm). Jeśli nazwa klasy testowej zostanie podana bez przypadku testowego, wszystkie przypadki testowe w danej klasie zostaną ustawione tak, aby pomijały raporty o błędach. Tej flagi można użyć do wstrzymania wyników w przypadku problematycznych przypadków testowych, w przypadku których oczekuje się niepowodzenia.

  • retry_tests : Lista klas testowych lub przypadków testowych określonych w formacie test_class lub test_class . test_name , na przykład BleScanApiTest lub BleScanApiTest.test_start_ble_scan_with_default_settings . W przypadku każdego przypadku testowego na tej liście, jeśli test zakończy się niepowodzeniem, zostanie on ponowiony jeden raz. Jeśli test zakończy się niepowodzeniem po raz drugi, zostanie to oznaczone jako niepowodzenie.