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.