CKTIS / Python
TestResult.testsRun: licznik rozpoczętych testów
Uruchom zestaw testów za pomocą `unittest.TextTestRunner.run()` i odczytaj `testsRun`, `failures` oraz `errors` ze zwróconego wyniku, aby utworzyć podsumowanie.
Wersja: Python 3.12
Składnia
result = unittest.TextTestRunner().run(suite)
result.testsRun # int
len(result.failures)
len(result.errors)W Pythonie 3.12 metoda unittest.TextTestRunner.run(suite) uruchamia zestaw testów i zwraca obiekt wyniku. TestResult.testsRun to atrybut całkowitoliczbowy: po zakończeniu przebiegu odczytaj result.testsRun, bez nawiasów. Standardowy licznik rośnie, gdy przypadek testowy zaczyna być obsługiwany, a nie wtedy, gdy kończy się powodzeniem. Uwzględnia również indywidualnie pominięty przypadek, nawet jeśli ciało jego metody nie zostanie wykonane. Podtesty subTest() nie zwiększają licznika osobno.
result.failures i result.errors to listy wpisów zawierających sformatowany ślad stosu. Niespełniona asercja, na przykład w assertEqual(), trafia do failures, a nieoczekiwany wyjątek, taki jak RuntimeError, do errors. Użyj len(), aby policzyć wpisy na każdej liście. Nie odejmuj tych liczb od testsRun, by ustalić liczbę testów zakończonych powodzeniem: pominięcia są rejestrowane osobno w result.skipped, a jeden przypadek może dać kilka wpisów, na przykład przez kilka nieudanych podtestów.
Jeśli chcesz poznać liczbę przypadków w zestawie, wywołaj suite.countTestCases() przed uruchomieniem. Przy failfast=True przebieg może zakończyć się przed rozpoczęciem wszystkich przypadków. Błąd w setUpClass() może trafić do errors, mimo że żaden przypadek z tej klasy nie został rozpoczęty. Zamiast analizować tekst raportu, odczytuj liczniki bezpośrednio z wyniku.
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 RuntimeError("unexpected error")
@unittest.skip("demonstrate a skipped test")
def test_skip(self):
self.fail("this body is not executed")
suite = unittest.TestSuite(
DemoTests(name)
for name in ("test_pass", "test_failure", "test_error", "test_skip")
)
with io.StringIO() as report:
result = unittest.TextTestRunner(stream=report, failfast=False).run(suite)
print(f"testsRun={result.testsRun}")
print(f"failures={len(result.failures)}")
print(f"errors={len(result.errors)}")
print(f"skipped={len(result.skipped)}")Wynik
testsRun=4 failures=1 errors=1 skipped=1
Jeden przypadek kończy się powodzeniem, drugi zgłasza niepowodzenie asercji, trzeci zgłasza `RuntimeError`, a czwarty zostaje pominięty. `io.StringIO` przechwytuje raport, więc konsola pokazuje tylko cztery liczniki, bez śladów stosu i czasu wykonania.
Powiązane lekcje
- Python · Lekcja 37 · Zaawansowany · Wersja: 5
Źródła
- Python 3.12 unittest — TestResult.testsRun
- Python 3.12 unittest — TextTestRunner.run
- Python 3.12 unittest — TestResult
- Python 3.12 unittest — TestSuite.countTestCases
- Python 3.12 unittest — Class and Module Fixtures
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 io — StringIO