Base de conocimientosCentro de exámenes
ESEspañol
Elegir idioma13

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.

Fuentes