oslotest.output module

class oslotest.output.CaptureOutput(do_stdout=None, do_stderr=None)

Bases: Fixture

Optionally capture the output streams.

The behavior is managed through arguments to the constructor. The default behavior is controlled via two environment variables. If OS_STDOUT_CAPTURE is true then stdout is captured and if OS_STDERR_CAPTURE is true then stderr is captured.

“True” values include True, true, 1, and yes.

Parameters:

• do_stdout (bool) – Whether to capture stdout.

• do_stderr (bool) – Whether to capture stderr.

stdout

The stream attribute from a StringStream instance replacing stdout.

stderr

The stream attribute from a StringStream instance replacing stderr.

setUp()

Prepare the Fixture for use.

This should not be overridden. Concrete fixtures should implement _setUp. Overriding of setUp is still supported, just not recommended.

After setUp has completed, the fixture will have one or more attributes which can be used (these depend totally on the concrete subclass).

Raises:

MultipleExceptions if _setUp fails. The last exception captured within the MultipleExceptions will be a SetupError exception.

Returns:

None.

Changed in 1.3:

The recommendation to override setUp has been reversed - before 1.3, setUp() should be overridden, now it should not be.

Changed in 1.3.1:

BaseException is now caught, and only subclasses of Exception are wrapped in MultipleExceptions.