To execute something like the following,
```
my-command --arg1=val1 arg2 --arg3=val3
```
the user will have to use raw ordered arguments instead of using the keyword argument, such as 
```
sh.my_command("--arg1=val1", "arg2", "--arg3=val3")
```
The following will be a wrong instance because in Python, position arguments like arg2 cannot come after keyword arguments. 
```
sh.my_command(arg1="val1", "arg2", arg3="val3")
```

Ordering keyword arguments

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")
```

University of Michigan - Ann Arbor

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. 

Learn Before

Related

Learn After