CKTIS / Python
unittest.TextTestRunner
TextTestRunner führt einen Fall oder eine Suite aus und schreibt den Bericht nach stream, standardmäßig stderr.
Version: Python 3.14; repository image, production runtime not attested
Syntax
unittest.TextTestRunner(stream=output, verbosity=1, failfast=False)TextTestRunner führt einen Fall oder eine Suite aus und schreibt den Bericht nach stream, standardmäßig stderr.
buffer=True fängt stdout und stderr des Tests ab, verwirft sie bei Erfolg und legt sie bei Fehlern oder Fehlschlägen bei. warnings setzt für den Lauf einen Warnfilter wie 'ignore'. verbosity steuert die Ausführlichkeit, failfast beendet weitere Tests nach dem ersten Fehlschlag oder Fehler. run liefert das Ergebnisobjekt.
Das Beispiel prüft testsRun, wasSuccessful() und OK im StringIO unabhängig von der gemessenen Dauer.
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) führt einen Fall oder eine Suite aus, schreibt den Bericht in den konfigurierten Stream und liefert ein Ergebnisobjekt. testsRun und wasSuccessful() prüfen das Ergebnis unabhängig von der ausgegebenen Dauer.
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()
Beispiele
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())
Ergebnis
1 True True
Das Beispiel prüft testsRun, wasSuccessful() und OK im StringIO unabhängig von der gemessenen Dauer.