dj_settings: project settings the UNIX way

Test License PyPI Downloads Code style

dj_settings offers way to add project settings in a way that has been battle-tested for years in numerous UNIX apps, reading from the value /etc/<conf_path> or ~/.config/<conf_path> or <proj_path>/<conf_path> or an ENV VAR, allowing overriding from the next read location. It’s mainly targeting django, but it can be used as a general settings parser

In a nutshell

Installation

The easiest way is to use poetry to manage your dependencies and add dj_settings to them.

[tool.poetry.dependencies]
dj_settings = "^4.2.1"

Usage

dj_settings will read from various config files to get the value of a variable, in a way that’s very familiar to all UNIX users. It allows setting default values, and overriding with ENV VARs and .d directories.