Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / Python

unittest.TextTestRunner

TextTestRunner izvede primer ali zbirko in poročilo zapiše v stream, privzeto stderr.

Različica: Python 3.14; repository image, production runtime not attested

Sintaksa

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

TextTestRunner izvede primer ali zbirko in poročilo zapiše v stream, privzeto stderr.

buffer=True prestreže stdout in stderr testa, ju pri uspehu zavrže in ju pri napaki ali neuspehu priloži. warnings za čas izvedbe nastavi filter opozoril, denimo 'ignore'. verbosity določa podrobnost, failfast pa ustavi nadaljnje teste po prvem neuspehu ali napaki. run vrne objekt z rezultatom.

Primer preveri testsRun, wasSuccessful() in prisotnost OK v StringIO neodvisno od izmerjenega časa.

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) izvede primer ali zbirko, izpiše poročilo v nastavljeni tok in vrne objekt z rezultatom. testsRun in wasSuccessful() preverita izid neodvisno od izpisanega časa.

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

Primeri

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

Rezultat

1 True True

Primer preveri testsRun, wasSuccessful() in prisotnost OK v StringIO neodvisno od izmerjenega časa.

Viri