KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

unittest-resultaten: gestarte tests, mislukkingen en fouten

Voer een testsuite uit en gebruik het teruggegeven resultaat om gestarte testgevallen, mislukte assertions en onverwachte uitzonderingen apart te tellen.

Versie: Python 3.12

Syntax

result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)

In Python 3.12 voert unittest.TextTestRunner.run(suite) de suite uit en geeft de methode een TestResult-object terug. result.testsRun telt gestarte testgevallen, niet de gevallen die bij het zoeken zijn gevonden of alleen de geslaagde gevallen. Een geval dat na de start wordt overgeslagen, kan ook meetellen.

result.failures registreert mislukkingen, zoals een mislukte controle met assertEqual(). Assertions van TestCase melden een mislukking met failureException, standaard AssertionError. result.errors registreert onverwachte uitzonderingen, zoals een niet-afgevangen RuntimeError in een testmethode. Elk item in beide lijsten is een paar: het testobject en een tekenreeks met een opgemaakte traceback.

Gebruik len(result.failures) en len(result.errors) om items te tellen zonder het tekstrapport te ontleden. Trek die aantallen niet af van testsRun om geslaagde tests te tellen: tests kunnen worden overgeslagen en één geval kan meerdere mislukte subtests hebben. Gebruik voor het totaalresultaat result.wasSuccessful(), dat ook bij een onverwacht succes False teruggeeft.

Voorbeelden

import unittest
from io import StringIO


class SummaryTests(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(1 + 1, 2)

    def test_failure(self):
        self.assertEqual(1 + 1, 3)

    def test_error(self):
        raise RuntimeError("unexpected problem")


suite = unittest.TestSuite([
    SummaryTests("test_pass"),
    SummaryTests("test_failure"),
    SummaryTests("test_error"),
])
result = unittest.TextTestRunner(stream=StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")

Resultaat

testsRun=3 failures=1 errors=1

Eén geval slaagt, bij één mislukt een assertion en één werpt `RuntimeError` op. `StringIO` vangt het rapport van de testrunner op, zodat de console alleen de regel met de aantallen toont.

Gerelateerde lessen

  • Python · Les 37 · Gevorderd · Versie: 5

Bronnen