configcraft 0.1.2

Welcome to configcraft Documentation

A Python library for DRY (Do not repeat yourself) configuration management with inheritance patterns and secure configuration merging.

📚 Full documentation is available at HERE

Key Features:

• 🔄 Configuration Inheritance: Use _defaults sections to eliminate duplication across environments

• 🔒 Secure Config Merging: Safely combine non-sensitive config with secrets without exposing credentials

• 🎯 JSON Path Patterns: Apply defaults with flexible *.field and env.field patterns

• 📋 List Merging: Intelligently merge lists by position to maintain data relationships

• 🛡️ Type Safety: Structure-aware merging with validation and clear error messages

from configcraft.api import apply_inheritance

config = {
    "_defaults": {
        "*.port": 8080,
        "*.timeout": 30
    },
    "dev": {
        "host": "localhost"
    },
    "prod": {
        "host": "api.company.com",
        "port": 443
    }
}

apply_inheritance(config)
# Result:
# {
#     "dev": {
#         "host": "localhost",
#         "port": 8080,
#         "timeout": 30
#     },
#     "prod": {
#         "host": "api.company.com",
#         "port": 443,
#         "timeout": 30
#     }
# }

from configcraft.api import deep_merge

# config.json (safe to commit)
base_config = {
    "database": {
        "host": "prod-db.com",
        "port": 5432
    }
}

# secrets.json (never commit)
secrets = {
    "database": {
        "password": "secret123"
    }
}

final_config = deep_merge(base_config, secrets)
# Result:
# {
#     "database": {
#         "host": "prod-db.com",
#         "port": 5432,
#         "password": "secret123"
#     }
# }

$ pip install configcraft

$ pip install --upgrade configcraft