Read config from environment for 12 factor apps
Project description
Python module for reading config from environment for 12-factor apps. Supports Python 3.4+
Rationale
In a 12-factor app, config comes from the environment. For example, on Heroku, config variables are set using heroku config:set on the command line, then passed to the application in the environment.
Reading and parsing config from the environment is tedious and error-prone. For example, a Django app has settings.DEBUG which should be either True or False. The operator runs heroku config:set DJANGO_DEBUG off intending to disable it, but the application only sees a non-empty string and treats the value as True.
This sort of problem can be handled case-by-case but doesn’t need to be. Clearly a configuration setting with a fallback boolean value should be interpreted as boolean from the environment. Likewise a fallback integer setting indicates the associated environment variable should be converted from string to int.
Sounds like a job for a small and well-tested Python module, right?
Usage
Bienvenue provides the function make_env_reader which returns a new function for accessing the environment. For example:
from bienvenue import make_env_reader env = make_env_reader(prefix='MY_') DEBUG = env('DEBUG', False) SECRET_KEY = env('SECRET_KEY', 'fallback-secret-for-dev') ALLOWED_HOSTS = env('ALLOWED_HOSTS', [])
The env reader looks for MY_DEBUG in os.environ. If it’s not there, the default value False will be returned. However if it’s found, then the value there will be interpreted according to the type of the default, in this case boolean. Common strings such as on/off, true/false and yes/no are interpreted into True or False.
Likewise SECRET_KEY will be extracted from MY_SECRET_KEY and then interpreted as a string value.
ALLOWED_HOSTS will be extracted from MY_ALLOWED_HOSTS and JSON decoded as a list, since the default value is a list.
If bienvenue encounters unknown types or values during parsing, it will log an error and fall back to the provided default.
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Filename, size | File type | Python version | Upload date | Hashes |
---|---|---|---|---|
Filename, size bienvenue-3.0.1-py3-none-any.whl (7.9 kB) | File type Wheel | Python version py3 | Upload date | Hashes View |
Filename, size bienvenue-3.0.1.tar.gz (4.9 kB) | File type Source | Python version None | Upload date | Hashes View |
Hashes for bienvenue-3.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e1b2232d64016414e67203855a805d30e7db969d3d72b7eb4f6b320174c14b2e |
|
MD5 | c5c890ab14329e1287316a009d5e4024 |
|
BLAKE2-256 | b40cf9164f6430f6b12437205c02679bf065bdb069e0d64480ed452216c41e53 |