CKTIS / Python
unittest.TestCase
Una instancia de TestCase ejecuta un método indicado por su nombre.
Versión: Python 3.14; repository image, production runtime not attested
Sintaxis
unittest.TestCase(methodName='runTest')Una instancia de TestCase ejecuta un método indicado por su nombre.
Si falla setUp, se omiten el cuerpo y tearDown, y las limpiezas se ejecutan en orden inverso al registro. subTest identifica la variante fallida y permite continuar con otras en una ejecución normal. Tras un setUp correcto se ejecuta tearDown aunque falle una aserción. Las funciones de addCleanup se ejecutan después de tearDown o de un setUp fallido. La comparación de 4 con 5 entra en failures y otra excepción como ValueError en errors.
El ejemplo 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 el estado antes del método de prueba. assertEqual compara resultado y expectativa. assertRaises(KeyError) exige esa excepción o una subclase. subTest(key=...) identifica variantes dentro del mismo método y testsRun sigue en 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()
Ejemplos
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
El ejemplo imprime 1 1 0.