Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

unittest.TestResult.failures — lista de falhas de asserção

unittest.TestResult.failures guarda as falhas de asserção como pares que contêm um objeto de teste e o texto formatado do traceback.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

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

unittest.TestResult.failures é um atributo de instância, não um método. Contém uma lista de pares (test, traceback_text): um objeto TestCase e uma cadeia de texto com o traceback formatado. Consulte-o no objeto de resultado depois de executar os testes.

Para classificar como falha ou erro uma exceção lançada num método de teste normal, unittest usa o tipo failureException do caso de teste. As exceções desse tipo ou das suas subclasses são adicionadas a failures; as restantes, a errors. O tipo predefinido é AssertionError, que é lançado, por exemplo, quando uma chamada a assertEqual() falha. Já um AssertionError lançado em setUpClass é registado em errors. As falhas esperadas são guardadas separadamente em expectedFailures. Assim, uma lista failures vazia não prova que toda a suite tenha sido bem-sucedida.

O exemplo provoca deliberadamente uma falha. Verifica a estrutura da entrada sem apresentar o traceback, cujos caminhos e números de linha dependem do ficheiro.

Exemplos

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))

Resultado

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

O código apresentado e o resultado declarado foram verificados num ambiente isolado pelo método registado na prova de verificação desta versão exata.

Fontes