.. _installation:

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

Option 1: Download and Install
------------------------------
Simply download the package and install using pip_::

    pip install -e PATH_TO_DOWNLOADED_PACKAGE
    
Option 2: Install from the Bitbucket Repository
-----------------------------------------------
If you have Mercurial_, you can install directly from the BitBucket repository using pip_::

    pip install -e hg+https://bitbucket.org/tylerbutler/django-potpourri

.. _pip: http://www.pip-installer.org/
.. _Mercurial: http://mercurial.selenic.com/

Running Unit Tests
==================

You can easily run the unit tests provided in the package by