Tools for quickly creating Command Line Interface scripts with Python.
All the package documentation is hosted on GitHub pages: http://rshk.github.io/clitools/.
You can create your CLI script like this:
from clitools import CliApp
cli = CliApp()
@cli.command
def hello(name='world', bye=False):
greet = 'Bye' if bye else 'Hello'
print("{0}, {1}".format(greet, name))
if __name__ == '__main__':
cli.run()and then run it right away!
% python sample_app.py
usage: cli-app [-h] {hello} ...
cli-app: error: too few arguments
>>> exited 2
% python sample_app.py --help
usage: cli-app [-h] {hello} ...
positional arguments:
{hello} sub-commands
hello
optional arguments:
-h, --help show this help message and exit
% python sample_app.py hello
Hello, world
% python sample_app.py hello --name=Python
Hello, Python
% python sample_app.py hello --help
usage: cli-app hello [-h] [--bye] [--name NAME]
optional arguments:
-h, --help show this help message and exit
--bye
--name NAME
% python sample_app.py hello --bye --name=Spam
Bye, Spam..super-cool, isn't it?
Cliff is meant for building complex, fully-featured CLI applications. CliTools just acts as a "bridge" to quickly expose a Python function as a script in the "most obvious" way, without need for extensibility or support for more complex use cases.
The main goal is to provide something you can quickly use without having to continuously refer to the documentation :)
