Project description

This is yet another approach on enabling Django to load reusable, pluggable,
egg-based applications without changing the Django sourcecode. Think of
plugins or components, e.g. django-registration, django-threadedcomments or
django-tagging.

You can then put reusable, pluggable, egg-based Django apps in one of the
directories in REUSABLE_APPS_DIRS.

Using templates from egg-based Django apps

If you want to use templates from a egg-based Django app please add
'django.template.loaders.eggs.load_template_source' to the TEMPLATE_LOADERS
setting.

Adding support for django-reusableapps to your own Django app

If you want to support django-reusableapps in your own Django app, you need
to modify your existing setup.py to import the setup function from the
setuptools instead the from the distutils:

from setuptools import setup

Furthermore you need to add an ‘entry point’ to the setup keywords:

entry_points={'django.apps': 'myapp = myapp'},

where my myapp is the name of your Django app, e.g. registration.
A full example can be found at setup-example.py and should be copied to
the parent directory of your app as setup.py. You are then able to create
an egg file with of this app.

Creating egg files of reuasable Django apps

Once you have a proper setup.py in the parent directory of your Django app,
you can run:

python setup.py bdist_egg

to build a egg file of it. It will be created in the dist directory and
have a filename like dummyapp-0.1-py2.5.egg. You can then distribute it
and use it by placing it in one of the REUSABLE_APPS_DIRS of your Django
project.