Module SystemCalls

source code

The module 'epyunit.SystemCalls' provides the controlled execution of subprocesses as units.

The features are foreseen to support easy setups for unit and regression tests on complex command line options and their combinations. These are in designed to be used in conjunction with with PyUnit, either within Eclipse and PyDev, or from the command line.

The provided feature set is supported on the platforms: Linux, MacOS, BSD, Solaris, and Windows.

A quick example call is:

python -c 'from epyunit.SystemCalls import SystemCalls;x=SystemCalls(**{"proceed":"trace"});x.callit("myscript.sh xOK")'

or:

python -c 'from epyunit.SystemCalls import SystemCalls;x=SystemCalls(**{"proceed":"trace"});x.callit("myscript.py xOK")'

SECURITY REMARK: Current version supports for subprocesses the ShellMode only. For test environments in R&D this - hopefully - is perfectly OK, else eventual security issues has to be considered.

Directs the output stream
Args:
    s: String for output
    _o: Output channel:
        _O_STD, _O_ERR, _O_STR

Returns:
    _o == _O_STD: string
    _o == _O_ERR: prints to STDERR, returns True
    _o == _O_STR: prints to STDOUT, returns True
    else:         returns False

Raises:
    pass/through