KennisbankExamencentrum
NL · NLNederlands (Nederland)
Taal kiezen13

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.

Bronnen