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

CKTIS / Python

`unittest.TestCase.setUp`: preparar cada teste

Usa `setUp()` para que cada teste comece com dados novos. Depois verifica valores com `assertEqual()` e uma exceção esperada com `assertRaises()`.

Versão: Python 3.12

Sintaxe

import unittest

class ExampleTests(unittest.TestCase):
    def setUp(self):
        self.items = [10, 20]

unittest.TestCase.setUp é um método de instância que o unittest chama automaticamente imediatamente antes de executar cada método de teste. Define setUp(self) numa subclasse de unittest.TestCase e guarda em self os dados que fazem parte do ambiente de teste (fixture). A implementação por omissão não faz nada.

O unittest cria uma instância distinta de TestCase para cada método de teste. Cria uma nova lista em setUp() em vez de partilhares uma lista mutável como atributo de classe. No exemplo, test_pop altera a sua lista, enquanto test_remove_missing começa com uma nova lista [10, 20]. setUpClass() é um método de classe para a preparação partilhada ao nível da classe, não para a inicialização de cada teste.

As três chamadas a assertEqual(obtido, esperado) verificam a igualdade dos valores, não a identidade dos objetos: verificam o elemento devolvido, a lista após pop() e a lista após a tentativa de remoção sem êxito. O bloco with self.assertRaises(ValueError): contém apenas a tentativa de remover o valor ausente. Se não for lançada nenhuma exceção, a asserção falha; uma exceção diferente propaga-se. A forma alternativa recebe o método a chamar e o respetivo argumento: self.assertRaises(ValueError, self.items.remove, 99).

Se setUp() lançar uma exceção, nem o método de teste nem tearDown() são executados. AssertionError conta como falha, unittest.SkipTest indica um teste ignorado e a maioria das outras exceções conta como erro. As funções de limpeza já registadas com addCleanup() são executadas se o unittest registar uma falha, um erro ou um teste ignorado durante a preparação. No entanto, no Python 3.12, se KeyboardInterrupt não for intercetada em setUp(), a exceção propaga-se para fora de TestCase.run() antes de doCleanups() ser chamado. Se a preparação for bem-sucedida, tearDown() é executado mesmo que o teste falhe.

Exemplos

import unittest


class ListTests(unittest.TestCase):
    def setUp(self):
        self.items = [10, 20]

    def test_pop(self):
        removed = self.items.pop()
        self.assertEqual(removed, 20)
        self.assertEqual(self.items, [10])

    def test_remove_missing(self):
        with self.assertRaises(ValueError):
            self.items.remove(99)
        self.assertEqual(self.items, [10, 20])


if __name__ == "__main__":
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(ListTests)
    result = unittest.TestResult()
    suite.run(result)
    print(f"Tests run: {result.testsRun}")
    print(f"Successful: {result.wasSuccessful()}")
    raise SystemExit(0 if result.wasSuccessful() else 1)

Resultado

Tests run: 2
Successful: True

Executa `python list_tests.py` com Python 3.12. O resultado esperado indica que foram executados dois testes e que o conjunto terminou com sucesso; o script não apresenta o tempo decorrido.

Lições relacionadas

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

Fontes