| 1 |
Metadata-Version: 2.2 |
| 2 |
Name: django-dynamic-preferences |
| 3 |
Version: 1.17.0 |
| 4 |
Summary: Dynamic global and instance settings for your django project |
| 5 |
Home-page: https://github.com/agateblue/django-dynamic-preferences |
| 6 |
Author: Agate Blue |
| 7 |
Author-email: [email protected] |
| 8 |
License: BSD |
| 9 |
Keywords: django-dynamic-preferences |
| 10 |
Classifier: Development Status :: 5 - Production/Stable |
| 11 |
Classifier: Framework :: Django |
| 12 |
Classifier: Intended Audience :: Developers |
| 13 |
Classifier: License :: OSI Approved :: BSD License |
| 14 |
Classifier: Natural Language :: English |
| 15 |
Classifier: Programming Language :: Python :: 3 |
| 16 |
License-File: LICENSE |
| 17 |
License-File: AUTHORS.rst |
| 18 |
Requires-Dist: django>=4.2 |
| 19 |
Requires-Dist: persisting_theory==1.0 |
| 20 |
Dynamic: author |
| 21 |
Dynamic: author-email |
| 22 |
Dynamic: classifier |
| 23 |
Dynamic: description |
| 24 |
Dynamic: home-page |
| 25 |
Dynamic: keywords |
| 26 |
Dynamic: license |
| 27 |
Dynamic: requires-dist |
| 28 |
Dynamic: summary |
| 29 |
|
| 30 |
============================= |
| 31 |
django-dynamic-preferences |
| 32 |
============================= |
| 33 |
|
| 34 |
.. image:: https://badge.fury.io/py/django-dynamic-preferences.png |
| 35 |
:target: https://badge.fury.io/py/django-dynamic-preferences |
| 36 |
|
| 37 |
.. image:: https://readthedocs.org/projects/django-dynamic-preferences/badge/?version=latest |
| 38 |
:target: http://django-dynamic-preferences.readthedocs.org/en/latest/ |
| 39 |
|
| 40 |
.. image:: https://github.com/agateblue/django-dynamic-preferences/actions/workflows/tests.yml/badge.svg |
| 41 |
:target: https://github.com/agateblue/django-dynamic-preferences/actions/workflows/tests.yml |
| 42 |
|
| 43 |
.. image:: https://opencollective.com/django-dynamic-preferences/backers/badge.svg |
| 44 |
:alt: Backers on Open Collective |
| 45 |
:target: #backers |
| 46 |
|
| 47 |
.. image:: https://opencollective.com/django-dynamic-preferences/sponsors/badge.svg |
| 48 |
:alt: Sponsors on Open Collective |
| 49 |
:target: #sponsors |
| 50 |
|
| 51 |
Dynamic-preferences is a Django app, BSD-licensed, designed to help you manage your project settings. While most of the time, |
| 52 |
a ``settings.py`` file is sufficient, there are some situations where you need something more flexible such as: |
| 53 |
|
| 54 |
* per-user settings (or, generally speaking, per instance settings) |
| 55 |
* settings change without server restart |
| 56 |
|
| 57 |
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. |
| 58 |
|
| 59 |
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. |
| 60 |
|
| 61 |
With dynamic-preferences, you can update settings on the fly, through django's admin or custom forms, without restarting your application. |
| 62 |
|
| 63 |
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. |
| 64 |
|
| 65 |
Features |
| 66 |
-------- |
| 67 |
|
| 68 |
* Simple to setup |
| 69 |
* Admin integration |
| 70 |
* Forms integration |
| 71 |
* Bundled with global and per-user preferences |
| 72 |
* Can be extended to other models if need (e.g. per-site preferences) |
| 73 |
* Integrates with django caching mechanisms to improve performance |
| 74 |
|
| 75 |
Documentation |
| 76 |
------------- |
| 77 |
|
| 78 |
The full documentation is at https://django-dynamic-preferences.readthedocs.org. |
| 79 |
|
| 80 |
Changelog |
| 81 |
--------- |
| 82 |
|
| 83 |
See https://django-dynamic-preferences.readthedocs.io/en/latest/history.html |
| 84 |
|
| 85 |
Contributing |
| 86 |
------------ |
| 87 |
|
| 88 |
See https://django-dynamic-preferences.readthedocs.org/en/latest/contributing.html |
| 89 |
|
| 90 |
Credits |
| 91 |
|
| 92 |
+++++++ |
| 93 |
|
| 94 |
Contributors |
| 95 |
|
| 96 |
------------ |
| 97 |
|
| 98 |
This project exists thanks to all the people who contribute! |
| 99 |
|
| 100 |
.. image:: https://opencollective.com/django-dynamic-preferences/contributors.svg?width=890&button=false |
| 101 |
|
| 102 |
Backers |
| 103 |
|
| 104 |
------- |
| 105 |
|
| 106 |
Thank you to all our backers! `Become a backer`__. |
| 107 |
|
| 108 |
.. image:: https://opencollective.com/django-dynamic-preferences/backers.svg?width=890 |
| 109 |
:target: https://opencollective.com/django-dynamic-preferences#backers |
| 110 |
|
| 111 |
__ Backer_ |
| 112 |
.. _Backer: https://opencollective.com/django-dynamic-preferences#backer |
| 113 |
|
| 114 |
Sponsors |
| 115 |
|
| 116 |
-------- |
| 117 |
|
| 118 |
Support us by becoming a sponsor. Your logo will show up here with a link to your website. `Become a sponsor`__. |
| 119 |
|
| 120 |
.. image:: https://opencollective.com/django-dynamic-preferences/sponsor/0/avatar.svg |
| 121 |
:target: https://opencollective.com/django-dynamic-preferences/sponsor/0/website |
| 122 |
|
| 123 |
__ Sponsor_ |
| 124 |
.. _Sponsor: https://opencollective.com/django-dynamic-preferences#sponsor |