configaroo 0.1.0__py3-none-any.whl → 0.1.2__py3-none-any.whl

configaroo/__init__.py

@@ -6,3 +6,5 @@ from configaroo.exceptions import (  # noqa
     MissingEnvironmentVariableError,
     UnsupportedLoaderError,
 )
+
+__version__ = "0.1.2"

configaroo/configuration.py

@@ -1,11 +1,12 @@
 """A dict-like configuration with support for envvars, validation and type conversion"""
 
+import inspect
 import os
+import re
 from collections import UserDict
 from pathlib import Path
 from typing import Any, Self, Type
 
-import dotenv
 from pydantic import BaseModel
 
 from configaroo import loaders
@@ -27,7 +28,9 @@ class Configuration(UserDict):
     ) -> Self:
         """Read a Configuration from a file"""
         config_dict = loaders.from_file(file_path, loader=loader)
-        return cls(**config_dict).initialize(envs=envs, model=model)
+        return cls(config_dict).initialize(
+            envs=envs, env_prefix=env_prefix, extra_dynamic=extra_dynamic, model=model
+        )
 
     def initialize(
         self,
@@ -51,7 +54,7 @@ class Configuration(UserDict):
         """Make sure nested sections have type Configuration"""
         value = self.data[key]
         if isinstance(value, dict | UserDict | Configuration):
-            return Configuration(**value)
+            return Configuration(value)
         else:
             return value
 
@@ -76,39 +79,33 @@ class Configuration(UserDict):
 
     def get(self, key: str, default: Any = None) -> Any:
         """Allow dotted keys when using .get()"""
-        if key not in self.data:
-            prefix, _, rest = key.partition(".")
-            try:
-                return self[prefix].get(rest, default=default)
-            except KeyError:
-                return default
-        else:
+        if key in self.data:
             return self[key]
 
+        prefix, _, rest = key.partition(".")
+        try:
+            return self[prefix].get(rest, default=default)
+        except KeyError:
+            return default
+
     def add(self, key: str, value: Any) -> Self:
         """Add a value, allow dotted keys"""
         prefix, _, rest = key.partition(".")
-        if rest:
-            cls = type(self)
-            return self | {prefix: cls(**self.setdefault(prefix, {})).add(rest, value)}
-        else:
+        if not rest:
             return self | {key: value}
+        cls = type(self)
+        return self | {prefix: cls(self.setdefault(prefix, {})).add(rest, value)}
 
-    def add_envs(self, envs: dict[str, str], prefix: str = "", use_dotenv=True) -> Self:
+    def add_envs(self, envs: dict[str, str], prefix: str = "") -> Self:
         """Add environment variables to configuration"""
-        if use_dotenv:
-            dotenv.load_dotenv()
-
         for env, key in envs.items():
             env_key = f"{prefix}{env}"
-            env_value = os.getenv(env_key)
-            if env_value:
+            if env_value := os.getenv(env_key):
                 self = self.add(key, env_value)
-            else:
-                if key not in self:
-                    raise MissingEnvironmentVariableError(
-                        f"required environment variable '{env_key}' not found"
-                    )
+            elif key not in self:
+                raise MissingEnvironmentVariableError(
+                    f"required environment variable '{env_key}' not found"
+                )
         return self
 
     def parse_dynamic(self, extra: dict[str, Any] | None = None) -> Self:
@@ -116,15 +113,15 @@ class Configuration(UserDict):
         cls = type(self)
         variables = (
             self.to_flat_dict()
-            | {"project_path": Path(__file__).parent.parent.parent}
+            | {"project_path": _find_pyproject_toml()}
             | ({} if extra is None else extra)
         )
         return cls(
-            **{
+            {
                 key: (
                     value.parse_dynamic(extra=variables)
                     if isinstance(value, Configuration)
-                    else value.format(**variables)
+                    else _incomplete_format(value, variables)
                     if isinstance(value, str)
                     else value
                 )
@@ -140,7 +137,7 @@ class Configuration(UserDict):
     def convert(self, model: Type[BaseModel]) -> Self:
         """Convert data types to match the given model"""
         cls = type(self)
-        return cls(**model(**self.data).model_dump())
+        return cls(model(**self.data).model_dump())
 
     def to_dict(self) -> dict[str, Any]:
         """Dump the configuration into a Python dictionary"""
@@ -166,3 +163,53 @@ class Configuration(UserDict):
                 self[nested_key].to_flat_dict(_prefix=f"{_prefix}{nested_key}.").items()
             )
         }
+
+
+def _find_pyproject_toml(
+    path: Path | None = None, _file_name: str = "pyproject.toml"
+) -> Path:
+    """Find a directory that contains a pyproject.toml file.
+
+    This searches the given directory and all direct parents. If a
+    pyproject.toml file isn't found, then the root of the file system is
+    returned.
+    """
+    path = _get_foreign_path() if path is None else path
+    if (path / _file_name).exists() or path == path.parent:
+        return path.resolve()
+    else:
+        return _find_pyproject_toml(path.parent, _file_name=_file_name)
+
+
+def _get_foreign_path() -> Path:
+    """Find the path to the library that called this package.
+
+    Search the call stack for the first source code file outside of configaroo.
+    """
+    self_prefix = Path(__file__).parent.parent
+    return next(
+        path
+        for frame in inspect.stack()
+        if not (path := Path(frame.filename)).is_relative_to(self_prefix)
+    )
+
+
+def _incomplete_format(text: str, replacers: dict[str, Any]) -> str:
+    """Replace some, but not necessarily all format specifiers in a text string.
+
+    Regular .format() raises an error if not all {replace} parameters are
+    supplied. Here, we only replace the given replace arguments and leave the
+    rest untouched.
+    """
+    dot = "__DOT__"  # Escape . in fields as they have special meaning in .format()
+    pattern = r"({{{word}(?:![ars])?(?:|:[^}}]*)}})"  # Match {word} or {word:...}
+
+    for word, replacement in replacers.items():
+        for match in re.findall(pattern.format(word=word), text):
+            # Split expression to only replace . in the field name
+            field, colon, fmt = match.partition(":")
+            replacer = f"{field.replace('.', dot)}{colon}{fmt}".format(
+                **{word.replace(".", dot): replacement}
+            )
+            text = text.replace(match, replacer)
+    return text

configaroo-0.1.2.dist-info/METADATA

@@ -0,0 +1,40 @@
+Metadata-Version: 2.4
+Name: configaroo
+Version: 0.1.2
+Summary: Bouncy handling of configuration files
+Author-email: Geir Arne Hjelle <geirarne@gmail.com>
+Maintainer-email: Geir Arne Hjelle <geirarne@gmail.com>
+License-Expression: MIT
+Project-URL: homepage, https://github.com/gahjelle/configaroo
+Project-URL: github, https://github.com/gahjelle/configaroo
+Project-URL: issues, https://github.com/gahjelle/configaroo/issues
+Project-URL: changelog, https://github.com/gahjelle/configaroo/blob/main/CHANGELOG.md
+Keywords: configuration,configuration-management,toml,json
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: Natural Language :: English
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pydantic>=2.0
+Requires-Dist: pyplugs>=0.4.0
+Dynamic: license-file
+
+# Configaroo - Bouncy Configuration Handling
+
+Configaroo is a light configuration package for Python that offers the following features:
+
+- Access configuration settings with dotted keys: `config.nested.key`
+- Use different configuration file formats, including TOML and JSON
+- Override key configuration settings with environment variables
+- Validate a configuration based on a Pydantic model
+- Convert the type of configuration values based on a Pydantic model
+- Dynamically format certain configuration values

configaroo-0.1.2.dist-info/RECORD

@@ -0,0 +1,12 @@
+configaroo/__init__.py,sha256=Sze_TJz5IEKL__tZO6D6fT6LPlaxYiHJQb6ghJRMePg,255
+configaroo/configuration.py,sha256=PJLWR2mA_bYM7iuRXqfBQ_rnZoughNCFA5kAEjjZz8A,7591
+configaroo/exceptions.py,sha256=1h-6hV7VqqKaRFnu539pjsO0ESSNDibt2kUeF7jAM2M,374
+configaroo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+configaroo/loaders/__init__.py,sha256=-6GAR4g7vYW7Zagq9Ev479kpkfY7kbvDl4JPXd4wQQ0,756
+configaroo/loaders/json.py,sha256=6gs_ZegUEe70vb6uSJfKBos7UjfuJnyWgPE_kjDQISw,258
+configaroo/loaders/toml.py,sha256=ZVbHutZ7V-Z_jf2aHjV18jwaqCXumlr06j48rojHcBM,264
+configaroo-0.1.2.dist-info/licenses/LICENSE,sha256=2cbzsB4lU8qOO8fO1XVNJD7XPxzPhaWXm6U9DenSc0s,1089
+configaroo-0.1.2.dist-info/METADATA,sha256=W0uyWmliw1ZgLfjEAVJI_Sp1SfCNQwFzLz7ph_pVSI8,1789
+configaroo-0.1.2.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
+configaroo-0.1.2.dist-info/top_level.txt,sha256=JVYICl1cWSjvSOZuZMYm976z9lnZaWtHVRSt373QCxg,11
+configaroo-0.1.2.dist-info/RECORD,,

configaroo-0.1.2.dist-info/licenses/LICENSE

@@ -0,0 +1,20 @@
+The MIT License (MIT)
+
+Copyright © 2025 Geir Arne Hjelle
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of
+this software and associated documentation files (the “Software”), to deal in
+the Software without restriction, including without limitation the rights to
+use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
+the Software, and to permit persons to whom the Software is furnished to do so,
+subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
+FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
+COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

configaroo-0.1.0.dist-info/METADATA

@@ -1,21 +0,0 @@
-Metadata-Version: 2.4
-Name: configaroo
-Version: 0.1.0
-Summary: Bouncy handling of configuration files
-Author-email: Geir Arne Hjelle <geirarne@gmail.com>
-Requires-Python: >=3.11
-Description-Content-Type: text/markdown
-Requires-Dist: pydantic>=2.0
-Requires-Dist: pyplugs>=0.4.0
-Requires-Dist: python-dotenv>=1.1.0
-
-# Configaroo - Bouncy Configuration Handling
-
-Configaroo is a light configuration package for Python that offers the following features:
-
-- Access configuration settings with dotted keys: `config.nested.key`
-- Use different configuration file formats, including TOML and JSON
-- Override key configuration settings with environment variables
-- Validate a configuration based on a Pydantic model
-- Convert the type of configuration values based on a Pydantic model
-- Dynamically format certain configuration values

configaroo-0.1.0.dist-info/RECORD

@@ -1,11 +0,0 @@
-configaroo/__init__.py,sha256=10BHeYLHiIz-oAGM1IdfaqBKyHbn2hiNnjS_zrFOtC8,232
-configaroo/configuration.py,sha256=V1Dx9LdkRlUSq46Djdq12sWb9JfNi_8N4VBnkXdB11s,5821
-configaroo/exceptions.py,sha256=1h-6hV7VqqKaRFnu539pjsO0ESSNDibt2kUeF7jAM2M,374
-configaroo/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-configaroo/loaders/__init__.py,sha256=-6GAR4g7vYW7Zagq9Ev479kpkfY7kbvDl4JPXd4wQQ0,756
-configaroo/loaders/json.py,sha256=6gs_ZegUEe70vb6uSJfKBos7UjfuJnyWgPE_kjDQISw,258
-configaroo/loaders/toml.py,sha256=ZVbHutZ7V-Z_jf2aHjV18jwaqCXumlr06j48rojHcBM,264
-configaroo-0.1.0.dist-info/METADATA,sha256=Oy67b4ut26KSC43oh5g50fpjR_Mz5chJ0iqvo4nrWIo,827
-configaroo-0.1.0.dist-info/WHEEL,sha256=zaaOINJESkSfm_4HQVc5ssNzHCPXhJm0kEUakpsEHaU,91
-configaroo-0.1.0.dist-info/top_level.txt,sha256=JVYICl1cWSjvSOZuZMYm976z9lnZaWtHVRSt373QCxg,11
-configaroo-0.1.0.dist-info/RECORD,,