dynamic-config-loader 2.5.0

An enterprise-grade configuration orchestration engine designed to ingest, cascade, and deeply merge multiple configuration file layers.

Dynamic Configuration Loader

A lightweight, production-grade, strategy-driven configuration orchestration engine designed to dynamically discover, alphabetically sort, and recursively deep-merge multi-layered configuration files.

Supported Formats

The orchestration engine natively parses and cascades the following configuration formats:

• YAML (.yaml, .yml)
• JSON (.json)
• XML (.xml)
• TOML (.toml)
• INI / Conf (.ini, .conf)
• Java Properties (.properties)
• Dotenv (.env)

---

Copyright (C) 2026 Avinash Kumar <halfhiddencode AT gmail DOT com>

Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at

    http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.

---

Project Metadata

• Maintainer: Avinash Kumar
• Target Ecosystem: Python 3.8+ / GitLab Source Hosting and PyPI Package Registry
• Official Repository: python-dynamic-config-loader
• Licensing: Apache License, Version 2.0
• Core Design Patterns: Strategy Pattern, Registry Factory

---

Installation

Install the package directly from PyPI:

pip install dynamic-config-loader

Or install in editable mode for local development:

pip install -e .

---

Quick Start

import os
from dynamic_config_loader import DynamicConfigLoader

# 1. (Optional) Provide path override layers via system environment
os.environ["PYTHON_ADDITIONAL_CONFIG"] = "/app/configs/overrides_directory"

# 2. Instantiate with a local base configuration file
loader = DynamicConfigLoader(default_config_path="/app/configs/base_defaults.yaml")

# 3. Load and compile configurations
config = loader.load()
print(config["database"]["host"])

---

Documentation Index

The complete enterprise documentation is organized under the Diátaxis framework layout rules within the docs/ directory. No emojis are used in the index or guidelines.

Track	Target Document	Description
Getting Started	Getting Started Tutorial	Onboarding sequence, repeatable format tracks, and installation via GitLab Package Registry.
Operations Guide	Advanced Ingestion and Path Traversal Guide	Path parsing matrix, edge-case refusals, Central Config Manager pattern, and log masking safety details.
Contributor Guide	Format Strategy Contribution Guide	Abstract base strategy class signatures, factory registration hooks, and copy-pasteable JSON blueprints.
Technical Reference	Core Architecture Reference	System design architecture, UML mapping, execution pipelines, and logging safety compliance matrices.

---

Repository Ledgers

• Version History: CHANGELOG.md
• Security Policy: SECURITY.md
• Contribution Protocols: CONTRIBUTING.md