# dj_settings: project settings the UNIX way
[![tests][test_badge]][test_url]
[![license][licence_badge]][licence_url]
[![pypi][pypi_badge]][pypi_url]
[![downloads][pepy_badge]][pepy_url]
[![code style: black][black_badge]][black_url]
[![build automation: yam][yam_badge]][yam_url]
[![Lint: ruff][ruff_badge]][ruff_url]
`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/<config_file>` or `~/.config/<config_file>` or
`/path/to/project/<config_file>` or an `ENV VAR`, allowing overriding from the next read location.
All of them allow overriding `/path/to/config/file.ext` with `/path/to/config/file.ext.d/<filename>.ext`.
It started by targeting django, but it has grown to be used as a general settings or config parser.
### 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.
## Links
- [Documentation]
- [Changelog]
[test_badge]: https://github.com/spapanik/dj_settings/actions/workflows/tests.yml/badge.svg
[test_url]: https://github.com/spapanik/dj_settings/actions/workflows/tests.yml
[licence_badge]: https://img.shields.io/badge/license-LGPL_v3-blue.svg
[licence_url]: https://github.com/spapanik/dj_settings/blob/main/docs/LICENSE.md
[pypi_badge]: https://img.shields.io/pypi/v/dj_settings
[pypi_url]: https://pypi.org/project/dj_settings
[pepy_badge]: https://pepy.tech/badge/dj_settings
[pepy_url]: https://pepy.tech/project/dj_settings
[black_badge]: https://img.shields.io/badge/code_style-black-000000.svg
[black_url]: https://github.com/psf/black
[yam_badge]: https://img.shields.io/badge/build_automation-yamk-success
[yam_url]: https://github.com/spapanik/dj_settings
[ruff_badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json
[ruff_url]: https://github.com/charliermarsh/ruff
[Documentation]: https://dj-settings.readthedocs.io/en/stable/
[Changelog]: https://github.com/spapanik/dj_settings/blob/main/docs/CHANGELOG.md
Raw data
{
"_id": null,
"home_page": "https://dj-settings.readthedocs.io/en/stable/",
"name": "dj_settings",
"maintainer": "",
"docs_url": null,
"requires_python": ">=3.8,<4.0",
"maintainer_email": "",
"keywords": "settings,configuration",
"author": "Stephanos Kuma",
"author_email": "stephanos@kuma.ai",
"download_url": "https://files.pythonhosted.org/packages/cf/5c/6116edb71b74aa1eb8c16c1b75e8a6b347ae1e354ac07c1761189258d521/dj_settings-5.0.0.tar.gz",
"platform": null,
"description": "# dj_settings: project settings the UNIX way\n\n[![tests][test_badge]][test_url]\n[![license][licence_badge]][licence_url]\n[![pypi][pypi_badge]][pypi_url]\n[![downloads][pepy_badge]][pepy_url]\n[![code style: black][black_badge]][black_url]\n[![build automation: yam][yam_badge]][yam_url]\n[![Lint: ruff][ruff_badge]][ruff_url]\n\n`dj_settings` offers way to add project settings in a way that has been battle-tested for years\nin numerous UNIX apps, reading from the value `/etc/<config_file>` or `~/.config/<config_file>` or\n`/path/to/project/<config_file>` or an `ENV VAR`, allowing overriding from the next read location.\nAll of them allow overriding `/path/to/config/file.ext` with `/path/to/config/file.ext.d/<filename>.ext`.\nIt started by targeting django, but it has grown to be used as a general settings or config parser.\n\n### Usage\n\n`dj_settings` will read from various config files to get the value of a variable, in a way\nthat's very familiar to all UNIX users. It allows setting default values, and overriding\nwith ENV VARs and .d directories.\n\n## Links\n\n- [Documentation]\n- [Changelog]\n\n[test_badge]: https://github.com/spapanik/dj_settings/actions/workflows/tests.yml/badge.svg\n[test_url]: https://github.com/spapanik/dj_settings/actions/workflows/tests.yml\n[licence_badge]: https://img.shields.io/badge/license-LGPL_v3-blue.svg\n[licence_url]: https://github.com/spapanik/dj_settings/blob/main/docs/LICENSE.md\n[pypi_badge]: https://img.shields.io/pypi/v/dj_settings\n[pypi_url]: https://pypi.org/project/dj_settings\n[pepy_badge]: https://pepy.tech/badge/dj_settings\n[pepy_url]: https://pepy.tech/project/dj_settings\n[black_badge]: https://img.shields.io/badge/code_style-black-000000.svg\n[black_url]: https://github.com/psf/black\n[yam_badge]: https://img.shields.io/badge/build_automation-yamk-success\n[yam_url]: https://github.com/spapanik/dj_settings\n[ruff_badge]: https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json\n[ruff_url]: https://github.com/charliermarsh/ruff\n[Documentation]: https://dj-settings.readthedocs.io/en/stable/\n[Changelog]: https://github.com/spapanik/dj_settings/blob/main/docs/CHANGELOG.md\n",
"bugtrack_url": null,
"license": "LGPL-3.0+",
"summary": "project settings the UNIX way",
"version": "5.0.0",
"project_urls": {
"Documentation": "https://dj-settings.readthedocs.io/en/stable/",
"Homepage": "https://dj-settings.readthedocs.io/en/stable/",
"Repository": "https://github.com/spapanik/dj_settings"
},
"split_keywords": [
"settings",
"configuration"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "f20fb74afa85545bded8b76caa22b63039a22ec74470ea62f84531367a4e29d1",
"md5": "46ebebb98cc2313449a81671cead3d5e",
"sha256": "1d1218bc7392389172bbe65b56a9e739a9a0856f4bd15a3aa6afc4842df29578"
},
"downloads": -1,
"filename": "dj_settings-5.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "46ebebb98cc2313449a81671cead3d5e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.8,<4.0",
"size": 6720,
"upload_time": "2024-03-14T18:26:06",
"upload_time_iso_8601": "2024-03-14T18:26:06.501373Z",
"url": "https://files.pythonhosted.org/packages/f2/0f/b74afa85545bded8b76caa22b63039a22ec74470ea62f84531367a4e29d1/dj_settings-5.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "cf5c6116edb71b74aa1eb8c16c1b75e8a6b347ae1e354ac07c1761189258d521",
"md5": "bf7e8d20315c40703741c9b3da9caf08",
"sha256": "deaa5171bd652512620982c199bebcc9d1dbdeff4d08dfe167ca9797713c9ff6"
},
"downloads": -1,
"filename": "dj_settings-5.0.0.tar.gz",
"has_sig": false,
"md5_digest": "bf7e8d20315c40703741c9b3da9caf08",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.8,<4.0",
"size": 6528,
"upload_time": "2024-03-14T18:26:08",
"upload_time_iso_8601": "2024-03-14T18:26:08.362754Z",
"url": "https://files.pythonhosted.org/packages/cf/5c/6116edb71b74aa1eb8c16c1b75e8a6b347ae1e354ac07c1761189258d521/dj_settings-5.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-03-14 18:26:08",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "spapanik",
"github_project": "dj_settings",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "dj_settings"
}
JSON
