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

CKTIS / Python

assertEqual em unittest: comparar o resultado com o valor esperado

Compara o resultado com o valor esperado usando `assertEqual`, prepara os dados com `setUp` e testa várias entradas e exceções com `unittest`.

Versão: Python 3.12

Sintaxe

self.assertEqual(actual, expected, msg=None)

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

Em Python 3.12, assertEqual é um método de unittest.TestCase. Em self.assertEqual(actual, expected), passa primeiro o resultado e depois o valor esperado. O método verifica a igualdade (==), não a identidade (is). Se os valores forem diferentes, a asserção falha; podes acrescentar contexto com o argumento opcional msg.

Quando ambos os operandos são exatamente do mesmo tipo, assertEqual pode usar uma comparação específica desse tipo para produzir uma mensagem de falha mais informativa. Isto aplica-se a list, tuple, dict, set, frozenset, str e aos tipos registados com addTypeEqualityFunc(). Dois valores podem ser iguais mesmo que tenham tipos diferentes.

setUp() prepara os dados antes de cada método de teste, não antes de cada subteste. Num ciclo, with self.subTest(text=text): identifica o caso, para que o relatório de falhas indique a entrada testada. Com failfast desativado, uma asserção que falha num subteste não impede a execução das iterações seguintes.

Usa assertRaises para verificar exceções. Executa a operação dentro do bloco with self.assertRaises(ValueError):. Na forma self.assertRaises(ValueError, int, text), passa a função sem a chamar e indica o seu argumento separadamente. A exceção esperada ou uma subclasse satisfaz a asserção; se não houver exceção, a asserção falha, e uma exceção diferente propaga-se.

Exemplos

import io
import unittest


class IntConversionTests(unittest.TestCase):
    def setUp(self):
        self.inputs = ('0', '7', '-3', 'not a number')

    def test_direct(self):
        self.assertEqual(int(self.inputs[0]), 0)
        self.assertEqual(int(self.inputs[1]), 7)
        self.assertEqual(int(self.inputs[2]), -3)
        with self.assertRaises(ValueError):
            int(self.inputs[3])

    def test_subtests(self):
        for text, expected in zip(self.inputs[:3], (0, 7, -3)):
            with self.subTest(text=text):
                self.assertEqual(int(text), expected)
        self.assertRaises(ValueError, int, self.inputs[3])


if __name__ == '__main__':
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(IntConversionTests)
    report = io.StringIO()
    result = unittest.TextTestRunner(stream=report).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(report.getvalue())
    print(f'{result.testsRun} tests passed')

Resultado

2 tests passed

`test_direct` faz três comparações diretas e verifica a exceção num bloco `with`. `test_subtests` usa as mesmas entradas em subtestes identificados e passa a função a `assertRaises`. O `2` conta os métodos de teste, não os subtestes.

Lições relacionadas

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

Fontes