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.