CKTIS / Python
`unittest.TestCase.setUp`: jeden Test vorbereiten
Mit `setUp()` erhält jeder Test frische Daten. Mit `assertEqual()` prüfst du Werte, mit `assertRaises()` eine erwartete Ausnahme.
Version: Python 3.12
Syntax
import unittest
class ExampleTests(unittest.TestCase):
def setUp(self):
self.items = [10, 20]unittest.TestCase.setUp ist eine Instanzmethode, die unittest unmittelbar vor jeder ausgeführten Testmethode automatisch aufruft. Definiere setUp(self) in einer Unterklasse von unittest.TestCase und speichere die Testdaten als Teil der Testumgebung (Fixture) in Attributen von self. Die Standardimplementierung tut nichts.
unittest erstellt für jede Testmethode eine eigene TestCase-Instanz. Erzeuge in setUp() eine neue Liste, statt eine veränderliche Liste als Klassenattribut zu teilen. Im Beispiel verändert test_pop seine Liste, während test_remove_missing mit einer neuen Liste [10, 20] beginnt. setUpClass() ist eine Klassenmethode für die gemeinsame Vorbereitung auf Klassenebene, nicht für die Initialisierung jedes einzelnen Tests.
Die drei assertEqual(ist, soll)-Aufrufe prüfen Wertgleichheit, nicht Objektidentität: den zurückgegebenen Eintrag, die Liste nach pop() und die Liste nach dem erfolglosen Entfernen. with self.assertRaises(ValueError): umschließt nur den Versuch, den fehlenden Wert zu entfernen. Wird keine Ausnahme ausgelöst, schlägt die Prüfung fehl; eine andere Ausnahme wird weitergegeben. Alternativ kannst du die aufrufbare Methode mit ihrem Argument übergeben: self.assertRaises(ValueError, self.items.remove, 99).
Löst setUp() eine Ausnahme aus, werden weder die Testmethode noch tearDown() ausgeführt. AssertionError zählt als fehlgeschlagener Test, unittest.SkipTest als übersprungener Test und die meisten anderen Ausnahmen als Fehler. Bereits mit addCleanup() registrierte Aufräumfunktionen laufen trotzdem, wenn unittest den Test bei der Vorbereitung als fehlgeschlagen, fehlerhaft oder übersprungen erfasst. Wird KeyboardInterrupt in setUp() nicht abgefangen, gibt TestCase.run() die Ausnahme in Python 3.12 jedoch weiter, bevor doCleanups() aufgerufen wird. Nach erfolgreicher Vorbereitung läuft tearDown() auch dann, wenn der Test fehlschlägt.
Beispiele
import unittest
class ListTests(unittest.TestCase):
def setUp(self):
self.items = [10, 20]
def test_pop(self):
removed = self.items.pop()
self.assertEqual(removed, 20)
self.assertEqual(self.items, [10])
def test_remove_missing(self):
with self.assertRaises(ValueError):
self.items.remove(99)
self.assertEqual(self.items, [10, 20])
if __name__ == "__main__":
suite = unittest.defaultTestLoader.loadTestsFromTestCase(ListTests)
result = unittest.TestResult()
suite.run(result)
print(f"Tests run: {result.testsRun}")
print(f"Successful: {result.wasSuccessful()}")
raise SystemExit(0 if result.wasSuccessful() else 1)
Ergebnis
Tests run: 2 Successful: True
Führe `python list_tests.py` mit Python 3.12 aus. Die erwartete Ausgabe zeigt zwei ausgeführte Tests und eine erfolgreiche Testsuite; das Skript gibt keine Laufzeit aus.
Zugehörige Lektionen
- Python · Lektion 34 · Mittlere Stufe · Version: 3