CKTIS / Python
unittest.TestLoader
TestLoader sélectionne des méthodes de test et en construit une suite à exécuter ensuite.
Version : Python 3.14; repository image, production runtime not attested
Syntaxe
unittest.TestLoader()TestLoader sélectionne des méthodes de test et en construit une suite à exécuter ensuite.
discover recherche des modules par motif et utilise leur éventuel load_tests(loader, tests, pattern). Une erreur d’import lors de la découverte figure dans loader.errors et entraîne un test de substitution qui signale l’erreur à l’exécution. Par défaut getTestCaseNames choisit les attributs appelables de préfixe test et trie leurs noms. testMethodPrefix change le préfixe et sortTestMethodsUsing le tri.
Ici helper est écarté et loadTestsFromTestCase crée une suite avec une instance pour 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 reçoit une classe TestCase et construit une suite pour les méthodes choisies. Le chargement n’exécute pas leurs corps. Ici test_a est retenue et helper écartée.
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"]
Exemples
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())
Résultat
['test_one'] 1
Ici helper est écarté et loadTestsFromTestCase crée une suite avec une instance pour test_one.