Skip to main content

App Settings for Django 1.7

Project description

https://travis-ci.org/OohlaLabs/django-pods.svg?branch=master https://coveralls.io/repos/OohlaLabs/django-pods/badge.png?branch=master

Django Pods is a minimalist package that lets you configure app specific settings that can be overridden in project settings.

This package is largely inspired by Django Rest Framework and Django AllAuth and adapted to work with Django 1.7 Applications, but also with any classes extending pods.apps.AppSettings.

Installation

pip install django-pods

Django 1.7 Usage

In rock_n_roll/apps.py:

from django.apps import AppConfig
from pods.apps import AppSettings


class RockNRollConfig(AppSettings, AppConfig):
    name = 'rock_n_roll'
    verbose_name = "Rock ’n’ roll"

    # Path to app settings module
    settings_module = "rock_n_roll.app_settings"

    # Optional
    settings_imports = ("CLASS_TO_IMPORT",)

    # Optional
    # defaults to the capitalized class name, e.g. ROCK_N_ROLL_CONFIG
    settings_key = "ROCK_N_ROLL"

In rock_n_roll/app_settings.py:

QUESTION = "What is your favourite band?"
ANSWER = "The Rolling Stones"
CLASS_TO_IMPORT = "path.to.ClassToImport"

In project/settings.py:

ROCK_N_ROLL = {
    "ANSWER": "The Beatles",
}

Anywhere else in your project:

from django.apps import apps

app = apps.get_app_config('rock_n_roll')

app.settings.QUESTION
# What is your favourite band?

app.settings.ANSWER
# The Beatles

app.settings.CLASS_TO_IMPORT
# <class 'path.to.ClassToImport'>

AppSettings also implements __getattr__ to proxy to settings attributes:

app.ANSWER
# The Beatles

Django < 1.7 Usage

There isn’t a logical place to create a class representing an app in Django prior to 1.7, but any class can extend AppSettings:

from pods.apps import AppSettings


class AnyClass(AppSettings):
    settings_module = "path.to.settings"


AnyClass.settings

# or

a = AnyClass()
a.settings

Running Tests

tox

Contributions

All contributions and comments are welcome.

Change Log

v0.3

  • Unit tests now use Django 1.7 final and support Django 1.6 and 1.5
  • Fix PyPI classifiers for supported python versions

v0.2

  • Fix compatibility with Django 1.6

v0.1

  • Initial

Project details


Release history Release notifications

History Node

1.1.4

History Node

1.1.3.dev0

History Node

1.1.2

History Node

1.1.1

History Node

1.1

History Node

1.0

History Node

0.4

This version
History Node

0.3

History Node

0.2

History Node

0.1

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
django_pods-0.3-py2.py3-none-any.whl (7.9 kB) Copy SHA256 hash SHA256 Wheel 2.7 Sep 3, 2014
django-pods-0.3.tar.gz (6.2 kB) Copy SHA256 hash SHA256 Source None Sep 3, 2014

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page