KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

unittest: mislukte asserties en testfouten

Voer een testsuite uit en gebruik `testsRun`, `failures` en `errors` voor een deterministische samenvatting zonder het tekstverslag te ontleden.

Versie: Python 3.12

Syntax

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

In Python 3.12 voert unittest.TextTestRunner.run(suite) de suite uit en geeft de methode een unittest.TestResult-object terug, standaard een TextTestResult. Lees het teruggegeven object in plaats van het tekstverslag te ontleden. result.testsRun telt de gestarte tests, niet de geslaagde tests of het aantal tests in de suite vóór uitvoering.

Een mislukte self.assertEqual(...) werpt een uitzondering van het type failureException van de testcase op, standaard AssertionError. Wanneer unittest een uitzondering als mislukking of fout classificeert, komt die in result.failures terecht als het type failureException of een subklasse daarvan is, en anders in result.errors. Een niet-afgevangen ValueError in een testmethode geldt dus standaard als fout, maar als mislukking als die overeenkomt met de ingestelde failureException. Mislukt de assertie in de body van een testmethode met de decorator @unittest.expectedFailure en verlopen tearDown en de opruimfuncties zonder problemen, dan komt het resultaat in plaats daarvan in result.expectedFailures terecht. Elk item in result.failures of result.errors bevat een testobject en een tekenreeks met de opgemaakte traceback. Tel de items met len(result.failures) en len(result.errors).

Trek de lengtes van beide lijsten niet af van testsRun om geslaagde tests te tellen: overgeslagen tests worden apart bijgehouden en één test kan meerdere items opleveren, bijvoorbeeld met subTest. Gebruik result.wasSuccessful() voor het totaaloordeel: deze methode geeft ook False terug als een test die naar verwachting zou mislukken, onverwacht slaagt.

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 ValueError("unexpected value")


suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
result = unittest.TextTestRunner(stream=io.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 test slaagt, één test mislukt door een assertie en één test veroorzaakt een fout. `io.StringIO()` vangt het verslag van de testrunner op, zodat de console alleen de regel met de aantallen toont.

Gerelateerde lessen

  • Python · Les 37 · Gevorderd · Versie: 5

Bronnen