.. _install:

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

This part of the documentation covers installation of django-swingers.

Distribute & Pip
----------------

Installation is simple with `pip <http://www.pip-installer.org/>`_. ::

    $ pip install django-swingers

or, with `easy_install <http://pypi.python.org/pypi/setuptools>`_ ::

    $ easy_install django-swingers

To utilize templates, etc. from django-swingers in your django app, drop
`swingers` into your `settings.INSTALLED_APPS`.

Get the code
------------

Django-swingers is actively maintained on bitbucket, where the code is
`always available <https://bitbucket.org/dpaw/django-swingers>`_.

You can clone the repository: ::

    hg clone https://bitbucket.org/dpaw/django-swingers

Once you have a copy of the source, you can embed it in your Python package,
or install it to your site-packages easily::

    $ python setup.py install

You can run the django-swingers' test suite with::

    $ python setup.py test
