Easy to manage Config variables separate from App code. Useful while developing and deploying( CI/CD) django web-apps
Project description
dynamic-config
Project configuration variables are declared beforehand and inferred from environment variables or configuration files. Useful while developing and deploying( CI/CD) django web-apps
Install
pip install dynamic-conf
Features
- supports
.env
or.py
files - supports casting with type annotations
- You also don't need to include a sample file. Since the
Config
object would be able to generate.env.py
itself. - It also loads Configuration variables from environment variables.
The order of preference is
env variables
>env.py
- Attributes are lazily evaluated.
Getting Started
- You need to subclass the
Config
class. - The config file should define all the variables needed for a project.
# project/conf.py from dynamic_conf import Config, REQUIRED class CONFIG(Config): """singleton to be used for configuring from os.environ and env.py""" # default settings ENV = "prod" # optional field with a default value DB_NAME = "db" DB_HOST = "127.0.0.1" DB_USER = "postgres" DB_PASS = None # even None could be given as default value SECRET_KEY:str # Python 3 only AN_SECRET_KEY = REQUIRED # Python 2 & 3
- to create
project/env.py
just run with the path to CONFIG class's module
# you could pass environment variables or set already with export env DB_PASS='123' dynamic-conf project/conf.py dynamic-conf project/conf.py DB_USER='user-1' DB_PASS='123' # pass as list of key-value pair #to filter environment variables with a prefix env VARS_PREFIX="PROD_" dynamic-conf project/conf.py PROD_DB_USER="user-2"
Usage
- To use the config simply import and use particular attribute
# project/settings.py from conf import CONFIG DATABASES = { "default": { "ENGINE": "django.contrib.gis.db.backends.postgis", "HOST": CONFIG.DB_HOST, "NAME": CONFIG.DB_NAME, "USER": CONFIG.DB_USER, "PASSWORD": CONFIG.DB_PASSWORD, "PORT": "5432", } }
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
dynamic-conf-1.0.1.tar.gz
(6.8 kB
view hashes)
Built Distribution
Close
Hashes for dynamic_conf-1.0.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 07faf442c0b4552032df9e1bc809b84cae533f7dc6290866f17028f4d2fdb1af |
|
MD5 | 464732fa969caa4f9bd22855e45fc463 |
|
BLAKE2-256 | 7db249707ff4a2d6ec0241886da0d208dc83e89440db1966a0b71fb20bc43aa0 |