>>> from shell import ex
>>> ex('echo hello shell.py').stdout()
'hello shell.py\n'

from shell import p
pipeline = (p('ifconfig')
            .p('grep -A 1 eth0')
            .p('grep inet')
            .p('awk "{print $2}"')
            .p('cut -d: -f 2'))
print pipeline.stdout()

from shell import pipe_all
pipeline = shell.pipe_all(['ifconfig',
                           'grep -A 1 eth0',
                           'grep inet',
                           'awk "{print $2}"',
                           'cut -d: -f 2'])
print pipeline.stdout()

>>> from shell import instream
>>> instream('1 2 3').p('awk "{print $1}"').stdout()
'1\n'

>>> from shell import ex
>>> ex('echo 1 2 3').p('awk "{print $1}"').stdout()