CKTIS / Python
Uruchamianie testów i odczytywanie wyniku `TextTestRunner.run`
Uruchom zestaw testów lub pojedynczy przypadek testowy, a następnie użyj zwróconego obiektu `TestResult`, aby przygotować własne podsumowanie bez analizowania raportu tekstowego.
Wersja: Python 3.12
Składnia
runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()W Pythonie 3.12 metoda unittest.TextTestRunner.run przyjmuje obiekt TestSuite lub TestCase, wykonuje przekazane testy i zwraca obiekt TestResult (domyślnie TextTestResult). Niezależnie od zwracanego obiektu runner zapisuje raport tekstowy do strumienia ustawionego przez stream; domyślnie jest to sys.stderr.
result.testsRun to liczba rozpoczętych testów, a nie liczba testów zaliczonych ani zaplanowanych. result.failures i result.errors to listy par (test, sformatowany ślad stosu). Niespełniona asercja, np. self.assertEqual(...), trafia do failures, a nieoczekiwany wyjątek, np. ValueError opuszczający metodę testową, trafia do errors. Użyj len(...), aby policzyć wpisy na każdej liście.
result.wasSuccessful() zwraca True, jeśli nie odnotowano niepowodzeń, błędów ani nieoczekiwanych sukcesów. Nieoczekiwany sukces to zaliczenie testu oznaczonego przez @unittest.expectedFailure. Pominięte testy i oczekiwane niepowodzenia same w sobie nie dają False. Nie zastępuj tej metody sprawdzaniem tylko dwóch list i nie traktuj True jako dowodu, że uruchomiono jakikolwiek test.
Przykłady
import io
import unittest
class ArithmeticTests(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("intentional test error")
if __name__ == "__main__":
suite = unittest.TestSuite([
ArithmeticTests("test_pass"),
ArithmeticTests("test_failure"),
ArithmeticTests("test_error"),
])
report_stream = io.StringIO()
result = unittest.TextTestRunner(stream=report_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 kończy się niepowodzeniem asercji, a jeden błędem. `io.StringIO()` przechwytuje standardowy raport runnera, w tym czas wykonania, więc na konsoli pojawia się tylko własne czterowierszowe podsumowanie.
Powiązane lekcje
- Python · Lekcja 37 · Zaawansowany · Wersja: 5
- Python · Lekcja 34 · Średniozaawansowany · Wersja: 3