Note

This documentation is for a development version of IPython. There may be significant differences from the latest stable release (1.2.1).

Module: utils.capture

IO capturing utilities.

3 Classes

class IPython.utils.capture.RichOutput(source='', data=None, metadata=None)

Bases: object

__init__(source='', data=None, metadata=None)

class IPython.utils.capture.CapturedIO(stdout, stderr, outputs=None)

Bases: object

Simple object for containing captured stdout/err and rich display StringIO objects

Each instance c has three attributes:

• c.stdout : standard output as a string
• c.stderr : standard error as a string
• c.outputs: a list of rich display outputs

Additionally, there’s a c.show() method which will print all of the above in the same order, and can be invoked simply via c().

__init__(stdout, stderr, outputs=None)

outputs

A list of the captured rich display outputs, if any.

If you have a CapturedIO object c, these can be displayed in IPython using:

from IPython.display import display
for o in c.outputs:
    display(o)

show()

write my output to sys.stdout/err as appropriate

stderr

Captured standard error

stdout

Captured standard output

class IPython.utils.capture.capture_output(stdout=True, stderr=True, display=True)

Bases: object

context manager for capturing stdout/err

__init__(stdout=True, stderr=True, display=True)