Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest.TestResult.failures — elenco degli errori di asserzione

unittest.TestResult.failures memorizza gli errori di asserzione come coppie contenenti un oggetto di test e il testo formattato del traceback.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

result.failures
for test, traceback_text in result.failures:
    ...

unittest.TestResult.failures è un attributo di istanza, non un metodo. Contiene un elenco di coppie (test, traceback_text): un oggetto TestCase e una stringa con il traceback formattato. Leggilo dall’oggetto risultato dopo aver eseguito i test.

Per classificare come fallimento o errore un’eccezione sollevata in un normale metodo di test, unittest usa il tipo failureException del caso di test. Le eccezioni di quel tipo o delle sue sottoclassi finiscono in failures; le altre in errors. Il tipo predefinito è AssertionError, l’eccezione sollevata, ad esempio, quando una chiamata ad assertEqual() fallisce. Un’eccezione AssertionError sollevata in setUpClass finisce invece in errors. I fallimenti attesi vengono memorizzati separatamente in expectedFailures. Un elenco failures vuoto, quindi, non dimostra che l’intera suite sia riuscita.

L’esempio produce intenzionalmente un fallimento. Controlla la struttura della voce senza stampare il traceback, i cui percorsi e numeri di riga dipendono dal file.

Esempi

import unittest


class SampleTest(unittest.TestCase):
    def test_total(self):
        self.assertEqual(2 + 2, 5)


result = unittest.TestResult()
SampleTest("test_total").run(result)

test, traceback_text = result.failures[0]
print("test:" if False else "failures:", len(result.failures))
print("test:", test.id())
print("traceback is text:", isinstance(traceback_text, str))
print("errors:", len(result.errors))

Risultato

failures: 1
test: __main__.SampleTest.test_total
traceback is text: True
errors: 0

Il codice mostrato e il risultato dichiarato sono stati verificati in un ambiente isolato con il metodo registrato nella prova di verifica di questa versione esatta.

Fonti