kwconf 0.10.0

Typed, dependency-free configuration objects with CLI, environment, and file parsing (a scriptconfig successor).

kwconf provides typed, dependency-free configuration objects that parse consistently from Python keyword arguments, the command line, the environment, and config files. It is a successor to scriptconfig, keeping the useful ergonomics while dropping the footguns (most notably, comma-strings no longer silently split into lists).

Read the Docs	http://kwconf.readthedocs.io/en/latest/
Github	https://github.com/Erotemic/kwconf
Pypi	https://pypi.org/project/kwconf

Features

• One model, many inputs. CLI, kwargs, env, and files map onto the same field model.

• Trust at the Python boundary, parse at the text boundary. Config(x='1') keeps '1'; --x=1 parses it. Defaults are WYSIWYG.

• Progressive typing. Stays simple untyped; add annotations to harden. Value / Flag are typed so x: int = Value(None) is a static error on ty, mypy, and pyright. Ships py.typed.

• Zero required dependencies. YAML and the ubelt-backed niceties are optional extras.

• Modal subcommand CLIs, nested configs with dotted overrides, argparse round-tripping, and YAML/JSON load/dump.

Installation

pip install kwconf

# optional extras
pip install kwconf[yaml]    # YAML config load/dump and parser='yaml'
pip install kwconf[ubelt]   # rich repr, Config.__json__, port_to_argparse

Quickstart

import kwconf as kw

class DemoConfig(kw.Config):
    count: int = 1
    mode: str = kw.Value('fast', choices=['fast', 'safe'])
    tags: list[str] = kw.Value(default_factory=list, nargs='+')

cfg = DemoConfig.cli(argv=['--count=3', '--mode=safe', '--tags', 'a', 'b'])
assert cfg.count == 3
assert cfg.mode == 'safe'
assert cfg.tags == ['a', 'b']

See the documentation for the coercion model, nested configs, modal CLIs, and a scriptconfig migration guide.