Installing ``cartouche``
========================

``cartouche`` is available on the `Python Package Index`_ (PyPI) and can be
installed with ``easy_install`` so long as you have `setuptools`_ installed
already::

  $ easy_install cartouche

Alternatively, you can download and unpack the source distribution from the
``cartouche`` `downloads page`_ or PyPI. You should then unpack the source
distribution into a temporary directory and run the setup script which will
install ``cartouche`` into the current Python environment, for example::

  $ tar xzf cartouche-0.9.tar.gz
  $ cd cartouche-0.9
  $ python setup.py install


.. _Python Package Index: http://pypi.python.org/pypi/asq/

.. _setuptools: http://pypi.python.org/pypi/setuptools/

.. _downloads page: http://code.google.com/p/cartouche/downloads/list