Base de connaissancesCentre d’examen
FRFrançais
Choisir la langue13

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.

Sources