b706ec2f95
* unifying IO capturing methods * py.io.StdCapture and py.io.StdCaptureFD (and both have a classmethod 'call' that is a shortcut for capturing output while executing a function) * removing lots of duplicate code * providing some examples in py/doc/io.txt at least tests on win32 and linux seem to pass all for me. --HG-- branch : trunk
46 lines
948 B
Plaintext
46 lines
948 B
Plaintext
=======
|
|
py.io
|
|
=======
|
|
|
|
.. contents::
|
|
.. sectnum::
|
|
|
|
The 'py' lib provides helper classes for capturing IO during
|
|
execution of a program.
|
|
|
|
IO Capturing examples
|
|
===============================================
|
|
|
|
:api:`py.io.StdCapture`
|
|
---------------------------
|
|
|
|
Basic Example:
|
|
|
|
>>> import py
|
|
>>> capture = py.io.StdCapture()
|
|
>>> print "hello"
|
|
>>> out,err = capture.reset()
|
|
>>> out.strip() == "hello"
|
|
True
|
|
|
|
For calling functions you may use a shortcut:
|
|
>>> import py
|
|
>>> def f(): print "hello"
|
|
>>> res, out, err = py.io.StdCapture.call(f)
|
|
>>> out.strip() == "hello"
|
|
True
|
|
|
|
:api:`py.io.StdCaptureFD`
|
|
---------------------------
|
|
|
|
If you also want to capture writes to the stdout/stdin
|
|
filedescriptors you may invoke:
|
|
|
|
>>> import py, sys
|
|
>>> capture = py.io.StdCaptureFD()
|
|
>>> sys.stdout.write("hello")
|
|
>>> sys.stderr.write("world")
|
|
>>> out,err = capture.reset()
|
|
>>> out.strip() + err.strip() == "helloworld"
|
|
True
|