WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

Tests mit loadTestsFromTestCase aus einer Klasse laden

Erstelle eine Testsuite aus einer `unittest.TestCase`-Unterklasse und unterscheide geladene Testmethoden von den darin ausgeführten Untertests.

Version: Python 3.12

Syntax

unittest.defaultTestLoader.loadTestsFromTestCase(testCaseClass)
unittest.TestLoader().loadTestsFromTestCase(testCaseClass)

In Python 3.12 erwartet TestLoader.loadTestsFromTestCase eine Unterklasse von unittest.TestCase, keine Instanz. Die Methode sucht in der angegebenen Klasse, statt wie discover() Dateien zu durchsuchen, und führt keine Tests aus. Sie liefert eine Testsuite, standardmäßig vom Typ unittest.TestSuite.

Für jede von getTestCaseNames() ausgewählte Methode erzeugt der Loader eine eigene Instanz der Klasse. Standardmäßig wählt er auch geerbte Methoden aus, deren Namen mit test beginnen (ein Unterstrich ist nicht erforderlich). Wird keine Methode ausgewählt, die Klasse implementiert aber runTest(), entsteht ein Testfall für runTest().

Verwende den gemeinsam genutzten unittest.defaultTestLoader, wenn du keine eigenen Einstellungen brauchst. Erzeuge eine eigene Instanz mit unittest.TestLoader(), um z. B. testMethodPrefix zu ändern, ohne den gemeinsamen Loader zu verändern. Zähle die Fälle vor der Ausführung mit countTestCases(). Die Durchläufe von subTest() finden innerhalb einer bereits geladenen Methode statt und fügen der Suite keine eigenen Testfälle hinzu.

Beispiele

import unittest


class TwoTests(unittest.TestCase):
    def test_positive(self):
        for n in range(1, 6):
            with self.subTest(n=n):
                self.assertEqual(abs(n), n)

    def test_negative(self):
        for n in range(-4, 0):
            with self.subTest(n=n):
                self.assertEqual(abs(n), -n)


class FourTests(TwoTests):
    def test_zero(self):
        self.assertEqual(abs(0), 0)

    def test_negative_float(self):
        self.assertEqual(abs(-1.5), 1.5)


def main():
    loader = unittest.defaultTestLoader
    for case_class in (TwoTests, FourTests):
        suite = loader.loadTestsFromTestCase(case_class)
        loaded = suite.countTestCases()
        result = unittest.TestResult()
        suite.run(result)
        print(f"{case_class.__name__}: loaded={loaded}, run={result.testsRun}, ok={result.wasSuccessful()}")


if __name__ == "__main__":
    main()

Ergebnis

TwoTests: loaded=2, run=2, ok=True
FourTests: loaded=4, run=4, ok=True

`TwoTests` hat zwei Testmethoden, die insgesamt neun Untertests ausführen. `FourTests` erbt beide Methoden und ergänzt zwei eigene. Deshalb sind `loaded` und `run` für die erste Klasse jeweils 2 und für die zweite jeweils 4. `ok=True` in beiden Zeilen zeigt, dass beide Suites erfolgreich waren.

Zugehörige Lektionen

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

Quellen