Debian Codegraph @

PKG-INFO

raw
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