"""A better way to run shell commands in Python."""
Built because every time I go to use subprocess, I spend more time in the docs & futzing around than actually implementing what I'm trying to get done.
Full docs are at https://shell.readthedocs.org/en/latest/.
- Python 2.6+ or Python 3.3+
If you just need to quickly run a command, you can use the shell
shortcut function:
>>> from shell import shell
>>> ls = shell('ls')
>>> for file in ls.output():
... print file
'another.txt'
If you need to extend the behavior, you can also use the Shell
object:
>>> from shell import Shell
>>> sh = Shell(has_input=True)
>>> cat = sh.run('cat -u')
>>> cat.write('Hello, world!')
>>> cat.output()
['Hello, world!']
You can even chain calls if you'd like:
>>> from shell import shell
>>> shell('cat -u', has_input=True).write('Hello, world!').output()
['Hello, world!']
Using pip
, simply run:
pip install shell
New BSD