Configuration made easy: JSON, encrypted, envvars, etc.
Configuration doesn’t get any easier than this …
pip install jsonconfig-tool
What’s it Used For?
- Managing settings, configuration information, application data, etc.
- Managing secrets, tokens, keys, passwords, etc.
- Managing environment settings.
with Config('myapp') as cfg: cfg.data = 'Any JSON serializable object ...' cfg.pwd.a_secret = 'Encrypted data ...' cfg.env.a_variable = 'Environment variables.'
No magic here …
In the context manager above:
- The data is stored in the user’s local application directory.
- The pwd data is encrypted and stored in a keyring vault.
- The env data is stored in environment variables.
Configuration File Locations
The default behavior is to return whatever is most appropriate for the operating system. To give you an idea, an app called Foo Bar would likely return the following:
Mac OS X: ~/Library/Application Support/Foo Bar Mac OS X (POSIX): ~/.foo-bar Unix: ~/.config/foo-bar Unix (POSIX): ~/.foo-bar Win XP (roaming): C:\Documents and Settings\<user>\Local Settings\Application Data\Foo Bar Win XP (not roaming): C:\Documents and Settings\<user>\Application Data\Foo Bar Win 7+ (roaming): C:\Users\<user>\AppData\Roaming\Foo Bar Win 7+ (not roaming): C:\Users\<user>\AppData\Local\Foo Bar
Of course, you or the user are free to override this behavior and set the location to wherever you want.
The default behavior is to select the most secure backend supported by the user’s platform. To give you an idea, the following Keyring backends would likely be returned:
- Mac OS X:
- Keychain 
- Unix (with secretstorage installed):
- Secret Service 
- Unix (with dbus installed):
- kwallet 
- Windows Credential Locker 
Of course, you or the user are free to override the defaults. The user can also change their Keyring backend preferences system-wide from the command-line or via configuration files. JSON Config will then use the user’s preferred Keyring backend unless told otherwise.
How Do You Want Your Data Served?
- No wrapping. Organic, free-ranging data. If it’s JSON serializable we’ll work with it. This is the default.
- Delivers your data in a Box ; a Python dictionary that supports both recursive dot notation access and standard dictionary key access. If you have a fear of being boxed-in, don’t panic! You can get in and out of the box at anytime, see the data conversion section below.
- Ices the data in a Frozen Box, same as BOXED except immutable; will also be hashable if all objects in it are immutable.
- Nests the data in a default dictionary that can automatically create missing intermediary keys. It’s also very forgiving when retrieving data from the dictionary; for example, it won’t throw an error if a key doesn’t exist. Instead, it’ll return None; even if the key’s nested and multiple keys are missing.
- BOXED, FROZEN and NESTED are all subclasses of dicts or defaultdicts. You can convert back-and-forth between any of them at any time.
- The objects listed above are Mappings, if your data object is not a Mapping then use PLAIN to free yourself of all of the trappings. With PLAIN it’s just you and your buddy Python; we get out of the way.
JSON Config Frees You to Do What You Do Best
Spend more time solving real-world problems, less time coding, testing & troubleshooting configuration issues.
|||(1, 2) http://github.com/cdgriffith/Box|
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
|Filename, size & hash SHA256 hash help||File type||Python version||Upload date|
|jsonconfig_tool-1.2-py2.py3-none-any.whl (8.4 kB) Copy SHA256 hash SHA256||Wheel||3.6||Feb 14, 2018|
|jsonconfig-tool-1.2.tar.gz (12.1 kB) Copy SHA256 hash SHA256||Source||None||Feb 14, 2018|