CKTIS / Python
TestResult.testsRun: gestartete Tests zählen
Führe eine Testsuite mit `unittest.TextTestRunner.run()` aus und lies `testsRun`, `failures` und `errors` aus dem Ergebnisobjekt aus, um eine Zusammenfassung zu erstellen.
Version: Python 3.12
Syntax
result = unittest.TextTestRunner().run(suite)
result.testsRun # int
len(result.failures)
len(result.errors)In Python 3.12 führt unittest.TextTestRunner.run(suite) die Testsuite aus und gibt ein Ergebnisobjekt zurück. TestResult.testsRun ist ein ganzzahliges Attribut: Lies nach dem Aufruf result.testsRun ohne Klammern. Der Standardzähler steigt, sobald die Verarbeitung eines Testfalls beginnt, nicht erst, wenn er besteht. Ein einzeln übersprungener Testfall zählt mit, obwohl sein Methodenrumpf nicht ausgeführt wird. Aufrufe von subTest() erhöhen den Zähler nicht separat.
result.failures und result.errors sind Listen mit Einträgen, die formatierte Tracebacks enthalten. Eine fehlgeschlagene Prüfung wie assertEqual() landet in failures, eine unerwartete Ausnahme wie RuntimeError in errors. Mit len() zählst du die Einträge jeder Liste. Ziehe diese Anzahlen nicht von testsRun ab, um die bestandenen Tests zu ermitteln: Übersprungene Fälle stehen gesondert in result.skipped, und ein Fall kann mehrere Einträge erzeugen, etwa wenn mehrere Untertests fehlschlagen.
Wenn du stattdessen wissen willst, wie viele Fälle die Suite enthält, rufe vor dem Start suite.countTestCases() auf. Mit failfast=True kann der Lauf enden, bevor alle Fälle gestartet wurden. Ein Fehler in setUpClass() kann in errors stehen, obwohl kein Fall dieser Klasse gestartet wurde. Lies die Zahlen aus dem Ergebnisobjekt aus, statt den Textbericht zu analysieren.
Beispiele
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)}")Ergebnis
testsRun=4 failures=1 errors=1 skipped=1
Ein Fall besteht, bei einem schlägt eine Prüfung fehl, einer löst `RuntimeError` aus und einer wird übersprungen. `io.StringIO` fängt den Bericht ab, sodass auf der Konsole nur die vier Anzahlen erscheinen, ohne Tracebacks oder Laufzeit.
Zugehörige Lektionen
- Python · Lektion 37 · Fortgeschritten · Version: 5
Quellen
- 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