WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

assertEqual in unittest: Ist- und Sollwerte vergleichen

Vergleiche Ist- und Sollwerte mit `assertEqual`, bereite Testdaten mit `setUp` vor und prüfe mehrere Eingaben und Ausnahmen mit `unittest`.

Version: Python 3.12

Syntax

self.assertEqual(actual, expected, msg=None)

with self.subTest(label=value):
    self.assertEqual(actual, expected)

In Python 3.12 ist assertEqual eine Methode von unittest.TestCase. Übergib in self.assertEqual(actual, expected) zuerst den Istwert und dann den Sollwert. Die Methode prüft Gleichheit (==), nicht Identität (is). Ungleiche Werte lassen die Prüfung fehlschlagen; mit dem optionalen Argument msg kannst du Kontext hinzufügen.

Haben beide Operanden exakt denselben Typ, kann assertEqual mit einem typspezifischen Vergleich eine aussagekräftigere Fehlermeldung erzeugen. Das gilt für list, tuple, dict, set, frozenset, str und für Typen, die mit addTypeEqualityFunc() registriert wurden. Typgleichheit ist keine Voraussetzung für die Gleichheit der Werte.

setUp() bereitet die Testdaten vor jeder Testmethode vor, nicht vor jedem Untertest. In einer Schleife kennzeichnet with self.subTest(text=text): den Fall, damit der Fehlerbericht die Eingabe nennt. Ohne failfast verhindert eine fehlgeschlagene Prüfung in einem Untertest nicht, dass spätere Iterationen ausgeführt werden.

Prüfe Ausnahmen mit assertRaises. Führe die Operation im Block with self.assertRaises(ValueError): aus. Bei self.assertRaises(ValueError, int, text) übergibst du die Funktion, ohne sie aufzurufen, und gibst ihr Argument separat an. Die erwartete Ausnahme oder eine Unterklasse erfüllt die Prüfung; ohne Ausnahme schlägt sie fehl, und eine andere Ausnahme wird weitergereicht.

Beispiele

import io
import unittest


class IntConversionTests(unittest.TestCase):
    def setUp(self):
        self.inputs = ('0', '7', '-3', 'not a number')

    def test_direct(self):
        self.assertEqual(int(self.inputs[0]), 0)
        self.assertEqual(int(self.inputs[1]), 7)
        self.assertEqual(int(self.inputs[2]), -3)
        with self.assertRaises(ValueError):
            int(self.inputs[3])

    def test_subtests(self):
        for text, expected in zip(self.inputs[:3], (0, 7, -3)):
            with self.subTest(text=text):
                self.assertEqual(int(text), expected)
        self.assertRaises(ValueError, int, self.inputs[3])


if __name__ == '__main__':
    suite = unittest.defaultTestLoader.loadTestsFromTestCase(IntConversionTests)
    report = io.StringIO()
    result = unittest.TextTestRunner(stream=report).run(suite)
    if not result.wasSuccessful():
        raise SystemExit(report.getvalue())
    print(f'{result.testsRun} tests passed')

Ergebnis

2 tests passed

`test_direct` prüft dreimal direkt auf Gleichheit und prüft die Ausnahme in einem `with`-Block. `test_subtests` verwendet dieselben Eingaben in gekennzeichneten Untertests und übergibt die Funktion direkt an `assertRaises`. Die `2` zählt Testmethoden, nicht Untertests.

Zugehörige Lektionen

  • Python · Lektion 37 · Fortgeschritten · Version: 5
  • Python · Lektion 34 · Mittlere Stufe · Version: 3

Quellen