confit

library0.10.2pypypi✓ verified 89d ago

Confit is a smart configuration framework for Python that supports hierarchical configs, CLI overrides, and validation via pydantic. It merges YAML/TOML/JSON config files with command-line arguments and environment variables. Current version is 0.10.2, with frequent minor releases.

serialization devops web-framework

pip install confit

package ↗

INSTALL

IMPORT

SIG · CONFIT

confit

serializationpythonv0.10.2

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

ConfitConfig

✓ from confit import Config

✗ from confit import ConfitConfig

The main config class is named 'Config', not 'ConfitConfig'.

validate_arguments

✓ from confit import validate_arguments

No common wrong import.

Load a YAML config file and override keys via CLI-style strings.

import os from confit import Config # Load config from YAML with CLI overrides cfg = Config('config.yaml', overrides=['key=value']) print(cfg.to_dict())

confit --version

Debug

Known issues

breakingIn version 0.10.0, the `Config` class was renamed from `ConfitConfig` to `Config`. Old code using `ConfitConfig` will break.

fix

Use `from confit import Config` instead.

affects: >=0.10.0,<0.10.0

deprecatedThe `--config` CLI flag is deprecated in favor of position-based config file loading.

fix

Specify config file path as a positional argument: `python script.py path/to/config.yaml`.

affects: >=0.9.0

gotchaMerging multiple config files only works if they are specified as a list. Single string paths won't merge.

fix

Use `Config(['base.yaml', 'override.yaml'])` instead of `Config('base.yaml')`.

affects: all

Errors

Common errors & fixes

AttributeError: module 'confit' has no attribute 'ConfitConfig'

The class was renamed to `Config` in v0.10.0.

fix

Use `from confit import Config`.

confit.errors.ConfigError: Cannot merge configs: expected list, got str

`Config()` expects a list of file paths for merging, not a single string.

fix

Wrap the path in a list: `Config(['config.yaml'])` or `Config(['base.yaml', 'override.yaml'])`.

Upgrade

Version history

0.10.2latest on PyPI · released Dec 11, 2025

Audit

Dependencies

No dependency data recorded yet.

Agent activity

11 hits · last 30 days

node

OpenAI (training)

Resources

packagehttps://pypi.org/project/confit/ ↗