Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest.TestSuite

TestSuite raggruppa casi di test e suite annidate per un’esecuzione comune.

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

Sintassi

unittest.TestSuite(tests=())

TestSuite raggruppa casi di test e suite annidate per un’esecuzione comune.

Prima dell’esecuzione, iterazioni successive danno gli stessi elementi. debug() esegue i test senza registrare gli errori in un risultato e lascia propagare le eccezioni. addTest aggiunge un elemento e addTests accetta un iterabile. countTestCases conta anche i casi interni. run(result) condivide il risultato fornito e lo restituisce. Prima dell’esecuzione l’esempio conta 1 e 0.

La suite predefinita può poi rilasciare i riferimenti ai test.

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

Esempi

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

Risultato

1 0
1 True

La suite predefinita può poi rilasciare i riferimenti ai test.

Fonti