CKTIS / Python
TestResult: un resoconto unittest in quattro righe
Esegui una suite di test e usa il `TestResult` restituito per riportare quanti test sono iniziati, quanti fallimenti ed errori sono stati registrati e l’esito complessivo.
Versione: Python 3.12
Sintassi
result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()In Python 3.12, unittest.TextTestRunner.run(suite) esegue la suite e restituisce per impostazione predefinita un TextTestResult, una sottoclasse di TestResult. Conserva l’oggetto restituito per creare un resoconto personalizzato senza analizzare il testo prodotto dal runner.
result.testsRun è un intero che conta i test avviati, non quelli superati o pianificati. Un test saltato viene contato se ne è stato registrato l’avvio. Un errore nella preparazione di una classe di test, invece, può essere registrato senza che venga avviato alcun test di quella classe.
result.failures e result.errors sono liste, non contatori. La prima raccoglie fallimenti, per esempio un’asserzione assertEqual non soddisfatta; la seconda raccoglie errori, per esempio un ValueError inatteso. Ogni voce contiene un oggetto che identifica il test e un traceback formattato come stringa. Usa len(...) per contare le voci.
result.wasSuccessful() è un metodo: chiamalo con le parentesi. Restituisce True solo se non sono stati registrati fallimenti, errori o successi inattesi, cioè test superati nonostante siano marcati con @unittest.expectedFailure. I test saltati e i fallimenti attesi, da soli, non causano un risultato False.
Esempi
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()}")Risultato
Tests run: 3 Failures: 1 Errors: 1 Successful: False
Un test riesce, uno fallisce su un’asserzione e uno solleva `ValueError`. Il runner scrive il resoconto abituale in `io.StringIO`, quindi in console compaiono solo le quattro righe personalizzate.
Lezioni correlate
- Python · Lezione 34 · Intermedio · Versione: 3