Installation instructions
=========================

:synopsis: Installing django-extensions


Download and installation
-------------------------

Pip and easy_install
^^^^^^^^^^^^^^^^^^^^

You can use pip or easy_install to install django-extensions::

  $ pip install django-extensions

or::

  $ easy_install django-extensions

Download
^^^^^^^^

Download the latest packaged version from
http://pypi.python.org/pypi/django-extensions/ and unpack it. Inside is a
script called setup.py. Enter this command::

  python setup.py install

...and the package will install automatically.

Installation
^^^^^^^^^^^^

You will need to add the *django_extensions* application to the INSTALLED_APPS
setting of your Django project *settings.py* file.::

  INSTALLED_APPS = (
      ...
      'django_extensions',
  )

This will make sure that Django finds the additional management commands
provided by *django-extensions*.

The next time you invoke *./manage.py help* you should be able to see all the
newly available commands.

Some command's or option's require additional applications or python libraries,
for example:

  * 'export_emails' will require the *python vobject* module to create vcard
    files.
  * 'graph_models' requires *pygraphviz* to render directly to image file.

If the given application or python library is not installed on your system (or
not in the python path) the executed command will raise an exception and inform
you of the missing dependency.

Version Control
---------------

Django-extensions is hosted on github::

 https://github.com/django-extensions/django-extensions

Source code can be accessed by performing a Git clone.

Tracking the development version of *django command extensions* should be
pretty stable and will keep you up-to-date with the latests fixes.

The following command will check the application's source code out to a
directory called *django-extensions*:

Git::

  git clone git://github.com/django-extensions/django-extensions.git

You should either install the resulting project with *python setup.py install*
or put it the *extensions* directory into your PYTHONPATH. The most common way
is to symlink (junction, if you're on Windows) the extensions directory inside
a directory which is on your PYTHONPATH, such as your Python installation's
site-packages directory.

::

  ln -sf /full/path/to/django-extensions/django_extensions /usr/lib/python2.7/site-packages/django_extensions

You can verify that the application is available on your PYTHONPATH by opening a Python interpreter and entering the following commands:

::

  >>> import django_extensions
  >>> django_extensions.VERSION
  (0, 8)

Keep in mind that the current code in the git repository may be different from the
packaged release. It may contain bugs and backwards-incompatible changes but most
likely also new goodies to play with.