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

CKTIS / Python

Executar testes e consultar o resultado de `TextTestRunner.run`

Execute uma suite de testes ou um caso de teste individual e use o `TestResult` devolvido para criar um resumo próprio sem analisar o relatório em texto.

Versão: Python 3.12

Sintaxe

runner = unittest.TextTestRunner(stream=report_stream)
result = runner.run(test)
result.testsRun
len(result.failures)
len(result.errors)
result.wasSuccessful()

Em Python 3.12, unittest.TextTestRunner.run recebe uma instância de TestSuite ou TestCase, executa os testes fornecidos e devolve um objeto TestResult (TextTestResult por omissão). Separadamente, o executor escreve um relatório em texto no fluxo configurado com stream, que por omissão é sys.stderr.

result.testsRun conta os testes iniciados, não os que passaram nem os que estavam previstos. result.failures e result.errors são listas de pares (teste, rasto da pilha formatado). Uma asserção que falha, como self.assertEqual(...), é registada em failures; uma exceção inesperada, como um ValueError que sai de um método de teste sem ser tratado, é registada em errors. Use len(...) para contar as entradas de cada lista.

result.wasSuccessful() devolve True se não tiverem sido registadas falhas, erros ou sucessos inesperados. Há um sucesso inesperado quando passa um teste marcado com @unittest.expectedFailure. Os testes ignorados e as falhas esperadas não fazem, por si só, com que o método devolva False. Não substitua este método pela verificação das duas listas, nem interprete True como prova de que foi executado algum teste.

Exemplos

import io
import unittest


class ArithmeticTests(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("intentional test error")


if __name__ == "__main__":
    suite = unittest.TestSuite([
        ArithmeticTests("test_pass"),
        ArithmeticTests("test_failure"),
        ArithmeticTests("test_error"),
    ])
    report_stream = io.StringIO()
    result = unittest.TextTestRunner(stream=report_stream).run(suite)
    print(f"Tests run: {result.testsRun}")
    print(f"Failures: {len(result.failures)}")
    print(f"Errors: {len(result.errors)}")
    print(f"Successful: {result.wasSuccessful()}")

Resultado

Tests run: 3
Failures: 1
Errors: 1
Successful: False

Um teste passa, outro falha numa asserção e outro gera um erro. `io.StringIO()` capta o relatório habitual do executor, incluindo o tempo decorrido, pelo que a consola apresenta apenas o resumo personalizado de quatro linhas.

Lições relacionadas

  • Python · Lição 37 · Avançado · Versão: 5
  • Python · Lição 34 · Intermédio · Versão: 3

Fontes