dynamic-config-loader 2.6.0__tar.gz → 2.7.1__tar.gz

{dynamic_config_loader-2.6.0/src/dynamic_config_loader.egg-info → dynamic_config_loader-2.7.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dynamic-config-loader
-Version: 2.6.0
+Version: 2.7.1
 Summary: An enterprise-grade configuration orchestration engine designed to ingest, cascade, and deeply merge multiple configuration file layers.
 Author-email: Avinash Kumar <halfhiddencode@gmail.com>
 License: 
@@ -231,8 +231,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
 License-File: AUTHORS
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: tomli>=2.5.0; python_version < "3.11"
 Dynamic: license-file
 
 # Dynamic Configuration Loader
@@ -241,6 +241,26 @@ A lightweight, production-grade, strategy-driven configuration orchestration eng
 
 ---
 
+> [!TIP]
+> ### 👋 NEW TO DYNAMIC CONFIG LOADER? START HERE!
+> 
+> Choose your role to find the fastest path to get up and running:
+> 
+> * **🆕 Application Developer (First Time User):** Start with the **[3-Line Quick Start Tutorial](docs/tutorials/getting_started.md)**.
+> * **🚀 DevOps / SRE Engineer:** Check the **[Configuration Lifecycle Matrix](docs/guides/user_usage.md#1-minimal-to-advanced-configuration-lifecycle-guide)** & **[K8s Deployment Scenarios](docs/guides/user_usage.md#7-production-deployment-scenarios)**.
+> * **🛠️ Open-Source Contributor:** See the **[Track A vs Track B Contributor Guide](docs/guides/contributor_guide.md#1-contributing-features-vs-format-strategies)**.
+> * **📦 Maintainer / DevOps Release:** Read the **[Release & OIDC Deployment Guide](docs/guides/release_guide.md)**.
+
+> [!NOTE]
+> ### 🌐 DYNAMIC CONFIG LOADER ECOSYSTEM & OTHER LANGUAGES
+> 
+> Looking for this library in another programming language? Dynamic Config Loader is available for:
+> 
+> * 🐍 **Python Version:** [`python-dynamic-config-loader`](https://gitlab.com/halfhiddencode/python-dynamic-config-loader) (This repository)
+> * 🟢 **Node.js / TypeScript Version:** [`node-dynamic-config-loader`](https://gitlab.com/halfhiddencode/node-dynamic-config-loader)
+
+---
+
 ## 📌 Quick Navigation Index
 
 - [⚡ Minimal Quick Start](#-quick-start-minimal-3-lines)
@@ -369,9 +389,26 @@ export DCL_LOG_LEVEL=info
 | **🚀 Getting Started Tutorial** | [getting_started.md](docs/tutorials/getting_started.md) | Step-by-step onboarding & minimal execution tracks. |
 | **📖 Operations & Usage Guide** | [user_usage.md](docs/guides/user_usage.md) | Complete format matrix, K8s/DevOps deployment scenarios, & path edge cases. |
 | **🛠️ Contributor Guide** | [contributor_guide.md](docs/guides/contributor_guide.md) | Adding custom format strategies & factory registry hooks. |
+| **🚀 Release & OIDC Guide** | [release_guide.md](docs/guides/release_guide.md) | OIDC Trusted Publishing, version bump rules, & PyPI deployment protocols. |
 | **🏗️ Architecture Reference** | [architecture.md](docs/reference/architecture.md) | System design, UML diagrams, & deep merge algorithms. |
 
 ---
 
+## 🤖 AI Agent & Coding Assistant Integration Skills
+
+`python-dynamic-config-loader` includes dedicated Python AI Skills designed for AI pair programmers (Cursor, Antigravity, Claude Code, Codex, GitHub Copilot):
+
+| AI Skill Name | Description & Target Persona | Location in Repository |
+| :--- | :--- | :--- |
+| **`python-dynamic-config-loader-usage`** | **Consumer AI Skill:** Guides AI models when writing Python application code, integrating configurations, and setting container environment variables. | [.agents/skills/python-dynamic-config-loader-usage/SKILL.md](.agents/skills/python-dynamic-config-loader-usage/SKILL.md) |
+| **`python-dynamic-config-loader-contributor`** | **Contributor AI Skill:** Guides AI models when adding new format strategies (`BaseStrategy`), extending logger logic, or writing Python unit tests. | [.agents/skills/python-dynamic-config-loader-contributor/SKILL.md](.agents/skills/python-dynamic-config-loader-contributor/SKILL.md) |
+
+### How to use with AI Models:
+- **Cursor / Claude Code / Antigravity:** The agent automatically discovers skills in `.agents/skills/`. You can trigger them directly by prompting:
+  > *"Use the `python-dynamic-config-loader-usage` skill to configure python-dynamic-config-loader in my application."*
+- **GitHub Copilot / Codex:** Reference [.agents/skills/python-dynamic-config-loader-usage/SKILL.md](.agents/skills/python-dynamic-config-loader-usage/SKILL.md) in your prompt or workspace instructions.
+
+---
+
 ## 📜 License
 Licensed under the [Apache License, Version 2.0](LICENSE).

{dynamic_config_loader-2.6.0 → dynamic_config_loader-2.7.1}/README.md

@@ -4,6 +4,26 @@ A lightweight, production-grade, strategy-driven configuration orchestration eng
 
 ---
 
+> [!TIP]
+> ### 👋 NEW TO DYNAMIC CONFIG LOADER? START HERE!
+> 
+> Choose your role to find the fastest path to get up and running:
+> 
+> * **🆕 Application Developer (First Time User):** Start with the **[3-Line Quick Start Tutorial](docs/tutorials/getting_started.md)**.
+> * **🚀 DevOps / SRE Engineer:** Check the **[Configuration Lifecycle Matrix](docs/guides/user_usage.md#1-minimal-to-advanced-configuration-lifecycle-guide)** & **[K8s Deployment Scenarios](docs/guides/user_usage.md#7-production-deployment-scenarios)**.
+> * **🛠️ Open-Source Contributor:** See the **[Track A vs Track B Contributor Guide](docs/guides/contributor_guide.md#1-contributing-features-vs-format-strategies)**.
+> * **📦 Maintainer / DevOps Release:** Read the **[Release & OIDC Deployment Guide](docs/guides/release_guide.md)**.
+
+> [!NOTE]
+> ### 🌐 DYNAMIC CONFIG LOADER ECOSYSTEM & OTHER LANGUAGES
+> 
+> Looking for this library in another programming language? Dynamic Config Loader is available for:
+> 
+> * 🐍 **Python Version:** [`python-dynamic-config-loader`](https://gitlab.com/halfhiddencode/python-dynamic-config-loader) (This repository)
+> * 🟢 **Node.js / TypeScript Version:** [`node-dynamic-config-loader`](https://gitlab.com/halfhiddencode/node-dynamic-config-loader)
+
+---
+
 ## 📌 Quick Navigation Index
 
 - [⚡ Minimal Quick Start](#-quick-start-minimal-3-lines)
@@ -132,9 +152,26 @@ export DCL_LOG_LEVEL=info
 | **🚀 Getting Started Tutorial** | [getting_started.md](docs/tutorials/getting_started.md) | Step-by-step onboarding & minimal execution tracks. |
 | **📖 Operations & Usage Guide** | [user_usage.md](docs/guides/user_usage.md) | Complete format matrix, K8s/DevOps deployment scenarios, & path edge cases. |
 | **🛠️ Contributor Guide** | [contributor_guide.md](docs/guides/contributor_guide.md) | Adding custom format strategies & factory registry hooks. |
+| **🚀 Release & OIDC Guide** | [release_guide.md](docs/guides/release_guide.md) | OIDC Trusted Publishing, version bump rules, & PyPI deployment protocols. |
 | **🏗️ Architecture Reference** | [architecture.md](docs/reference/architecture.md) | System design, UML diagrams, & deep merge algorithms. |
 
 ---
 
+## 🤖 AI Agent & Coding Assistant Integration Skills
+
+`python-dynamic-config-loader` includes dedicated Python AI Skills designed for AI pair programmers (Cursor, Antigravity, Claude Code, Codex, GitHub Copilot):
+
+| AI Skill Name | Description & Target Persona | Location in Repository |
+| :--- | :--- | :--- |
+| **`python-dynamic-config-loader-usage`** | **Consumer AI Skill:** Guides AI models when writing Python application code, integrating configurations, and setting container environment variables. | [.agents/skills/python-dynamic-config-loader-usage/SKILL.md](.agents/skills/python-dynamic-config-loader-usage/SKILL.md) |
+| **`python-dynamic-config-loader-contributor`** | **Contributor AI Skill:** Guides AI models when adding new format strategies (`BaseStrategy`), extending logger logic, or writing Python unit tests. | [.agents/skills/python-dynamic-config-loader-contributor/SKILL.md](.agents/skills/python-dynamic-config-loader-contributor/SKILL.md) |
+
+### How to use with AI Models:
+- **Cursor / Claude Code / Antigravity:** The agent automatically discovers skills in `.agents/skills/`. You can trigger them directly by prompting:
+  > *"Use the `python-dynamic-config-loader-usage` skill to configure python-dynamic-config-loader in my application."*
+- **GitHub Copilot / Codex:** Reference [.agents/skills/python-dynamic-config-loader-usage/SKILL.md](.agents/skills/python-dynamic-config-loader-usage/SKILL.md) in your prompt or workspace instructions.
+
+---
+
 ## 📜 License
 Licensed under the [Apache License, Version 2.0](LICENSE).

{dynamic_config_loader-2.6.0 → dynamic_config_loader-2.7.1}/pyproject.toml

@@ -1,10 +1,15 @@
 [build-system]
-requires = ["setuptools>=61.0.0", "wheel"]
+requires = [
+    "setuptools>=82.0.1; python_version >= '3.9'",
+    "setuptools>=61.0.0; python_version < '3.9'",
+    "wheel>=0.48.0; python_version >= '3.9'",
+    "wheel; python_version < '3.9'",
+]
 build-backend = "setuptools.build_meta"
 
 [project]
 name = "dynamic-config-loader"
-version = "2.6.0"
+version = "2.7.1"
 description = "An enterprise-grade configuration orchestration engine designed to ingest, cascade, and deeply merge multiple configuration file layers."
 readme = "README.md"
 requires-python = ">=3.8"
@@ -51,8 +56,8 @@ classifiers = [
 ]
 
 dependencies = [
-    "pyyaml>=6.0.1",
-    "tomli>=2.0.1; python_version < '3.11'",
+    "pyyaml>=6.0.3",
+    "tomli>=2.5.0; python_version < '3.11'",
 ]
 
 [project.urls]

{dynamic_config_loader-2.6.0 → dynamic_config_loader-2.7.1}/src/dynamic_config_loader/environment.py

@@ -58,18 +58,15 @@ def inject_environment_variables(
             sliced_key = env_key[len(prefix):]
             parsed_val = _parse_env_value(env_val)
 
+            # Resolution order:
+            # 1. Explicit double-underscore '__': Splits into nested objects (e.g. DCL_AUTH__TENANT_ID -> config_data["auth"]["tenant_id"])
+            # 2. Default: Preserves as 100% FLAT key (e.g. DCL_SERVICE_GATEWAY_NAME -> config_data["service_gateway_name"])
             flat_key = sliced_key.strip().lower()
 
-            # Resolution order:
-            # 1. Direct flat key match in config_data (e.g. DCL_TEST_NAME -> config_data["test_name"])
-            # 2. Double-underscore '__' explicit namespace splitting (e.g. DCL_AUTH__TENANT_ID -> config_data["auth"]["tenant_id"])
-            # 3. Single-underscore '_' nested path splitting (e.g. DCL_DATABASE_PORT -> config_data["database"]["port"])
-            if flat_key in config_data:
-                parts = [flat_key]
-            elif "__" in sliced_key:
+            if "__" in sliced_key:
                 parts = [p.lower() for p in sliced_key.split("__") if p]
             else:
-                parts = [p.lower() for p in sliced_key.split("_") if p]
+                parts = [flat_key]
 
             if not parts:
                 continue

{dynamic_config_loader-2.6.0 → dynamic_config_loader-2.7.1/src/dynamic_config_loader.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dynamic-config-loader
-Version: 2.6.0
+Version: 2.7.1
 Summary: An enterprise-grade configuration orchestration engine designed to ingest, cascade, and deeply merge multiple configuration file layers.
 Author-email: Avinash Kumar <halfhiddencode@gmail.com>
 License: 
@@ -231,8 +231,8 @@ Description-Content-Type: text/markdown
 License-File: LICENSE
 License-File: NOTICE
 License-File: AUTHORS
-Requires-Dist: pyyaml>=6.0.1
-Requires-Dist: tomli>=2.0.1; python_version < "3.11"
+Requires-Dist: pyyaml>=6.0.3
+Requires-Dist: tomli>=2.5.0; python_version < "3.11"
 Dynamic: license-file
 
 # Dynamic Configuration Loader
@@ -241,6 +241,26 @@ A lightweight, production-grade, strategy-driven configuration orchestration eng
 
 ---
 
+> [!TIP]
+> ### 👋 NEW TO DYNAMIC CONFIG LOADER? START HERE!
+> 
+> Choose your role to find the fastest path to get up and running:
+> 
+> * **🆕 Application Developer (First Time User):** Start with the **[3-Line Quick Start Tutorial](docs/tutorials/getting_started.md)**.
+> * **🚀 DevOps / SRE Engineer:** Check the **[Configuration Lifecycle Matrix](docs/guides/user_usage.md#1-minimal-to-advanced-configuration-lifecycle-guide)** & **[K8s Deployment Scenarios](docs/guides/user_usage.md#7-production-deployment-scenarios)**.
+> * **🛠️ Open-Source Contributor:** See the **[Track A vs Track B Contributor Guide](docs/guides/contributor_guide.md#1-contributing-features-vs-format-strategies)**.
+> * **📦 Maintainer / DevOps Release:** Read the **[Release & OIDC Deployment Guide](docs/guides/release_guide.md)**.
+
+> [!NOTE]
+> ### 🌐 DYNAMIC CONFIG LOADER ECOSYSTEM & OTHER LANGUAGES
+> 
+> Looking for this library in another programming language? Dynamic Config Loader is available for:
+> 
+> * 🐍 **Python Version:** [`python-dynamic-config-loader`](https://gitlab.com/halfhiddencode/python-dynamic-config-loader) (This repository)
+> * 🟢 **Node.js / TypeScript Version:** [`node-dynamic-config-loader`](https://gitlab.com/halfhiddencode/node-dynamic-config-loader)
+
+---
+
 ## 📌 Quick Navigation Index
 
 - [⚡ Minimal Quick Start](#-quick-start-minimal-3-lines)
@@ -369,9 +389,26 @@ export DCL_LOG_LEVEL=info
 | **🚀 Getting Started Tutorial** | [getting_started.md](docs/tutorials/getting_started.md) | Step-by-step onboarding & minimal execution tracks. |
 | **📖 Operations & Usage Guide** | [user_usage.md](docs/guides/user_usage.md) | Complete format matrix, K8s/DevOps deployment scenarios, & path edge cases. |
 | **🛠️ Contributor Guide** | [contributor_guide.md](docs/guides/contributor_guide.md) | Adding custom format strategies & factory registry hooks. |
+| **🚀 Release & OIDC Guide** | [release_guide.md](docs/guides/release_guide.md) | OIDC Trusted Publishing, version bump rules, & PyPI deployment protocols. |
 | **🏗️ Architecture Reference** | [architecture.md](docs/reference/architecture.md) | System design, UML diagrams, & deep merge algorithms. |
 
 ---
 
+## 🤖 AI Agent & Coding Assistant Integration Skills
+
+`python-dynamic-config-loader` includes dedicated Python AI Skills designed for AI pair programmers (Cursor, Antigravity, Claude Code, Codex, GitHub Copilot):
+
+| AI Skill Name | Description & Target Persona | Location in Repository |
+| :--- | :--- | :--- |
+| **`python-dynamic-config-loader-usage`** | **Consumer AI Skill:** Guides AI models when writing Python application code, integrating configurations, and setting container environment variables. | [.agents/skills/python-dynamic-config-loader-usage/SKILL.md](.agents/skills/python-dynamic-config-loader-usage/SKILL.md) |
+| **`python-dynamic-config-loader-contributor`** | **Contributor AI Skill:** Guides AI models when adding new format strategies (`BaseStrategy`), extending logger logic, or writing Python unit tests. | [.agents/skills/python-dynamic-config-loader-contributor/SKILL.md](.agents/skills/python-dynamic-config-loader-contributor/SKILL.md) |
+
+### How to use with AI Models:
+- **Cursor / Claude Code / Antigravity:** The agent automatically discovers skills in `.agents/skills/`. You can trigger them directly by prompting:
+  > *"Use the `python-dynamic-config-loader-usage` skill to configure python-dynamic-config-loader in my application."*
+- **GitHub Copilot / Codex:** Reference [.agents/skills/python-dynamic-config-loader-usage/SKILL.md](.agents/skills/python-dynamic-config-loader-usage/SKILL.md) in your prompt or workspace instructions.
+
+---
+
 ## 📜 License
 Licensed under the [Apache License, Version 2.0](LICENSE).

{dynamic_config_loader-2.6.0 → dynamic_config_loader-2.7.1}/src/dynamic_config_loader.egg-info/requires.txt

@@ -1,4 +1,4 @@
-pyyaml>=6.0.1
+pyyaml>=6.0.3
 
 [:python_version < "3.11"]
-tomli>=2.0.1
+tomli>=2.5.0

{dynamic_config_loader-2.6.0 → dynamic_config_loader-2.7.1}/tests/test_env_injection.py

@@ -39,9 +39,9 @@ class TestEnvInjection(unittest.TestCase):
         Verifies that configuration parameters are injected correctly with the default prefix.
         """
         os.environ["DCL_ENV_LOADER"] = "true"
-        os.environ["DCL_DATABASE_PORT"] = "9000"
-        os.environ["DCL_DATABASE_USER"] = "postgres_env"
-        os.environ["DCL_NEW_FEATURE_ENABLED"] = "true"
+        os.environ["DCL_DATABASE__PORT"] = "9000"
+        os.environ["DCL_DATABASE__USER"] = "postgres_env"
+        os.environ["DCL_SERVICE_GATEWAY_NAME"] = "payment_gateway"
 
         loader = DynamicConfigLoader(default_config_path=str(self.base_file))
         result = loader.load()
@@ -49,7 +49,7 @@ class TestEnvInjection(unittest.TestCase):
         # Check nested structures are created or overridden
         self.assertEqual(result["database"]["port"], 9000)  # String "9000" is parsed to int 9000
         self.assertEqual(result["database"]["user"], "postgres_env")
-        self.assertTrue(result["new"]["feature"]["enabled"])  # String "true" is parsed to bool True
+        self.assertEqual(result["service_gateway_name"], "payment_gateway")  # Single _ is 100% flat!
 
     def test_injection_double_underscore_delimiter(self):
         """
@@ -83,7 +83,7 @@ class TestEnvInjection(unittest.TestCase):
         Verifies that configuration parameters are injected correctly using a custom prefix.
         """
         os.environ["DCL_ENV_LOADER"] = "true"
-        os.environ["MYAPP_DB_HOST"] = "remote.db"
+        os.environ["MYAPP_DB__HOST"] = "remote.db"
 
         # Pass custom prefix to constructor
         loader = DynamicConfigLoader(default_config_path=str(self.base_file), prefix="MYAPP_")