Baza wiedzyCentrum egzaminacyjne
PLPolski
Wybierz język13

CKTIS / Python

unittest.TestLoader

TestLoader wybiera metody testowe i buduje z nich zestaw do późniejszego wykonania.

Wersja: Python 3.14; repository image, production runtime not attested

Składnia

unittest.TestLoader()

TestLoader wybiera metody testowe i buduje z nich zestaw do późniejszego wykonania.

discover wyszukuje moduły według wzorca i używa load_tests(loader, tests, pattern), jeśli moduł definiuje ten punkt rozszerzenia. Błąd importu przy odkrywaniu trafia do loader.errors, a zestaw zawiera zastępczy test zgłaszający błąd przy uruchomieniu. getTestCaseNames domyślnie wybiera wywoływalne atrybuty z prefiksem test i sortuje ich nazwy. testMethodPrefix zmienia prefiks, a sortTestMethodsUsing sposób sortowania.

W przykładzie helper odpada i loadTestsFromTestCase tworzy zestaw z jedną instancją dla 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 przyjmuje klasę TestCase i tworzy zestaw przypadków dla pasujących metod. Samo ładowanie nie uruchamia ich ciał. Tutaj test_a jest wybrane, a helper pominięte.

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"]

Przykłady

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())

Wynik

['test_one']
1

W przykładzie helper odpada i loadTestsFromTestCase tworzy zestaw z jedną instancją dla test_one.

Źródła