Skip to main content

Dynamic global and instance settings for your django project

Project description

https://badge.fury.io/py/django-dynamic-preferences.png https://readthedocs.org/projects/django-dynamic-preferences/badge/?version=latest https://travis-ci.org/EliotBerriot/django-dynamic-preferences.svg?branch=master https://travis-ci.org/EliotBerriot/django-dynamic-preferences.svg?branch=develop https://img.shields.io/codecov/c/github/EliotBerriot/django-dynamic-preferences/master.svg Backers on Open Collective Sponsors on Open Collective

Warning

There is a critical bug in version 1.2 that can result in dataloss. Please upgrade to 1.3 as soon as possible and do not use 1.2 in production. See #81 for more details.

Dynamic-preferences is a Django app, BSD-licensed, designed to help you manage your project settings. While most of the time, a settings.py file is sufficient, there are some situations where you need something more flexible such as:

  • per-user settings (or, generally speaking, per instance settings)
  • settings change without server restart

For per-instance settings, you could actually store them in some kind of profile model. However, it means that every time you want to add a new setting, you need to add a new column to the profile DB table. Not very efficient.

Dynamic-preferences allow you to register settings (a.k.a. preferences) in a declarative way. Preferences values are serialized before storage in database, and automatically deserialized when you need them.

With dynamic-preferences, you can update settings on the fly, through django’s admin or custom forms, without restarting your application.

The project is tested and work under Python 2.7 and 3.4, 3.5 and 3.6, with django >=1.8.

Features

  • Simple to setup
  • Admin integration
  • Forms integration
  • Bundled with global and per-user preferences
  • Can be extended to other models if need (e.g. per-site preferences)
  • Integrates with django caching mechanisms to improve performance

Documentation

The full documentation is at https://django-dynamic-preferences.readthedocs.org.

Contributing

See https://django-dynamic-preferences.readthedocs.org/en/latest/contributing.html

Credits


Contributors


This project exists thanks to all the people who contribute!

https://opencollective.com/django-dynamic-preferences/contributors.svg?width=890&button=false

Backers


Thank you to all our backers! Become a backer.

https://opencollective.com/django-dynamic-preferences/backers.svg?width=890

Sponsors


Support us by becoming a sponsor. Your logo will show up here with a link to your website. Become a sponsor.

https://opencollective.com/django-dynamic-preferences/sponsor/0/avatar.svg

Project details


Download files

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

Files for django-dynamic-preferences, version 1.8
Filename, size File type Python version Upload date Hashes
Filename, size django_dynamic_preferences-1.8-py2.py3-none-any.whl (44.9 kB) File type Wheel Python version py2.py3 Upload date Hashes View hashes
Filename, size django-dynamic-preferences-1.8.tar.gz (34.9 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

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