CKTIS / Python
unittest.TestCase
Une instance de TestCase exécute une méthode désignée par son nom.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
unittest.TestCase(methodName='runTest')Une instance de TestCase exécute une méthode désignée par son nom.
Si setUp échoue, le corps et tearDown sont omis, puis les nettoyages s’exécutent en ordre inverse d’inscription. subTest identifie la variante échouée et permet de poursuivre les autres lors d’une exécution ordinaire. Après un setUp réussi, tearDown s’exécute même si une assertion échoue. Les fonctions ajoutées avec addCleanup s’exécutent après tearDown ou après un échec de setUp. Le test d’égalité de 4 et 5 entre dans failures, une autre exception telle que ValueError dans errors.
L’exemple affiche 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 prépare l’état avant la méthode de test. assertEqual compare résultat et attente. assertRaises(KeyError) exige cette exception ou une sous-classe. subTest(key=...) identifie les variantes au sein d’une seule méthode, donc testsRun reste à 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()
Exemples
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))
Résultat
1 1 0
L’exemple affiche 1 1 0.