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
- Python 3.12 unittest — TestCase.subTest
- Python 3.12 unittest — Distinguishing test iterations using subtests
- Python 3.12 unittest — TestCase.assertEqual
- Python 3.12 unittest — TestCase.assertRaises
- Python 3.12 unittest — TestCase.run
- Python 3.12 unittest — TestResult.addSubTest
- Python 3.12 unittest — failfast command-line option