=============================
django-dynamic-preferences
=============================
.. image:: https://badge.fury.io/py/django-dynamic-preferences.png
:target: https://badge.fury.io/py/django-dynamic-preferences
.. image:: https://readthedocs.org/projects/django-dynamic-preferences/badge/?version=latest
:target: http://django-dynamic-preferences.readthedocs.org/en/latest/
.. image:: https://github.com/agateblue/django-dynamic-preferences/actions/workflows/tests.yml/badge.svg
:target: https://github.com/agateblue/django-dynamic-preferences/actions/workflows/tests.yml
.. image:: https://opencollective.com/django-dynamic-preferences/backers/badge.svg
:alt: Backers on Open Collective
:target: #backers
.. image:: https://opencollective.com/django-dynamic-preferences/sponsors/badge.svg
:alt: Sponsors on Open Collective
:target: #sponsors
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 3.7, 3.8, 3.9, 3.10 and 3.11 and with django 3.2 and 4.2.
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.
Changelog
---------
See https://django-dynamic-preferences.readthedocs.io/en/latest/history.html
Contributing
------------
See https://django-dynamic-preferences.readthedocs.org/en/latest/contributing.html
Credits
+++++++
Contributors
------------
This project exists thanks to all the people who contribute!
.. image:: https://opencollective.com/django-dynamic-preferences/contributors.svg?width=890&button=false
Backers
-------
Thank you to all our backers! `Become a backer`__.
.. image:: https://opencollective.com/django-dynamic-preferences/backers.svg?width=890
:target: https://opencollective.com/django-dynamic-preferences#backers
__ Backer_
.. _Backer: https://opencollective.com/django-dynamic-preferences#backer
Sponsors
--------
Support us by becoming a sponsor. Your logo will show up here with a link to your website. `Become a sponsor`__.
.. image:: https://opencollective.com/django-dynamic-preferences/sponsor/0/avatar.svg
:target: https://opencollective.com/django-dynamic-preferences/sponsor/0/website
__ Sponsor_
.. _Sponsor: https://opencollective.com/django-dynamic-preferences#sponsor
Raw data
{
"_id": null,
"home_page": "https://github.com/agateblue/django-dynamic-preferences",
"name": "django-dynamic-preferences",
"maintainer": "",
"docs_url": null,
"requires_python": "",
"maintainer_email": "",
"keywords": "django-dynamic-preferences",
"author": "Agate Blue",
"author_email": "me+github@agate.blue",
"download_url": "https://files.pythonhosted.org/packages/26/a9/bbb1f24e88b8d670003539bd651e96b12020493f4017c7731813d5573050/django-dynamic-preferences-1.16.0.tar.gz",
"platform": null,
"description": "=============================\ndjango-dynamic-preferences\n=============================\n\n.. image:: https://badge.fury.io/py/django-dynamic-preferences.png\n :target: https://badge.fury.io/py/django-dynamic-preferences\n\n.. image:: https://readthedocs.org/projects/django-dynamic-preferences/badge/?version=latest\n :target: http://django-dynamic-preferences.readthedocs.org/en/latest/\n\n.. image:: https://github.com/agateblue/django-dynamic-preferences/actions/workflows/tests.yml/badge.svg\n :target: https://github.com/agateblue/django-dynamic-preferences/actions/workflows/tests.yml\n\n.. image:: https://opencollective.com/django-dynamic-preferences/backers/badge.svg\n :alt: Backers on Open Collective\n :target: #backers\n\n.. image:: https://opencollective.com/django-dynamic-preferences/sponsors/badge.svg\n :alt: Sponsors on Open Collective\n :target: #sponsors\n\nDynamic-preferences is a Django app, BSD-licensed, designed to help you manage your project settings. While most of the time,\na ``settings.py`` file is sufficient, there are some situations where you need something more flexible such as:\n\n* per-user settings (or, generally speaking, per instance settings)\n* settings change without server restart\n\nFor 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.\n\nDynamic-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.\n\nWith dynamic-preferences, you can update settings on the fly, through django's admin or custom forms, without restarting your application.\n\nThe project is tested and work under Python 3.7, 3.8, 3.9, 3.10 and 3.11 and with django 3.2 and 4.2.\n\nFeatures\n--------\n\n* Simple to setup\n* Admin integration\n* Forms integration\n* Bundled with global and per-user preferences\n* Can be extended to other models if need (e.g. per-site preferences)\n* Integrates with django caching mechanisms to improve performance\n\nDocumentation\n-------------\n\nThe full documentation is at https://django-dynamic-preferences.readthedocs.org.\n\nChangelog\n---------\n\nSee https://django-dynamic-preferences.readthedocs.io/en/latest/history.html\n\nContributing\n------------\n\nSee https://django-dynamic-preferences.readthedocs.org/en/latest/contributing.html\n\nCredits\n\n+++++++\n\nContributors\n\n------------\n\nThis project exists thanks to all the people who contribute!\n\n.. image:: https://opencollective.com/django-dynamic-preferences/contributors.svg?width=890&button=false\n\nBackers\n\n-------\n\nThank you to all our backers! `Become a backer`__.\n\n.. image:: https://opencollective.com/django-dynamic-preferences/backers.svg?width=890\n :target: https://opencollective.com/django-dynamic-preferences#backers\n\n__ Backer_\n.. _Backer: https://opencollective.com/django-dynamic-preferences#backer\n\nSponsors\n\n--------\n\nSupport us by becoming a sponsor. Your logo will show up here with a link to your website. `Become a sponsor`__.\n\n.. image:: https://opencollective.com/django-dynamic-preferences/sponsor/0/avatar.svg\n :target: https://opencollective.com/django-dynamic-preferences/sponsor/0/website\n\n__ Sponsor_\n.. _Sponsor: https://opencollective.com/django-dynamic-preferences#sponsor\n\n\n",
"bugtrack_url": null,
"license": "BSD",
"summary": "Dynamic global and instance settings for your django project",
"version": "1.16.0",
"project_urls": {
"Homepage": "https://github.com/agateblue/django-dynamic-preferences"
},
"split_keywords": [
"django-dynamic-preferences"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "e31c1c42f3007ecdb3910ae640c10aa8c83c52602e6ed983fea212be2901c169",
"md5": "275f0c0d5d98bbae3930d0eecfb1b1cc",
"sha256": "527b943d2b5a5c1ea2de8f941778a39efddf2b18ccf44e6aaab05290256ec82f"
},
"downloads": -1,
"filename": "django_dynamic_preferences-1.16.0-py2.py3-none-any.whl",
"has_sig": false,
"md5_digest": "275f0c0d5d98bbae3930d0eecfb1b1cc",
"packagetype": "bdist_wheel",
"python_version": "py2.py3",
"requires_python": null,
"size": 50688,
"upload_time": "2023-10-15T09:06:09",
"upload_time_iso_8601": "2023-10-15T09:06:09.889580Z",
"url": "https://files.pythonhosted.org/packages/e3/1c/1c42f3007ecdb3910ae640c10aa8c83c52602e6ed983fea212be2901c169/django_dynamic_preferences-1.16.0-py2.py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "26a9bbb1f24e88b8d670003539bd651e96b12020493f4017c7731813d5573050",
"md5": "5009b674adee66f81de97724d1a80ae3",
"sha256": "0d3d456626244d0bdaf312c81f2b3e14bd16134e8fcf53a33fd12e5d0bdd88dd"
},
"downloads": -1,
"filename": "django-dynamic-preferences-1.16.0.tar.gz",
"has_sig": false,
"md5_digest": "5009b674adee66f81de97724d1a80ae3",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 50447,
"upload_time": "2023-10-15T09:06:12",
"upload_time_iso_8601": "2023-10-15T09:06:12.047135Z",
"url": "https://files.pythonhosted.org/packages/26/a9/bbb1f24e88b8d670003539bd651e96b12020493f4017c7731813d5573050/django-dynamic-preferences-1.16.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-10-15 09:06:12",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "agateblue",
"github_project": "django-dynamic-preferences",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"tox": true,
"lcname": "django-dynamic-preferences"
}
JSON
