Base de conhecimentoCentro de Exames
PT · PTPortuguês (Portugal)
Escolher idioma13

CKTIS / Python

unittest.TestSuite

TestSuite agrupa casos de teste e conjuntos aninhados para execução conjunta.

Versão: Python 3.14; repository image, production runtime not attested

Sintaxe

unittest.TestSuite(tests=())

TestSuite agrupa casos de teste e conjuntos aninhados para execução conjunta.

Antes da execução, iterações sucessivas dão os mesmos elementos. debug() executa os testes sem registar erros num resultado e deixa as exceções chegar a quem chamou. addTest acrescenta um elemento e addTests aceita um iterável. countTestCases conta também os casos internos. run(result) partilha o resultado fornecido e devolve-o. Antes da execução o exemplo conta 1 e 0.

O conjunto predefinido pode depois libertar as referências aos testes.

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

Exemplos

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

Resultado

1 0
1 True

O conjunto predefinido pode depois libertar as referências aos testes.

Fontes