A consistent, user-friendly solution for adding app-specific settings your Django package, reusable app or framework.
Project description
About Django Cogwheels
A handy API to allow you to more easily offer and maintain ‘user overridable settings’ in your Django package, framework or reuseable app.
Give your users the flexibility they deserve, and allow them to:
Override basic python type values such as: strings, integers, booleans, decimals and floats.
Override structured python type values such as: lists, tuples and dictionaries.
Use custom Django models in place of the ones you provide.
Use custom python classes, objects or entire modules in place of you provide.
Goodness for you and other maintainers
Cogwheels provides you with:
A stable, documented, well tested, standardised approach for implementing overridable settings.
A way to clearly define and communicate the deprecation status of overridable settings, giving you the flexibility to rename, replace or flag settings for removal over your project’s lifecycle. User overrides defined using old setting names remain available to you, allowing you to continue support them during the deprecation period.
Helpful error messages when default values provided for Model, Class, method or modules are invalid.
Goodness for your users
Cogwheels gives them:
Helpful, consistent error messages when their Model, Class, method or module override settings are incorrectly formatted, or cannot be imported.
Helpful, consistent deprecation warnings when they are overriding a setting that has been renamed, replaced or flagged for removal.
Installation instructions
Documentation coming soon.
Usage Guide
Documentation coming soon.
Compatibility
The current version is tested for compatiblily with the following:
Django versions 1.11 to 2.0
Python versions 3.4 to 3.6
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for django_cogwheels-0.0.1a1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | f468ff9c5ad59103f2ebdb21f31018ac76466897555915b755fd4a4fb4c97efd |
|
MD5 | eccbb18612c318dca0a0617a6b362d85 |
|
BLAKE2b-256 | 006b892eb054bf06a42541c6e19caa985011e2b2b25d22e433f7cf8f5da6a260 |