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