KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

Tests uitvoeren en het resultaat van `TextTestRunner.run` bekijken

Voer een testsuite of één testcase uit en gebruik het teruggegeven `TestResult` om een eigen samenvatting te maken zonder het tekstverslag te ontleden.

Versie: 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 neemt unittest.TextTestRunner.run een instantie van TestSuite of TestCase aan, voert de opgegeven tests uit en geeft een TestResult-object terug (standaard TextTestResult). Los daarvan schrijft de runner een tekstverslag naar de uitvoerstroom die je met stream instelt. Standaard is dat sys.stderr.

result.testsRun telt gestarte tests, niet geslaagde of geplande tests. result.failures en result.errors zijn lijsten met paren (test, opgemaakte traceback). Een mislukte assertie zoals self.assertEqual(...) komt in failures; een onverwachte uitzondering zoals een ValueError die niet in de testmethode wordt afgehandeld, komt in errors. Gebruik len(...) om de vermeldingen in elke lijst te tellen.

result.wasSuccessful() geeft True terug als er geen mislukkingen, fouten of onverwachte successen zijn vastgelegd. Een onverwacht succes is een geslaagde test die met @unittest.expectedFailure is gemarkeerd. Overgeslagen tests en verwachte mislukkingen leiden op zichzelf niet tot False. Vervang deze methode niet door een controle van alleen de twee lijsten en zie True niet als bewijs dat er überhaupt tests zijn uitgevoerd.

Voorbeelden

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()}")

Resultaat

Tests run: 3
Failures: 1
Errors: 1
Successful: False

Eén test slaagt, bij één test mislukt een assertie en één test veroorzaakt een fout. `io.StringIO()` vangt het gebruikelijke verslag van de runner op, inclusief de verstreken tijd, zodat de console alleen de eigen samenvatting van vier regels toont.

Gerelateerde lessen

  • Python · Les 37 · Gevorderd · Versie: 5
  • Python · Les 34 · Gemiddeld · Versie: 3

Bronnen