100 lines
2.8 KiB
ReStructuredText
100 lines
2.8 KiB
ReStructuredText
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.
|
|
|