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

CKTIS / Python

Subtestes em unittest: igualdade e exceções esperadas

Verifica várias entradas num único método de teste, identifica os subtestes que falham e distingue uma asserção de igualdade de uma verificação de exceções.

Versão: Python 3.12

Sintaxe

with self.subTest("case label", value=value):
    self.assertEqual(actual, expected)

with self.subTest(value=value):
    self.assertRaises(ExpectedError, func, *args, **kwargs)

with self.assertRaises(ExpectedError):
    func(*args, **kwargs)

Em Python 3.12, unittest.TestCase.subTest devolve um gestor de contexto. Usa with self.subTest("etiqueta", value=value): para delimitar um subteste, por exemplo uma iteração de um ciclo. A mensagem opcional msg e os argumentos nomeados **params identificam o subteste no relatório de falhas; não são passados à função em teste.

Sem failfast, uma asserção que falhe interrompe o bloco with atual, mas o método de teste prossegue depois desse bloco e pode executar os subtestes seguintes. Os subtestes não são métodos de teste independentes e não executam setUp() nem tearDown() em separado. Com failfast, não assumas que serão executados os subtestes seguintes.

self.assertEqual(actual, expected) verifica a igualdade de valores (==), não a identidade dos objetos (is). Se os valores forem diferentes, a asserção falha. Coloca-a dentro do subteste para que o relatório identifique a entrada que produziu o resultado inesperado.

Na forma com um objeto invocável, self.assertRaises(ExpectedError, func, *args, **kwargs) chama func com os argumentos fornecidos. Passa func, não func(...). A asserção é bem-sucedida se for lançada uma exceção do tipo esperado ou de uma das suas subclasses. Se não for lançada nenhuma exceção, a asserção falha; se a exceção for de outro tipo, propaga-se. Em alternativa, usa with self.assertRaises(ExpectedError): e chama a função dentro do bloco.

Exemplos

import unittest


class ParseTests(unittest.TestCase):
    def test_parse(self):
        for text, expected in [("12", 13), ("-3", -3)]:
            with self.subTest("valid integer", text=text):
                self.assertEqual(int(text), expected)

        with self.subTest("invalid integer", text="bad"):
            self.assertRaises(ValueError, int, "bad")
            print("Invalid input rejected")


if __name__ == "__main__":
    result = ParseTests("test_parse").run()
    tests, failures, errors = result.testsRun, len(result.failures), len(result.errors)
    print(f"tests={tests}, failures={failures}, errors={errors}")
    # The demonstration succeeds only if it records the deliberate failure.
    if (tests, failures, errors) != (1, 1, 0):
        raise SystemExit(1)

Resultado

Invalid input rejected
tests=1, failures=1, errors=0

O valor esperado `13` para `"12"` está intencionalmente errado. O subteste de `"-3"` passa e o caso `"bad"` só escreve a mensagem depois de a exceção `ValueError` esperada ser intercetada. O resumo conta um método de teste, uma falha e zero erros. O script termina com o código de saída `0` se as contagens corresponderem a esses valores.

Lições relacionadas

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

Fontes