Source

django-environments / README

django-environments
===================

Manage different settings for different locations (machines), or
Fabric's 'roles', like local (your machine), development (shared
development system), test, staging/acceptance and production.

Compatibility with virtualenv
==============================

Please note django-environments can be nicely used together with
virtualenv, especially virtualenvwrapper's ``bin/postactivate`` script.

Getting Started
===============

This is a fully working Django project. You can copy files from it
as needed to your own projects.

 1. Copy scripts/initenv_example to scripts/initenv.
 2. Edit initenv and set ``PROJECT_ROOT``, ``DJANGO_PROJECT`` (always a
    subdirectory of ``PROJECT_ROOT``) and ``PROJECT_SETTINGS``.
 3. Activate the environment using ``source scripts/initenv``.
 4. When using virtualenv with virtualenvwrapper, you can do 
    ``source <path-to-project>/scripts/initenv`` from ``bin/postactivate``.

If everything works okay, the following shell aliases are created:

 * cdroot - go to project root.
 * cdjango - go to Django project root (one lower than project root).
 * runserver - perform manage.py runserver with the correct settings.

Using Apache mod_wsgi
=====================

Copy the mysite/deploy/example.wsgi to mysite/deploy/local.wsgi,
and add something like this to your httpd.conf::

    WSGIPythonHome /Users/.virtualenvs/django-environments # Optional
    WSGIScriptAlias / /Users/foobar/repos/django-environments/mysite/deploy/local.wsgi

The 'local' in local.wsgi will automatically make sure settings.env.local
is used. Create other .wsgi files for other environment settings.

Directories
===========

 * The ``mysite/settings`` directory replaces ``settings.py`` and contains
   the default settings in ``generic.py``, which is imported in ``__init__.py``.
 * The ``mysite/settings/env`` directory contains the different settings
   files for every environment.
 * All .wsgi files in the ``mysite/deploy`` folder are equal; their
   respective filenames are used to determine which settings to import.
 * As discussed above, the scripts directory contains the shell
   scripts intended to be sourced with the ``source`` command.

Remarks
=======

 * ``urls.py`` is just there to demonstrate the ``SERVE_MEDIA`` setting.
 * ``manage.py`` is just there to make this a complete Django project.