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

CKTIS / Python

unittest: falhas de asserção e erros nos testes

Executa um conjunto de testes e usa `testsRun`, `failures` e `errors` para criar um resumo determinístico sem analisar o relatório de texto.

Versão: Python 3.12

Sintaxe

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

Em Python 3.12, unittest.TextTestRunner.run(suite) executa o conjunto de testes e devolve um objeto unittest.TestResult, por omissão um TextTestResult. Lê o objeto devolvido em vez de analisares o relatório de texto. result.testsRun conta os testes iniciados, não os que passaram nem o número de testes no conjunto antes da execução.

Se self.assertEqual(...) falhar, lança uma exceção do tipo failureException do caso de teste, que por omissão é AssertionError. Quando unittest classifica uma exceção como falha ou erro, regista-a em result.failures se o seu tipo for failureException ou uma subclasse desse tipo, e em result.errors caso contrário. Um ValueError não tratado num método de teste é, por isso, um erro por omissão, mas é uma falha se corresponder ao failureException configurado. Se a asserção falhar no corpo de um método de teste decorado com @unittest.expectedFailure e tearDown e as funções de limpeza terminarem sem problemas, o resultado é registado em result.expectedFailures em vez de result.failures. Cada entrada de result.failures ou result.errors contém um objeto de teste e uma cadeia de caracteres com o rasto da pilha formatado. Usa len(result.failures) e len(result.errors) para contar as entradas.

Não subtraias os comprimentos das duas listas a testsRun para contar os testes que passaram: os testes ignorados são registados à parte e um teste pode gerar várias entradas, por exemplo com subTest. Para o resultado global, usa result.wasSuccessful(): também devolve False quando um teste marcado como falha esperada passa inesperadamente.

Exemplos

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

Resultado

testsRun=3 failures=1 errors=1

Um teste passa, outro falha numa asserção e o terceiro produz um erro. `io.StringIO()` captura o relatório da execução, pelo que a consola só mostra a linha com as contagens.

Lições relacionadas

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

Fontes