This module contains several tools for easing script output:

• osplitter, an output stream splitter
• writecounter, counts the number of write calls

The output stream splitter (osplitter)

When generating data from a typical simulation script, one usually wants the output redirected into several places. A common use case is to print log messages both to stderr and a file. The osplitter class can be used as a drop-in replacement for streams like the sys.stderr, with output redirected to several places by registering different steam objects with the osplitter. In the following example, log messages are output both to a temporary file and to sys.stderr:

>>> import sys, tempfile
>>> import outils
>>> outfile = tempfile.TemporaryFile()
>>> ostream = outils.osplitter(outfile, sys.stdout)
>>> print >>ostream, 'Logged message'
Logged message
>>> outfile.seek(0)
>>> outfile.read()
'Logged message
'
>>>

The write counter (writecounter)

This class implements a writer which simply counts the number of write operations. This can for example be used in conjunction for polling the progress of the data processing from a separate thread.