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

CKTIS / Python

unittest.TestCase

Uma instância de TestCase executa um método indicado pelo nome.

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

Sintaxe

unittest.TestCase(methodName='runTest')

Uma instância de TestCase executa um método indicado pelo nome.

Se setUp falhar, o corpo e tearDown são omitidos e as limpezas executam-se por ordem inversa de registo. subTest identifica a variante que falhou e permite continuar as outras numa execução normal. Após um setUp bem-sucedido, tearDown é executado mesmo que uma asserção falhe. As funções de addCleanup são executadas depois de tearDown ou de um setUp falhado. A comparação entre 4 e 5 entra em failures e outra exceção como ValueError em errors.

O exemplo imprime 1 1 0.

import unittest
events=[]
class Check(unittest.TestCase):
    def setUp(self):
        events.append('up')
        self.addCleanup(events.append,'clean')
    def tearDown(self): events.append('down')
    def test_bad(self): self.assertEqual(2,3)
    def test_error(self): raise ValueError('bad')
r=unittest.TestResult()
Check('test_bad').run(r)
assert events==['up','down','clean'] and len(r.failures)==1
Check('test_error').run(r)
assert len(r.errors)==1 and r.testsRun==2
class Broken(unittest.TestCase):
    def setUp(self):
        self.addCleanup(events.append,'first')
        self.addCleanup(events.append,'second')
        raise ValueError('setup')
    def tearDown(self): events.append('down')
    def test_a(self): events.append('body')
events.clear()
Broken('test_a').run(r)
assert events==['second','first']
class Variants(unittest.TestCase):
    def test_loop(self):
        for n in (1,2):
            with self.subTest(n=n):
                events.append(n)
                self.assertEqual(n,2)
r2=unittest.TestResult()
Variants('test_loop').run(r2)
assert events[-2:]==[1,2] and r2.testsRun==1 and len(r2.failures)==1

unittest.TestCase.setUp · unittest.TestCase.assertEqual · unittest.TestCase.assertRaises · unittest.TestCase.subTest

setUp prepara o estado antes do método de teste. assertEqual compara resultado e expectativa. assertRaises(KeyError) exige essa exceção ou uma subclasse. subTest(key=...) identifica variantes dentro do mesmo método, pelo que testsRun continua em 1.

import unittest
class PriceTests(unittest.TestCase):
    def setUp(self):
        self.values = {"small": 2}
    def test_sizes(self):
        for key, expected in [("small",2),("other",0)]:
            with self.subTest(key=key):
                self.assertEqual(self.values.get(key,0),expected)
        with self.assertRaises(KeyError):
            self.values["missing"]
r=unittest.TestResult()
PriceTests("test_sizes").run(r)
assert r.testsRun==1 and r.wasSuccessful()

Exemplos

import unittest
class Check(unittest.TestCase):
    def test_total(self): self.assertEqual(4, 5)

r = unittest.TestResult()
Check("test_total").run(r)
print(r.testsRun, len(r.failures), len(r.errors))

Resultado

1 1 0

O exemplo imprime 1 1 0.

Fontes