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

CKTIS / Python

TestResult: um relatório de unittest em quatro linhas

Executa um conjunto de testes e usa o `TestResult` devolvido para indicar quantos testes começaram, quantas falhas e erros foram registados e se a execução teve êxito.

Versão: Python 3.12

Sintaxe

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

Em Python 3.12, unittest.TextTestRunner.run(suite) executa o conjunto de testes e devolve, por omissão, um TextTestResult, uma subclasse de TestResult. Guarda o objeto devolvido para criar um relatório personalizado em vez de analisar o texto produzido pelo executor.

result.testsRun é um número inteiro que conta os testes iniciados, não os testes bem-sucedidos nem os planeados. Um teste ignorado conta se o seu início tiver sido registado. Em contrapartida, pode ser registado um erro na preparação de uma classe de testes sem que nenhum dos seus testes comece.

result.failures e result.errors são listas, não contadores. A primeira regista falhas, como uma asserção assertEqual que não se verifica; a segunda regista erros, como um ValueError inesperado. Cada entrada contém um objeto que identifica o teste e um rasto da pilha de chamadas formatado como texto. Usa len(...) para contar as entradas.

result.wasSuccessful() é um método: chama-o com parênteses. Só devolve True se não houver falhas, erros nem êxitos inesperados registados. Um êxito inesperado ocorre quando um teste marcado com @unittest.expectedFailure passa. Os testes ignorados e as falhas esperadas, por si só, não fazem o método devolver False.

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("demo error")


if __name__ == "__main__":
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(DemoTests)
    with io.StringIO() as stream:
        result = unittest.TextTestRunner(stream=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 lança `ValueError`. O executor escreve o relatório habitual em `io.StringIO`, pelo que só aparecem as quatro linhas personalizadas na consola.

Lições relacionadas

  • Python · Lição 34 · Intermédio · Versão: 3

Fontes