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

CKTIS / Python

unittest.TestResult.wasSuccessful — verificar os resultados dos testes

O método wasSuccessful() indica se os resultados registados até ao momento não contêm falhas, erros ou sucessos inesperados. Não executa testes por si só.

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

Sintaxe

result.wasSuccessful()

unittest.TestResult.wasSuccessful() é um método de instância chamado sem argumentos, como result.wasSuccessful(). Devolve um bool que resume os resultados registados até ao momento em result; não executa testes.

A implementação padrão devolve False quando failures, errors ou unexpectedSuccesses não estão vazios. Os testes ignorados (skipped) e as falhas esperadas (expectedFailures), por si só, não fazem com que devolva False. Um teste aprovado decorado com @unittest.expectedFailure é um sucesso inesperado e faz com que devolva False.

Um resultado vazio devolve True: isto não prova que tenha sido executado algum teste nem que toda a suite tenha terminado. Verifique também testsRun se for necessário que os testes tenham sido executados. O exemplo executa explicitamente dois testes e reúne os respetivos resultados num único objeto.

Exemplos

import unittest

class Checks(unittest.TestCase):
    def test_pass(self):
        self.assertEqual(2 + 2, 4)

    @unittest.expectedFailure
    def test_unexpected_success(self):
        self.assertTrue(True)

result = unittest.TestResult()
print(result.testsRun, result.wasSuccessful())
Checks('test_pass').run(result)
print(result.testsRun, result.wasSuccessful())
Checks('test_unexpected_success').run(result)
print(result.testsRun, result.wasSuccessful())

Resultado

0 True
1 True
2 False

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