CKTIS / Python
unittest.TestLoader
TestLoader selecteert testmethoden en bouwt er een suite van om later uit te voeren.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
unittest.TestLoader()TestLoader selecteert testmethoden en bouwt er een suite van om later uit te voeren.
discover zoekt modules volgens een patroon en gebruikt hun optionele load_tests(loader, tests, pattern). Een importfout komt in loader.errors en levert een vervangende test op die de fout bij uitvoering meldt. getTestCaseNames kiest standaard aanroepbare attributen met het voorvoegsel test en sorteert hun namen. testMethodPrefix wijzigt het voorvoegsel en sortTestMethodsUsing de sortering.
Hier valt helper af en bouwt loadTestsFromTestCase een suite met één instantie voor 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 neemt een TestCase-klasse en bouwt een suite voor passende methoden. Het laden voert hun code nog niet uit. Hier wordt test_a opgenomen en helper overgeslagen.
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"]
Voorbeelden
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())
Resultaat
['test_one'] 1
Hier valt helper af en bouwt loadTestsFromTestCase een suite met één instantie voor test_one.