Parametry użytkownika

W pakiecie Android Comms Test Suite (ACTS) można określić dodatkowe informacje lub parametry testu w konfiguracji ACTS. Parametry użytkownika mogą mieć dowolny format zgodny z JSON i są dekodowane do odpowiedniego typu w Pythonie (np. dict, list i str). Parametry użytkownika można określić w 2 miejscach:

  • Na poziomie głównym konfiguracji

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

  • W ramach testów

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

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

W klasie testu ACTS użytkownicy mogą odczytać te informacje za pomocą:

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

Oto lista przydatnych opcjonalnych parametrów użytkownika, które mają specjalne właściwości w ACTS:

  • consecutive_failure_limit: liczba kolejnych nieudanych prób testu, które mogą wystąpić przed zablokowaniem pozostałych testów w tej samej klasie testów. Jeśli nie określisz tego ustawienia, domyślnie zostaną uruchomione wszystkie testy, niezależnie od błędów. Ten parametr jest przydatny w przypadku nieprawidłowej konfiguracji środowiska testowego, która powoduje niepowodzenie wszystkich testów.

  • quiet_tests: lista klas testów lub przypadków testowych określona w formacie test_class lub test_class.test_name, na przykład BleScanApiTest lub BleScanApiTest.test_start_ble_scan_with_default_settings. W żadnym przypadku testowego na tej liście nie zostaną wygenerowane żadne artefakty błędu testu (na przykład raporty o błędach czy logi qxdm). Jeśli podana jest nazwa klasy testu bez przypadku testowego, wszystkie przypadki testowe w danej klasie są ustawione tak, aby pomijać raporty o błędach. Ten parametr może służyć do pomijania danych wyjściowych w przypadku problematycznych przypadków testowych, które mają się nie powieść.

  • retry_tests: lista klas testów lub przypadków testowych określona w formacie test_class lub test_class.test_name, na przykład BleScanApiTest lub BleScanApiTest.test_start_ble_scan_with_default_settings. Jeśli test nie powiedzie się, jest on powtarzany jeden raz w przypadku każdego przypadku testowego na tej liście. Jeśli test nie powiedzie się po raz drugi, zostanie oznaczony jako nieudany.