konfetti 0.7.2

`konfetti` provides a framework-independent way for configuration of applications or libraries written in Python.

Description

konfetti is a Python configuration management system with an intuitive API, lazy evaluation and (a)sync Vault support.

The interface design and features are heavily inspired by decouple, Django, envparse and dynaconf.

Key features:

• Lazy evaluation;

• Built-in environment variables support;

• Built-in async Vault access support;

• Helpers for tests;

• Django & Flask integration.

Benefits of lazy evaluation:

• Faster & simpler test runs; No need for evaluation the the whole project config if it is not used

• Avoid network calls during imports until necessary;

Quickstart

To use konfetti you need to define:

• configuration variables in a module or a class;

• an access point;

Settings module

# app_name/settings/production.py
from konfetti import env, vault

VAULT_ADDR = env("VAULT_ADDR")
VAULT_TOKEN = env("VAULT_TOKEN")

DEBUG = env("DEBUG", default=False)
DATABASE_URI = vault("path/to/db")

The naming convention for variables names is upper case, other variables will be ignored. To work with Vault it is required to specify VAULT_ADDR and VAULT_TOKEN in the settings module.

Access point

# app_name/settings/__init__.py
from konfetti import Konfig, AsyncVaultBackend

config = Konfig(vault_backend=AsyncVaultBackend("/secret/team"))

konfetti relies on KONFETTI_SETTINGS environment variable to discover your settings module, in the case above:

export KONFETTI_SETTINGS=app_name.settings.production

Alternatively the access point could be initiated from an object, importable string, mapping or a JSON file.

class TestSettings:
    VALUE = "secret"
config = Konfig.from_object(TestSettings, ...)

config = Konfig.from_object("path.to.settings", ...)

# If the config is in the same module
SECRET = vault("/path/to")["secret"]
config = Konfig.from_object(__name__, ...)

config = Konfig.from_mapping({"SECRET": 42}, ...)

config = Konfig.from_json("/path/to.json")

Usage

The settings module/class with configuration options shouldn’t be accessed directly, because the aforementioned features are implemented in the access point level.

from app_name.settings import config

async def something():
    await config.DATABASE_URI  # asynchronously taken from Vault
    debug = config.DEBUG  # Usual sync access

Documentation

For full documentation, please see https://konfetti.readthedocs.io/en/latest/

Or you can look at the docs/ directory in the repository.

Python support

Konfetti supports Python 2.7, 3.5, 3.6, 3.7 and 3.8

License

The code in this project is licensed under MIT license. By contributing to konfetti, you agree that your contributions will be licensed under its MIT license.