CKTIS / Python
unittest.TestLoader
TestLoader seleziona i metodi di test e costruisce una suite da eseguire in seguito.
Versione: Python 3.14; repository image, production runtime not attested
Sintassi
unittest.TestLoader()TestLoader seleziona i metodi di test e costruisce una suite da eseguire in seguito.
discover cerca i moduli per modello e usa la loro funzione facoltativa load_tests(loader, tests, pattern). Un errore di importazione viene annotato in loader.errors e genera un test sostitutivo che segnala l’errore durante l’esecuzione. Per impostazione predefinita getTestCaseNames sceglie gli attributi chiamabili con prefisso test e ne ordina i nomi. testMethodPrefix cambia il prefisso e sortTestMethodsUsing l’ordinamento.
Qui helper è escluso e loadTestsFromTestCase crea una suite con un’istanza per 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 riceve una classe TestCase e costruisce una suite per i metodi selezionati. Il caricamento non esegue i corpi. Qui test_a è incluso e helper escluso.
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"]
Esempi
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())
Risultato
['test_one'] 1
Qui helper è escluso e loadTestsFromTestCase crea una suite con un’istanza per test_one.