django-git-submodules 1.1.1

Adds packages to syspath so they can be used as git submodules instead of pip packages. Should be only used in development.

=====
Django Git Submodules
=====

Django Submodules is a simple Django app that allows you
to manage apps as git submodules instead of pip.
This allows you to have a local development version of
third-party packages and merge changes from upstream.

Ideally should only be used in development.
These changes should be pushed back to the package repository
and installed with pip on production.

Quick start
-----------
1. Install django-git-submodules::

pip install django-git-submodules

2. Clone the the package you want on your project root::

git clone https://github.com/tomchristie/django-rest-framework.git

3. Import the app in your `settings.py`::

from dj_git_submodule import submodule
submodule.add('django-rest-framework')

4. Now you should be able to add the app to `INSTALLED_APPS` and have django find it successfully.

5. If you need to import multiple apps, you can use wildcards(through glob)::

from dj_git_submodule import submodule
submodule.add(submodule.locate('custom-apps-*'))