hbutils.testing.capture

Overview:

Utilities for capturing different kinds of results, which can be useful in testing.

capture_output

hbutils.testing.capture.capture_output() → AbstractContextManager[hbutils.testing.capture.output.OutputCaptureResult]

Overview:

Capture all the output to sys.stdout and sys.stderr in this with block.

Examples::

>>> from hbutils.testing import capture_output
>>> import sys
>>>
>>> with capture_output() as r:
...     print('this is stdout')
...     print('this is stderr', file=sys.stderr)
...
>>> r.stdout
'this is stdout\n'
>>> r.stderr
'this is stderr\n'

OutputCaptureResult

class hbutils.testing.capture.OutputCaptureResult

Overview:

Result model of output capturing.

__init__()

Constructor of OutputCaptureResult.

put_result(stdout: Optional[str], stderr: Optional[str])

Put result inside this model.

Parameters:

• stdout – Stdout result.

• stderr – Stderr result.

property stderr

Stderr of the output result.

Note

Do not use this property when capture_output()’s with block is not quited, or this property will be jammed due to the deadlock inside.

property stdout

Stdout of the output result.

Note

Do not use this property when capture_output()’s with block is not quited, or this property will be jammed due to the deadlock inside.

disable_output

hbutils.testing.capture.disable_output() → AbstractContextManager[hbutils.testing.capture.output.OutputCaptureResult]

Overview:

Disable all the output to sys.stdout and sys.stderr in this with block.

Examples::

>>> import sys
>>> from hbutils.testing import disable_output
>>>
>>> with disable_output():  # no output will be shown
...     print('this is stdout')
...     print('this is stderr', file=sys.stderr)