KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

CKTIS / Python

TestResult: een unittest-rapport van vier regels

Voer een testsuite uit en gebruik het teruggegeven `TestResult` om het aantal gestarte tests, het aantal mislukkingen en fouten en het totaaloordeel te tonen.

Versie: Python 3.12

Syntax

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

In Python 3.12 voert unittest.TextTestRunner.run(suite) de testsuite uit en geeft standaard een TextTestResult terug, een subklasse van TestResult. Bewaar dit object om je eigen rapport samen te stellen zonder de tekstuitvoer van de testrunner te ontleden.

result.testsRun is een geheel getal dat de gestarte tests telt, niet de geslaagde of geplande tests. Een overgeslagen test telt mee als de start ervan is geregistreerd. Een fout bij de voorbereiding van een testklasse kan juist worden geregistreerd zonder dat een test uit die klasse start.

result.failures en result.errors zijn lijsten, geen tellers. De eerste bevat mislukkingen zoals een mislukte assertEqual-controle; de tweede bevat fouten zoals een onverwachte ValueError. Elk item bevat een object dat de test identificeert en een opgemaakte traceback als tekenreeks. Gebruik len(...) om de items te tellen.

result.wasSuccessful() is een methode, dus roep die aan met haakjes. De methode geeft alleen True terug als er geen mislukkingen, fouten of onverwachte successen zijn vastgelegd. Een onverwacht succes is een geslaagde test die is gemarkeerd met @unittest.expectedFailure. Overgeslagen tests en verwachte mislukkingen leiden op zichzelf niet tot False.

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("demo error")


if __name__ == "__main__":
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
    with io.StringIO() as stream:
        result = unittest.TextTestRunner(stream=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, één test mislukt op een assertie en één test werpt `ValueError` op. De testrunner schrijft zijn gebruikelijke rapport naar `io.StringIO`, zodat alleen de vier eigen regels in de console verschijnen.

Gerelateerde lessen

  • Python · Les 34 · Gemiddeld · Versie: 3

Bronnen