CKTIS / Python
unittest.TestCase
Een TestCase-instantie voert één bij naam gekozen methode uit.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
unittest.TestCase(methodName='runTest')Een TestCase-instantie voert één bij naam gekozen methode uit.
Mislukt setUp, dan vervallen de methode en tearDown en draaien opruimfuncties in omgekeerde registratievolgorde. subTest identificeert de mislukte variant en laat bij een normale uitvoering andere varianten doorgaan. Na een geslaagde setUp wordt tearDown ook bij een mislukte assertie uitgevoerd. Met addCleanup geregistreerde functies volgen na tearDown of na een mislukte setUp. De vergelijking van 4 en 5 komt in failures, een andere uitzondering zoals ValueError in errors.
Het voorbeeld geeft 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 bereidt de toestand vóór de testmethode voor. assertEqual vergelijkt resultaat en verwachting. assertRaises(KeyError) vereist die uitzondering of een subklasse. subTest(key=...) markeert varianten binnen één methode, zodat testsRun 1 blijft.
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()
Voorbeelden
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))
Resultaat
1 1 0
Het voorbeeld geeft 1 1 0.