CKTIS / Python
TestResult: czterowierszowy raport z unittest
Uruchom zestaw testów i użyj zwróconego obiektu `TestResult`, aby podać liczbę rozpoczętych testów, niepowodzeń asercji i błędów oraz ogólny wynik uruchomienia.
Wersja: Python 3.12
Składnia
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()W Pythonie 3.12 unittest.TextTestRunner.run(suite) wykonuje zestaw testów i domyślnie zwraca obiekt TextTestResult, który jest podklasą TestResult. Zachowaj zwrócony obiekt, aby zbudować własny raport zamiast analizować tekst wypisywany przez mechanizm uruchamiający testy.
result.testsRun to liczba całkowita określająca, ile testów rozpoczęto, a nie ile zakończyło się pomyślnie ani ile zaplanowano. Test pominięty po zarejestrowaniu jego rozpoczęcia wlicza się do tej liczby. Błąd przygotowania klasy testowej może natomiast zostać zapisany bez rozpoczęcia któregokolwiek z jej testów.
result.failures i result.errors to listy, nie liczniki. Pierwsza zawiera niepowodzenia, takie jak niespełniona asercja assertEqual; druga zawiera błędy, takie jak nieoczekiwany ValueError. Każdy wpis to para: obiekt identyfikujący test i sformatowany ślad stosu w postaci tekstu. Użyj len(...), aby policzyć wpisy.
result.wasSuccessful() jest metodą, więc użyj nawiasów. Zwraca True tylko wtedy, gdy nie odnotowano niepowodzeń, błędów ani nieoczekiwanych sukcesów, czyli zaliczonych testów oznaczonych przez @unittest.expectedFailure. Pominięcia i oczekiwane niepowodzenia same w sobie nie powodują wyniku False.
Przykłady
import io
import unittest
class DemoTests(unittest.TestCase):
def test_pass(self):
self.assertEqual(2 + 2, 4)
def test_failure(self):
self.assertEqual(2 + 2, 5)
def test_error(self):
raise ValueError("demo error")
if __name__ == "__main__":
suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
with io.StringIO() as stream:
result = unittest.TextTestRunner(stream=stream).run(suite)
print(f"Tests run: {result.testsRun}")
print(f"Failures: {len(result.failures)}")
print(f"Errors: {len(result.errors)}")
print(f"Successful: {result.wasSuccessful()}")Wynik
Tests run: 3 Failures: 1 Errors: 1 Successful: False
Jeden test przechodzi, jeden nie spełnia asercji, a jeden zgłasza `ValueError`. Standardowy raport trafia do `io.StringIO`, więc w konsoli pojawiają się tylko cztery wiersze własnego raportu.
Powiązane lekcje
- Python · Lekcja 34 · Średniozaawansowany · Wersja: 3