Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (pypi.python.org).
Help us improve Python packaging - Donate today!

A firefox-like about:config implementation for one-off settings in Django apps.

Project Description

A firefox-like about:config implementation for one-off settings in Django apps.

Compatible Python versions

2.7, 3.3+

Compatible Django versions

1.8 - 1.11

Installation

You can install aboutconfig either from source or via pip:

pip install django-aboutconfig

The only thing you need to do to configure it is add it to your INSTALLED_APPS like all other django applications:

INSTALLED_APPS = [
    'django.contrib.admin',
    'django.contrib.auth',
    ...
    'aboutconfig'
]

Then just run manage.py migrate and you’re good to go.

Note: aboutconfig relies on having a good caching mechanism to be fast (all configured values are preloaded into cache on start-up). You should ideally have something like memcached configured to avoid slowdowns. See Django documentation for details.

Usage

By default, aboutconfig comes with four supported data-types: integer, boolean, string and decimal. All data types are configurable and you can add your own if necesessary.

To add some configuration values, head over to the django admin and add an instance of the Config model.

Having done this, you can access the configuration value via aboutconfig.get_config() in Python code or the get_config template filter (load config before using).

Python code:

from aboutconfig import get_config

def my_view(request):
    # some code...
    admin_email = get_config('admin.details.email')
    # some more code...

Template code:

{% load config %}

The website admin's email is {{ 'admin.details.email'|get_config }}.

>>> An assignment tag also exists for convenience:

{% get_config 'admin.details.email' as email %}
The website admin's email is <a href="mailto:{{ email }}">{{ email }}</a>.
Release History

Release History

This version
History Node

0.5.3

History Node

0.5.2

History Node

0.5.1

History Node

0.5.0

History Node

0.4.3

History Node

0.4.2

History Node

0.4.1

History Node

0.4.0

History Node

0.3.0

History Node

0.2.0

History Node

0.1.0

History Node

0.0.1

Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
django_aboutconfig-0.5.3-py2.py3-none-any.whl (18.5 kB) Copy SHA256 Checksum SHA256 py2.py3 Wheel Apr 14, 2017
django-aboutconfig-0.5.3.tar.gz (24.8 kB) Copy SHA256 Checksum SHA256 Source Apr 14, 2017

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting