---
id: maison
version: "2.0.2"
license: MIT
license_treatment: permissive
maintenance: aging
---

# maison — Read settings from config files

License: permissive · Maintenance: aging · Downloads: 1.2M/mo

## What it is and what it does

Maison is a configuration file reader designed for Python packages and command-line tools. It loads settings from files like pyproject.toml or .ini files in a user's directory, with optional validation and built-in caching. The package exposes a UserConfig class that retrieves configuration values by package name, making it straightforward to let users customize tool behavior through standard config files.

The library supports multiple config file types and optional merging of settings across files. It is fully typed and tested. Runtime dependencies are loguru, platformdirs, tomli, typer, and typing-extensions. The package requires Python 3.9 or later.

Use it for:

- Load tool settings from pyproject.toml so users can configure behavior without command-line flags
- Read and validate configuration from .ini or other config files with optional validation
- Cache config file contents to avoid repeated disk reads in long-running applications
- Merge settings from multiple config files to support layered configuration strategies
- Build CLI tools that respect user preferences stored in standard config locations

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Maison reads configuration settings from files like pyproject.toml and .ini files, with support for multiple file types and optional pydantic-based validation.

Yes, if you need to read and validate user configuration files in a Python package or CLI tool. The low install friction, permissive license, and straightforward API make it practical. However, the aging maintenance status (309 days since last release) means you should verify the package still meets your needs and be prepared to maintain a fork if critical issues arise.

## Install

pip install maison
uv add maison
poetry add maison

## Installing maison

Before you install: Low install friction with a pure-Python wheel and five lightweight runtime dependencies. Maintenance status is aging—last release was 309 days ago—so expect slower response to issues.

License in practice: MIT license is permissive, allowing free use, modification, and distribution with minimal restrictions.

Quickstart:

pip install maison

from maison import UserConfig

config = UserConfig(package_name="acme")
if config.values["enable_useful_option"]:
    # use the config value

Requires Python 3.9 or later.

Verify before relying:

- Whether pydantic validation is optional or required for typical use cases
- Performance characteristics when caching large or deeply nested config files
- Exact behavior when multiple config files define conflicting keys

## Package facts

- License: MIT (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: aging
- Downloads: 1.2M/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

read config files, pyproject.toml configuration, config file parsing, application settings loader, configuration validation, ini file reader, config merging, config-management, cli-tools

[View on SkillFed](https://skillfed.io/packages/maison) · [View on PyPI](https://pypi.org/project/maison/)