Base di conoscenzaCentro esami
ITItaliano
Scegli la lingua13

CKTIS / Python

unittest.TextTestRunner

TextTestRunner esegue un caso o una suite e scrive il rapporto su stream, che per impostazione predefinita è stderr.

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

Sintassi

unittest.TextTestRunner(stream=output, verbosity=1, failfast=False)

TextTestRunner esegue un caso o una suite e scrive il rapporto su stream, che per impostazione predefinita è stderr.

buffer=True cattura stdout e stderr del test, li scarta in caso di successo e li allega in caso di errore o fallimento. warnings applica durante l’esecuzione un filtro degli avvisi come 'ignore'. verbosity regola i dettagli e failfast interrompe i test dopo il primo fallimento o errore. run restituisce l’oggetto risultato.

L’esempio verifica testsRun, wasSuccessful() e la presenza di OK in StringIO senza dipendere dal tempo misurato.

import unittest,io
class A(unittest.TestCase):
    def test_fail(self): self.fail('sample')
    def test_next(self): pass
out=io.StringIO()
r=unittest.TextTestRunner(stream=out,verbosity=2,failfast=True).run(unittest.defaultTestLoader.loadTestsFromTestCase(A))
assert r.testsRun==1 and len(r.failures)==1 and not r.wasSuccessful()
assert 'test_fail' in out.getvalue() and 'FAILED' in out.getvalue()
import warnings,contextlib,sys
class Capture(unittest.TestCase):
    def test_a(self): print('discard');warnings.warn('quiet')
    def test_b(self): print('retain',file=sys.stderr);self.fail('broken')
out=io.StringIO()
with contextlib.redirect_stderr(io.StringIO()),contextlib.redirect_stdout(io.StringIO()):
    result=unittest.TextTestRunner(stream=out,buffer=True,warnings='ignore').run(unittest.defaultTestLoader.loadTestsFromTestCase(Capture))
assert 'retain' in result.failures[0][1] and 'discard' not in out.getvalue()
assert 'UserWarning: quiet' not in out.getvalue()
class Warn(unittest.TestCase):
    def test_warn(self): warnings.warn('filter-probe')
for mode, visible in [('always',True),('ignore',False)]:
    capture=io.StringIO()
    with contextlib.redirect_stderr(capture):
        unittest.TextTestRunner(stream=io.StringIO(),buffer=False,warnings=mode).run(Warn('test_warn'))
    assert ('UserWarning: filter-probe' in capture.getvalue()) is visible

unittest.TextTestRunner.run

run(test) esegue un caso o una suite, scrive il rapporto sul flusso configurato e restituisce un oggetto risultato. testsRun e wasSuccessful() verificano l’esito indipendentemente dalla durata stampata.

import io,unittest
out=io.StringIO()
runner=unittest.TextTestRunner(stream=out,verbosity=0)
suite=unittest.TestSuite([unittest.FunctionTestCase(lambda:None)])
result=runner.run(suite)
assert result.testsRun==1 and result.wasSuccessful() and "OK" in out.getvalue()

Esempi

import unittest
import io

class Check(unittest.TestCase):
    def test_total(self): self.assertEqual(2 + 3, 5)

out = io.StringIO()
r = unittest.TextTestRunner(stream=out).run(Check("test_total"))
print(r.testsRun, r.wasSuccessful(), "OK" in out.getvalue())

Risultato

1 True True

L’esempio verifica testsRun, wasSuccessful() e la presenza di OK in StringIO senza dipendere dal tempo misurato.

Fonti