CKTIS / Python
unittest.TestSuite
TestSuite groepeert testgevallen en geneste suites voor een gezamenlijke uitvoering.
Versie: Python 3.14; repository image, production runtime not attested
Syntax
unittest.TestSuite(tests=())TestSuite groepeert testgevallen en geneste suites voor een gezamenlijke uitvoering.
Vóór de uitvoering levert herhaald itereren dezelfde elementen op. debug() voert tests uit zonder fouten in een resultaat vast te leggen en laat de uitzondering de aanroeper bereiken. addTest voegt één element toe en addTests accepteert een itereerbaar object. countTestCases telt ook de gevallen in de onderliggende suites. run(result) deelt het opgegeven resultaat en geeft het terug. Vóór de uitvoering telt het voorbeeld 1 en 0.
De standaardsuite kan daarna testreferenties vrijgeven.
import unittest
events=[]
class Check(unittest.TestCase):
def test_a(self): events.append('a')
def test_b(self): events.append('b')
inner=unittest.TestSuite([Check('test_a')])
outer=unittest.TestSuite()
outer.addTests([inner,Check('test_b')])
assert outer.countTestCases()==2
r=unittest.TestResult()
assert outer.run(r) is r and events==['a','b'] and r.testsRun==2
case=Check('test_a')
suite=unittest.TestSuite([case])
assert list(suite)==list(suite)==[case]
def bad(): raise ValueError('from case')
try: unittest.TestSuite([unittest.FunctionTestCase(bad)]).debug()
except ValueError as ex: assert str(ex)=='from case'
else: raise AssertionError
Voorbeelden
import unittest
class Check(unittest.TestCase):
def test_total(self): self.assertEqual(2 + 3, 5)
suite = unittest.TestSuite([Check("test_total")])
print(suite.countTestCases(), unittest.TestSuite().countTestCases())
r = unittest.TestResult()
suite.run(r)
print(r.testsRun, r.wasSuccessful())
Resultaat
1 0 1 True
De standaardsuite kan daarna testreferenties vrijgeven.