jsonconfig-utils 1.0.3__py3-none-any.whl

jsonconfig_utils-1.0.3.dist-info/METADATA

@@ -0,0 +1,41 @@
+Metadata-Version: 2.4
+Name: jsonconfig-utils
+Version: 1.0.3
+Summary: Lightweight JSON configuration loader with environment variable interpolation
+Home-page: https://github.com/config-utils/jsonconfig-utils
+Author: Config Utils Contributors
+Author-email: config-utils-py@proton.me
+Keywords: json config configuration env loader
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries
+Requires-Python: >=3.7
+Description-Content-Type: text/markdown
+Dynamic: author
+Dynamic: author-email
+Dynamic: classifier
+Dynamic: description
+Dynamic: description-content-type
+Dynamic: home-page
+Dynamic: keywords
+Dynamic: requires-python
+Dynamic: summary
+
+
+# jsonconfig-utils
+
+Simple JSON config loader with env var interpolation, schema validation, and nested key access.
+
+## Installation
+```
+pip install jsonconfig-utils
+```
+
+## Quick Start
+```python
+from jsonconfig_utils import load_config
+config = load_config("config.json")
+print(config.database.host)
+```

jsonconfig_utils-1.0.3.dist-info/RECORD

@@ -0,0 +1,5 @@
+jsonconfig_utils.py,sha256=aEIS-OmU9ys-OGWWQb28h_tzwSrwqlnAMRTylK3qtX4,2008
+jsonconfig_utils-1.0.3.dist-info/METADATA,sha256=JlOMJ4kBszkQkRk8gG3LjmKKqj7ZHCpOQ2mi6mHjb_8,1144
+jsonconfig_utils-1.0.3.dist-info/WHEEL,sha256=YCfwYGOYMi5Jhw2fU4yNgwErybb2IX5PEwBKV4ZbdBo,91
+jsonconfig_utils-1.0.3.dist-info/top_level.txt,sha256=Ugw0U-2soo52K13Cz09vLOkjSgCrXKxTgit7v5cVPPs,17
+jsonconfig_utils-1.0.3.dist-info/RECORD,,

jsonconfig_utils-1.0.3.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

jsonconfig_utils-1.0.3.dist-info/top_level.txt

@@ -0,0 +1 @@
+jsonconfig_utils

jsonconfig_utils.py

@@ -0,0 +1,61 @@
+"""jsonconfig-utils: Lightweight JSON configuration loader."""
+
+__version__ = "1.0.3"
+__all__ = ["load_config", "ConfigDict", "validate_schema"]
+
+import json, os, re
+
+def load_config(path, env_interpolate=True, defaults=None):
+    with open(path) as f:
+        data = json.load(f)
+    if defaults:
+        data = _merge(defaults, data)
+    if env_interpolate:
+        data = _interpolate_env(data)
+    return ConfigDict(data)
+
+def validate_schema(data, schema):
+    errors = []
+    for key, expected_type in schema.items():
+        if key not in data:
+            errors.append(f"Missing required key: {key}")
+        elif not isinstance(data[key], expected_type):
+            errors.append(f"Key \'{key}\' expected {expected_type.__name__}, got {type(data[key]).__name__}")
+    return errors
+
+class ConfigDict(dict):
+    def __getattr__(self, key):
+        try:
+            val = self[key]
+            return ConfigDict(val) if isinstance(val, dict) else val
+        except KeyError:
+            raise AttributeError(f"Config has no key \'{key}\'")
+    def __setattr__(self, key, value):
+        self[key] = value
+    def get_nested(self, dotted_key, default=None):
+        keys = dotted_key.split(".")
+        val = self
+        for k in keys:
+            if isinstance(val, dict) and k in val:
+                val = val[k]
+            else:
+                return default
+        return val
+
+def _interpolate_env(obj):
+    if isinstance(obj, str):
+        return re.sub(r"\$\{(\w+)\}", lambda m: os.environ.get(m.group(1), m.group(0)), obj)
+    elif isinstance(obj, dict):
+        return {k: _interpolate_env(v) for k, v in obj.items()}
+    elif isinstance(obj, list):
+        return [_interpolate_env(v) for v in obj]
+    return obj
+
+def _merge(base, override):
+    result = base.copy()
+    for k, v in override.items():
+        if k in result and isinstance(result[k], dict) and isinstance(v, dict):
+            result[k] = _merge(result[k], v)
+        else:
+            result[k] = v
+    return result