CKTIS / Python
Tests mit `TextTestRunner.run` ausführen und das Ergebnis auswerten
Führe eine Testsuite oder einen einzelnen Testfall aus und erstelle aus dem zurückgegebenen `TestResult` eine eigene Zusammenfassung, ohne den Textbericht auszuwerten.
Version: Python 3.12
Syntax
runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()In Python 3.12 nimmt unittest.TextTestRunner.run eine Instanz von TestSuite oder TestCase entgegen, führt die übergebenen Tests aus und gibt ein TestResult-Objekt zurück (standardmäßig TextTestResult). Unabhängig davon schreibt der Runner einen Textbericht in den über stream gewählten Ausgabestrom; standardmäßig ist das sys.stderr.
result.testsRun zählt die gestarteten Tests, nicht die bestandenen oder eingeplanten. result.failures und result.errors sind Listen mit Paaren der Form (Test, formatierter Traceback). Eine fehlgeschlagene Assertion wie self.assertEqual(...) landet in failures; eine unerwartete Ausnahme wie ein nicht abgefangener ValueError aus einer Testmethode landet in errors. Mit len(...) zählst du die Einträge jeder Liste.
result.wasSuccessful() gibt True zurück, wenn keine fehlgeschlagenen Tests, Fehler oder unerwarteten Erfolge aufgezeichnet wurden. Ein unerwarteter Erfolg liegt vor, wenn ein mit @unittest.expectedFailure markierter Test besteht. Übersprungene Tests und erwartete Fehlschläge führen für sich genommen nicht zu False. Prüfe nicht nur die beiden Listen anstelle dieser Methode und werte True nicht als Beleg dafür, dass überhaupt Tests ausgeführt wurden.
Beispiele
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()}")Ergebnis
Tests run: 3 Failures: 1 Errors: 1 Successful: False
Ein Test besteht, bei einem schlägt eine Assertion fehl und einer löst einen Fehler aus. `io.StringIO()` fängt den üblichen Bericht des Runners einschließlich der Laufzeit ab, sodass auf der Konsole nur die eigene vierzeilige Zusammenfassung erscheint.
Zugehörige Lektionen
- Python · Lektion 37 · Fortgeschritten · Version: 5
- Python · Lektion 34 · Mittlere Stufe · Version: 3