Dynamic Django settings.
Find a file
2010-08-25 13:32:42 +02:00
constance Added basic tests 2010-08-25 13:32:42 +02:00
.hgignore hg ignore 2010-08-23 16:20:13 +02:00
AUTHORS added README 2010-08-25 10:30:58 +02:00
MANIFEST.in fixed packaging: templates included 2010-08-24 11:48:23 +02:00
README.rst updated README 2010-08-25 11:24:40 +02:00
setup.py version bump 2010-08-24 11:49:21 +02:00

Dynamic Django settings in Redis.

Features
========

* Easy migrate your static settings to dynamic settings.
* Admin interface to edit the dynamic settings.

Installation
============

Install from here using ``pip``::

    pip install -e hg+http://bitbucket.org/comoga/django-constance#egg=django-constance

Configuration
=============

Modify your ``settings.py``. Add ``constance`` to your ``INSTALLED_APPS``,
point ``CONSTANCE_CONNECTION`` to your Redis instance, and move each
key you want to turn dynamic into the ``CONSTANCE_CONFIG`` section, like this::


    INSTALLED_APPS = (
        ...
        'constance',
    )

    CONSTANCE_CONNECTION = {
        'host': 'localhost',
        'port': 6379,
        'db': 0,
    }


    CONSTANCE_CONFIG = {
        'MY_SETTINGS_KEY': (42, 'the answer to everything'),
    }

Usage
=====

::

    from constance import config

    ...

    if config.MY_SETTINGS_KEY == 42:
        answer_the_question()


Fire up your ``admin`` and you should see a new application ``Constance``
with ``MY_SETTINGS_KEY`` in the ``Config`` pseudo model.