WissensdatenbankPrüfungszentrum
DEDeutsch
Sprache wählen13

CKTIS / Python

unittest.TestLoader

TestLoader wählt Testmethoden aus und baut daraus eine später ausführbare Suite.

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

Syntax

unittest.TestLoader()

TestLoader wählt Testmethoden aus und baut daraus eine später ausführbare Suite.

discover sucht Module nach Muster und verwendet deren optionales load_tests(loader, tests, pattern). Ein Importfehler bei der Suche landet in loader.errors und erzeugt einen Ersatztest, der beim Lauf den Fehler meldet. getTestCaseNames wählt standardmäßig aufrufbare Attribute mit dem Präfix test und sortiert ihre Namen. testMethodPrefix ändert das Präfix, sortTestMethodsUsing die Sortierung.

Im Beispiel entfällt helper und loadTestsFromTestCase erzeugt eine Suite mit einer Instanz für test_one.

import unittest
class Check(unittest.TestCase):
    def test_z(self): pass
    def test_a(self): pass
    def check_b(self): pass
loader=unittest.TestLoader()
assert loader.getTestCaseNames(Check)==['test_a','test_z']
loader.testMethodPrefix='check'
assert [case._testMethodName for case in loader.loadTestsFromTestCase(Check)]==['check_b']
import tempfile,pathlib
with tempfile.TemporaryDirectory() as folder:
    p=pathlib.Path(folder)
    (p/'test_ref_broken.py').write_text("raise ImportError('missing')")
    (p/'test_ref_hook.py').write_text("import unittest\ndef load_tests(loader,tests,pattern):\n    assert pattern=='test*.py'\n    return unittest.TestSuite([unittest.FunctionTestCase(lambda: None)])")
    found=loader.discover(folder)
    assert found.countTestCases()==2 and len(loader.errors)==1
    r=unittest.TestResult()
    found.run(r)
    assert r.testsRun==2 and len(r.errors)==1

unittest.TestLoader.loadTestsFromTestCase

loadTestsFromTestCase nimmt eine TestCase-Klasse und baut eine Suite für passende Methoden. Beim Laden laufen deren Rümpfe noch nicht. Hier wird test_a aufgenommen und helper ausgelassen.

import unittest
visits=[]
class Names(unittest.TestCase):
    def test_a(self): visits.append("a")
    def helper(self): visits.append("helper")
suite=unittest.TestLoader().loadTestsFromTestCase(Names)
assert suite.countTestCases()==1 and visits==[]
suite.run(unittest.TestResult())
assert visits==["a"]

Beispiele

import unittest
class Check(unittest.TestCase):
    def test_one(self): pass
    def helper(self): pass

loader = unittest.TestLoader()
print(loader.getTestCaseNames(Check))
print(loader.loadTestsFromTestCase(Check).countTestCases())

Ergebnis

['test_one']
1

Im Beispiel entfällt helper und loadTestsFromTestCase erzeugt eine Suite mit einer Instanz für test_one.

Quellen