sh supports short-form -a and long-form --arg arguments as keyword arguments:

```
# resolves to "curl http://duckduckgo.com/ -o page.html --silent"
curl("http://duckduckgo.com/", o="page.html", silent=True)

# or if you prefer not to use keyword arguments, this does the same thing:
curl("http://duckduckgo.com/", "-o", "page.html", "--silent")

# resolves to "adduser amoffat --system --shell=/bin/bash --no-create-home"
adduser("amoffat", system=True, shell="/bin/bash", no_create_home=True)

# or
adduser("amoffat", "--system", "--shell", "/bin/bash", "--no-create-home")
```

Keyword Arguments

When passing multiple arguments to a command, each argument must be a separate string:
```
from sh import tar
tar("cvf", "/tmp/test.tar", "/my/home/directory")
```
The reason why arguments need to be separate strings is because shells automatically parse commandline arguments and break them up. They have a complex set of rules to take a single string of a command and arguments and separate them. 

University of Michigan - Ann Arbor

This package allows you to call any program as if it were a function. It works by running the binary commands on your system by dynamically resolving your $PATH, and then wrapping the binary in a function. 

To install sh, use the command:
```
pip install sh
```

sh documentation

Passing Arguments

sh can redirect the STDOUT and STDERR of a process to many different types of targets, using the _out and _err special kwargs. There are two instances:

- Filename: if a string is used, it is assumed to be a filename. 
```
import sh
sh.ifconfig(_out="/tmp/interfaces")
```
- File-like Object: any object that supports .write(data) can be used as well.
```
import sh
from io import StringIO

buf = StringIO()
sh.ifconfig(_out=buf)
print(buf.getvalue())
```

Learn Before

Related

Learn After