CKTIS / Python
TestResult.testsRun: gestarte tests tellen
Voer een testsuite uit met `unittest.TextTestRunner.run()` en lees `testsRun`, `failures` en `errors` uit het teruggegeven resultaat om een samenvatting te maken.
Versie: Python 3.12
Syntax
result = unittest.TextTestRunner().run(suite)
result.testsRun # int
len(result.failures)
len(result.errors)In Python 3.12 voert unittest.TextTestRunner.run(suite) de testsuite uit en geeft het een resultaatobject terug. TestResult.testsRun is een attribuut met een geheel getal: lees na de aanroep result.testsRun zonder haakjes. De standaardteller gaat omhoog zodra een testgeval aan de beurt is, niet pas als het slaagt. Een afzonderlijk overgeslagen geval telt mee, ook al wordt de code van de testmethode niet uitgevoerd. Aanroepen van subTest() tellen niet afzonderlijk mee.
result.failures en result.errors zijn lijsten met items die een opgemaakte traceback bevatten. Een mislukte assertie, bijvoorbeeld bij assertEqual(), komt in failures; een onverwachte uitzondering zoals RuntimeError komt in errors. Gebruik len() om de items per lijst te tellen. Trek deze aantallen niet af van testsRun om te bepalen hoeveel tests geslaagd zijn: overgeslagen gevallen worden apart bijgehouden in result.skipped en één geval kan meerdere items opleveren, bijvoorbeeld als meerdere subtests mislukken.
Wil je weten hoeveel gevallen de suite bevat, roep dan vóór uitvoering suite.countTestCases() aan. Met failfast=True kan de uitvoering stoppen voordat alle gevallen zijn gestart. Een fout in setUpClass() kan in errors terechtkomen terwijl geen enkel geval uit die klasse is gestart. Lees de aantallen uit het resultaatobject in plaats van het tekstrapport te ontleden.
Voorbeelden
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)}")Resultaat
testsRun=4 failures=1 errors=1 skipped=1
Eén geval slaagt, bij één mislukt een assertie, één werpt `RuntimeError` op en één wordt overgeslagen. `io.StringIO` vangt het rapport op, zodat de console alleen de vier aantallen toont, zonder tracebacks of verstreken tijd.
Gerelateerde lessen
- Python · Les 37 · Gevorderd · Versie: 5
Bronnen
- 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