Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest.TestCase

Un’istanza di TestCase esegue un metodo indicato per nome.

Versione: Python 3.14; repository image, production runtime not attested

Sintassi

unittest.TestCase(methodName='runTest')

Un’istanza di TestCase esegue un metodo indicato per nome.

Se setUp fallisce, il corpo e tearDown vengono saltati e le pulizie si eseguono in ordine inverso alla registrazione. subTest identifica la variante fallita e permette di proseguire con le altre nell’esecuzione normale. Dopo un setUp riuscito, tearDown viene eseguito anche se un’asserzione fallisce. Le funzioni di addCleanup vengono eseguite dopo tearDown oppure dopo un setUp fallito. Il confronto tra 4 e 5 entra in failures e un’altra eccezione come ValueError in errors.

L’esempio stampa 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 lo stato prima del metodo di test. assertEqual confronta risultato e attesa. assertRaises(KeyError) richiede tale eccezione o una sottoclasse. subTest(key=...) identifica varianti nello stesso metodo, quindi testsRun resta 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()

Esempi

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))

Risultato

1 1 0

L’esempio stampa 1 1 0.

Fonti