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

CKTIS / Python

Resultados de unittest: testes iniciados, falhas e erros

Executa uma suite de testes e usa o resultado devolvido para contar separadamente os casos iniciados, as falhas de asserção e as exceções inesperadas.

Versão: Python 3.12

Sintaxe

result = unittest.TextTestRunner(stream=stream).run(suite)
result.testsRun
len(result.failures)
len(result.errors)

Em Python 3.12, unittest.TextTestRunner.run(suite) executa a suite e devolve um objeto TestResult. result.testsRun conta os casos de teste iniciados, não os encontrados durante a descoberta nem apenas os que passaram. Um caso ignorado depois de iniciado também pode entrar na contagem.

result.failures regista falhas, como a de uma verificação com assertEqual(). As asserções de TestCase assinalam uma falha com failureException, que por omissão é AssertionError. result.errors regista exceções inesperadas, como um RuntimeError não tratado num método de teste. Cada entrada das duas listas é um par formado pelo objeto de teste e por uma cadeia de caracteres com o traceback formatado.

Usa len(result.failures) e len(result.errors) para contar as entradas sem analisar o relatório em texto. Não subtraias esses valores de testsRun para calcular quantos testes passaram: alguns podem ser ignorados e um caso pode ter vários subtestes que falham. Para verificar o resultado global, usa result.wasSuccessful(), que também devolve False se houver um sucesso inesperado.

Exemplos

import unittest
from io import StringIO


class SummaryTests(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(1 + 1, 2)

    def test_failure(self):
        self.assertEqual(1 + 1, 3)

    def test_error(self):
        raise RuntimeError("unexpected problem")


suite = unittest.TestSuite([
    SummaryTests("test_pass"),
    SummaryTests("test_failure"),
    SummaryTests("test_error"),
])
result = unittest.TextTestRunner(stream=StringIO()).run(suite)
print(f"testsRun={result.testsRun} failures={len(result.failures)} errors={len(result.errors)}")

Resultado

testsRun=3 failures=1 errors=1

Um caso passa, outro falha numa asserção e outro lança `RuntimeError`. `StringIO` captura o relatório do executor de testes, pelo que a consola mostra apenas a linha com as contagens.

Lições relacionadas

  • Python · Lição 37 · Avançado · Versão: 5

Fontes