A powerful multi-tier configuration management framework that simplifies the definition, access, and synchronization of layered configurations in Python applications.
Think of VSCode's configuration system: you have user settings that apply globally and workspace settings that override them for specific projects. Conftier brings this same intuitive model to your Python frameworks and applications.
For comprehensive guides, examples, and API reference, visit our documentation:
Conftier helps you manage configurations across multiple levels:
- User-level settings: Global preferences that apply across all projects (~/.zeeland/{config_name}/config.yaml)
- Project-level settings: Local configurations specific to a project (./.{config_name}/config.yaml)
- Default values: Fallback values defined in your configuration schema
Conftier automatically merges these configurations based on priority (project > user > default).
- Multi-level Configuration Management: Like VSCode's user/workspace settings pattern
- Flexible Schema Definition: Use Pydantic models or dataclasses to define and validate configurations
- Type Safety: No more string/int confusion or missing required fields
- Smart Merging: Only override what's specified, preserving other values
- CLI Integration: Built-in command-line tools for configuration management
- IDE Autocompletion: Full type hints for a great developer experience
| Without Conftier | With Conftier |
|---|---|
| Manual parsing of multiple config files | Automatic loading and merging |
| Type errors discovered at runtime | Validation at load time |
| Custom code for merging configs | Smart merging built-in |
| Documentation struggles | Schema serves as documentation |
| Repetitive boilerplate | Consistent, reusable pattern |
# Basic installation
pip install conftier
# With Pydantic support (recommended)
pip install conftier[pydantic]from pydantic import BaseModel, Field
from conftier import ConfigManager
class AppConfig(BaseModel):
app_name: str = "MyApp"
debug: bool = False
config_manager = ConfigManager(
config_name="myapp",
config_schema=AppConfig,
auto_create=True
)
# Load the merged configuration
config: AppConfig = config_manager.load()Conftier shines when:
- You're building a framework or library: Give your users a consistent way to configure your tool
- Your app has both user and project settings: Like VSCode's personal vs. project-specific settings
- You need schema validation: Ensure configuration values have the correct types and valid ranges
- You want to reduce boilerplate: Stop writing the same configuration loading code in every project
This project is licensed under the terms of the MIT license.
See LICENSE for more details.
For more information, please contact: [email protected]
This project was generated with P3G