.. _installation:

Installation
============

The most recent release is always available in the `cheeseshop`_ and can be
installed using `easy_install`_::

    easy_install py-simplecouchdb

Alternatly, you can also install the development version from 
our `Mercurial`_ repository::

    hg clone https://dev.e-engura.org/hg/py-simplecouchdb
    cd py-simplecouchdb
    sudo python setup.py install

Last command will install py-simplecouchdb as a package via setuptools. This
will make it available in your python path. Alternately you can copy or symlink
the simplecouchdb subdirectory into your site-packages directory or
anywhere in your PYTHONPATH.

Requirements
============

To use py-simplecouchdb you will need **Python 2.5** or later and
`CouchDB`_. You will
need to install :

* `httplib2 <http://code.google.com/p/httplib2/>`_
* `simplejson <http://code.google.com/p/httplib2/>`_ (Not needed for Python 2.6) 

.. _cheeseshop: http://pypi.python.org/pypi/WTForms/
.. _easy_install: http://peak.telecommunity.com/DevCenter/EasyInstall
.. _Mercurial: http://www.selenic.com/mercurial/
.. _CouchDB: http://couchdb.apache.org

