WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

unittest.TestCase

Eine TestCase-Instanz führt eine benannte Methode aus.

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

Syntax

unittest.TestCase(methodName='runTest')

Eine TestCase-Instanz führt eine benannte Methode aus.

Scheitert setUp, entfallen Rumpf und tearDown, registrierte Aufräumfunktionen laufen in umgekehrter Reihenfolge. Ein subTest kennzeichnet die fehlgeschlagene Variante und lässt weitere Varianten beim normalen Lauf fortfahren. Nach erfolgreichem setUp läuft tearDown auch beim Fehlschlag einer Assertion. Mit addCleanup registrierte Funktionen laufen nach tearDown oder nach fehlgeschlagenem setUp. Der gescheiterte Vergleich von 4 und 5 landet in failures, ein anderer Fehler wie ValueError in errors.

Das Beispiel gibt 1 1 0 aus.

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 bereitet den Zustand vor der Testmethode vor. assertEqual vergleicht Ergebnis und Erwartung. assertRaises(KeyError) verlangt diese Ausnahme oder eine Unterklasse. subTest(key=...) kennzeichnet Varianten innerhalb einer Methode, deshalb bleibt testsRun bei 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()

Beispiele

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

Ergebnis

1 1 0

Das Beispiel gibt 1 1 0 aus.

Quellen