.. image:: https://secure.travis-ci.org/RichardOfWard/django-loading.png
:alt: Build Status
Django-loading allows you to load your django apps by their app name rather
than by the module path. This is particularly useful if you don't know where
modules will be installed or if you plan to allow overriding of your apps (eg
a user replaces your ``foo.bar`` app with ``myfoo.bar``).
If you have a django app called ``bar`` in a package called ``foo`` (such that
you would add ``foo.bar`` to your INSTALLED_APPS) then you can get hold of
``bar`` without knowing its full module path::
Django-loading hooks into python's regular import mechanism so all the normal
ways to import things will work::
from loading.apps.bar import models
from loading.apps.bar.models import MyModel as ThisIsMyModel
Your app names in a django project should all be unqiue, django-loading won't
work if they are not (but django won't like that either).
Use your favorite install method, for example:
$ pip install django-loading
You do not need to add django-loading to your INSTALLED_APPS, just start using
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.