Conversion of Paste Deployment configuration to Django settings

Sponsored by:2degrees Limited.
Latest release:1.0.1

Paste Deployment is a widely-used system which has the sole purpose of enabling developers and sysadmins to configure WSGI applications (like Django) and WSGI servers.

This project dynamically converts Paste Deployment configuration files to Django settings, offering a much more maintainable way to manage the configuration of your Django projects.

Features

  • Simple, Python-free configuration files. The format used is INI because configuration files should be declarative, not scripts.
  • Settings can be inherited. For example, you can define your base settings in your project’s repository, while overriding some from a separate file outside your repository.
  • Setting values are defined with JSON.
  • Variable substitution, allowing you to define a value once and reuse it in different settings.
  • Integration with Buildout, so that you can expose your Django settings to Buildout parts.
  • Integration with Nose, so that you can easily set the Django settings to be used by your test suites.
  • Compatible with Python v2.7 and v3, and Django 1.4 or later.

Example

You can keep the following file in your project’s repository:

# base.ini

[DEFAULT]
django_settings_module = your_django_project.settings

[app:main]
use = egg:django-pastedeploy-settings
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": "${sqlite_db_path}",
        }
    }

And then have two separate files, one for development and the other for production, both of which will extend base.ini:

# development.ini

[DEFAULT]
debug = true
sqlite_db_path = /dev/your-project.db

[app:main]
use = /your-project-repository/base.ini
SECRET_KEY = "weak key"
DEBUG_PROPAGATE_EXCEPTIONS = true

# production.ini

[DEFAULT]
debug = false
sqlite_db_path = /production/your-project.db

[app:main]
use = /your-project-repository/base.ini
SECRET_KEY = "str0ng k3y"

Alternatively, you can keep it all in one file:

# settings.ini

[DEFAULT]
django_settings_module = your_django_project.settings

[app:base]
use = egg:django-pastedeploy-settings
DATABASES = {
    "default": {
        "ENGINE": "django.db.backends.sqlite3",
        "NAME": "${sqlite_db_path}",
        }
    }

[app:development]
use = base
set debug = true
set sqlite_db_path = /dev/your-project.db

SECRET_KEY = "weak key"
DEBUG_PROPAGATE_EXCEPTIONS = true

[app:production]
use = base
set debug = false
set sqlite_db_path = /production/your-project.db

SECRET_KEY = "str0ng k3y"