Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest: fallimenti delle asserzioni ed errori nei test

Esegui una suite di test e usa `testsRun`, `failures` ed `errors` per ottenere un riepilogo deterministico senza analizzare il resoconto testuale.

Versione: Python 3.12

Sintassi

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, unittest.TextTestRunner.run(suite) esegue la suite e restituisce un oggetto unittest.TestResult, per impostazione predefinita un TextTestResult. Leggi l’oggetto restituito invece di analizzare il resoconto testuale. result.testsRun conta i test avviati, non quelli superati né la dimensione della suite prima dell’esecuzione.

Se self.assertEqual(...) fallisce, solleva un’eccezione del tipo failureException del caso di test, che per impostazione predefinita è AssertionError. Quando unittest classifica un’eccezione come fallimento o errore, la registra in result.failures se il suo tipo è failureException o una sua sottoclasse, altrimenti in result.errors. Un ValueError non gestito in un metodo di test è quindi un errore per impostazione predefinita, ma è un fallimento se corrisponde al failureException configurato. Se l’asserzione fallisce nel corpo di un metodo di test decorato con @unittest.expectedFailure e sia tearDown sia le funzioni di pulizia terminano senza problemi, l’esito viene invece registrato in result.expectedFailures. Ogni voce di result.failures o result.errors contiene un oggetto di test e una stringa con il traceback formattato. Usa len(result.failures) e len(result.errors) per contare le voci.

Non sottrarre entrambe le lunghezze da testsRun per contare i test superati: quelli saltati sono registrati a parte e un test può produrre più voci, per esempio con subTest. Usa result.wasSuccessful() per il verdetto complessivo: restituisce False anche quando un test contrassegnato come fallimento atteso viene superato inaspettatamente.

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

Risultato

testsRun=3 failures=1 errors=1

Un test viene superato, uno fallisce per un’asserzione e uno genera un errore. `io.StringIO()` cattura il resoconto del runner, quindi nella console appare solo la riga con i conteggi.

Lezioni correlate

  • Python · Lezione 37 · Avanzato · Versione: 5

Fonti