Skip to main content
Python Software Foundation 20th Year Anniversary Fundraiser  Donate today!

Guacamole is an command line tool library for Python

Project description

Guacamole - Framework for Creating Command Line Applications

.. image::

.. image::

.. image::

Tools, done right

Guacamole is a LGPLv3 licensed toolkit for creating good command line
applications. Guacamole that does the right things for you and makes writing
applications easier.

.. testsetup::

import guacamole

.. doctest::

>>> class HelloWorld(guacamole.Command):
... """A simple hello-world application."""
... def register_arguments(self, parser):
... parser.add_argument('name')
... def invoked(self, ctx):
... print("Hello {0}!".format(

Running it directly is as simple as calling ``main()``:

.. doctest::

>>> HelloWorld().main(['Guacamole'], exit=False)
Hello Guacamole!

What you didn't have to do is what matters:

- configure the argument parser
- define and setup application logging
- initialize internationalization features
- add debugging facilities
- write a custom crash handler


* Free software: LGPLv3 license
* Documentation:
* Create command classes and run them from command line.
* Group commands to create complex tools.
* Use recipes, ingredients and spices to customize behavior


0.9.2 (2015-08-06)

* Fix

0.9.1 (2015-08-06)

* Fix

0.9 (2015-05-11)

* Vastly improved documentation
* Bugfixes and changes based on early feedback
* New cmdtree module with two ingredients (for instantiating commands and for
dispatching the invoked method)
* Simplified argparse ingredient (for just handling parser)
* Unit tests and doctests for some of the functionality

0.8 (2015-04-21)

* First release on PyPI.


* Released on PyPI as a part of plainbox as ``plainbox.impl.clitools``,
``plainbox.impl.logging``, ``plainbox.i18n`` and

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for guacamole, version 0.9.2
Filename, size File type Python version Upload date Hashes
Filename, size guacamole-0.9.2-py2.py3-none-any.whl (32.4 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size guacamole-0.9.2.tar.gz (59.4 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page