stdlibx-config 0.1.0__tar.gz

stdlibx_config-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Lucino772
+
+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.

stdlibx_config-0.1.0/PKG-INFO

@@ -0,0 +1,26 @@
+Metadata-Version: 2.4
+Name: stdlibx-config
+Version: 0.1.0
+Summary: stdlibx-config
+Author: Lucino772
+License-Expression: MIT
+License-File: LICENSE
+Requires-Dist: ruamel-yaml>=0.18.16 ; extra == 'yaml'
+Requires-Python: >=3.9
+Project-URL: Documentation, http://stdlibx.lucapalmi.com/
+Project-URL: Repository, https://github.com/Lucino772/stdlibx
+Provides-Extra: yaml
+Description-Content-Type: text/markdown
+
+[![docs](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml/badge.svg?branch=main)](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml)
+
+# stdlibx
+**stdlibx** is a collection of small, focused Python utilities that simplify common programming patterns and help you write clearer, more composable code.
+
+It provides practical tools for handling optional values, explicit error management, cancellation, composition, configuration, pattern matching, and reactive flows.
+
+## Documentation
+Checkout the [documentation](http://stdlibx.lucapalmi.com/)
+
+## Licence
+This project uses a **MIT** Licence [view](https://github.com/Lucino772/stdlibx/blob/main/LICENSE)

stdlibx_config-0.1.0/README.md

@@ -0,0 +1,12 @@
+[![docs](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml/badge.svg?branch=main)](https://github.com/Lucino772/stdlibx/actions/workflows/deploy-docs.yaml)
+
+# stdlibx
+**stdlibx** is a collection of small, focused Python utilities that simplify common programming patterns and help you write clearer, more composable code.
+
+It provides practical tools for handling optional values, explicit error management, cancellation, composition, configuration, pattern matching, and reactive flows.
+
+## Documentation
+Checkout the [documentation](http://stdlibx.lucapalmi.com/)
+
+## Licence
+This project uses a **MIT** Licence [view](https://github.com/Lucino772/stdlibx/blob/main/LICENSE)

stdlibx_config-0.1.0/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "stdlibx-config"
+version = "0.1.0"
+description = "stdlibx-config"
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+readme = "README.md"
+authors = [
+    { name = "Lucino772" }
+]
+requires-python = ">=3.9"
+dependencies = []
+
+[project.optional-dependencies]
+yaml = [
+    "ruamel-yaml>=0.18.16",
+]
+
+[project.urls]
+Documentation = "http://stdlibx.lucapalmi.com/"
+Repository = "https://github.com/Lucino772/stdlibx"
+
+[tool.uv.build-backend]
+module-name = "stdlibx.config"
+
+[build-system]
+requires = ["uv_build>=0.9.28,<0.10.0"]
+build-backend = "uv_build"

stdlibx_config-0.1.0/src/stdlibx/config/__init__.py

@@ -0,0 +1,14 @@
+from stdlibx.config._lib import load_config
+from stdlibx.config._types import Loader
+from stdlibx.config.loaders.env import EnvLoader
+from stdlibx.config.loaders.file import FileLoader
+from stdlibx.config.loaders.json import JsonLoader
+
+__all__ = ["EnvLoader", "FileLoader", "JsonLoader", "Loader", "load_config"]
+
+try:
+    from stdlibx.config.loaders.yaml import YamlLoader
+
+    __all__ += ["YamlLoader"]
+except ImportError:
+    pass

stdlibx_config-0.1.0/src/stdlibx/config/_lib.py

@@ -0,0 +1,31 @@
+from __future__ import annotations
+
+from typing import (
+    TYPE_CHECKING,
+    Any,
+    Callable,
+    Mapping,
+    Protocol,
+    TypeVar,
+    runtime_checkable,
+)
+
+if TYPE_CHECKING:
+    from stdlibx.config._types import Loader
+
+T = TypeVar("T", covariant=True)
+
+
+@runtime_checkable
+class _PydanticValidator(Protocol[T]):
+    def model_validate(self, obj: Any, *, from_attributes: bool) -> T: ...
+
+
+def load_config(
+    validator: _PydanticValidator[T] | Callable[[Mapping[str, Any]], T],
+    loaders: list[Loader],
+) -> T:
+    _ret = {key: val for loader in loaders for key, val in loader.load().items()}
+    if isinstance(validator, _PydanticValidator):
+        return validator.model_validate(_ret, from_attributes=False)
+    return validator(_ret)

stdlibx_config-0.1.0/src/stdlibx/config/_types.py

@@ -0,0 +1,12 @@
+from collections.abc import Mapping
+from typing import Any, Protocol, TypeVar
+
+T = TypeVar("T", covariant=True)
+
+
+class Loader(Protocol):
+    def load(self) -> Mapping[str, Any]: ...
+
+
+class SupportsRead(Protocol[T]):
+    def read(self, length: int = ..., /) -> T: ...

stdlibx_config-0.1.0/src/stdlibx/config/loaders/env.py

@@ -0,0 +1,39 @@
+from __future__ import annotations
+
+import os
+from typing import Any, Mapping
+
+
+class EnvLoader:
+    def __init__(
+        self,
+        environ: Mapping[str, str] | None = None,
+        env_prefix: str = "STDLIBX_",
+        env_nested_delimiter: str = "__",
+    ) -> None:
+        self.__environ = environ
+        self.__env_prefix = env_prefix
+        self.__env_nested_delimiter = env_nested_delimiter
+
+    def load(self) -> Mapping[str, Any]:
+        _environ = self.__environ or os.environ
+
+        _ret = {}
+        for key, value in (
+            (key.upper().strip(self.__env_prefix + "_").lower(), value)
+            for key, value in _environ.items()
+            if key.upper().startswith(self.__env_prefix)
+        ):
+            if self.__env_nested_delimiter not in key:
+                _ret[key] = value
+            else:
+                keys = key.split(self.__env_nested_delimiter)
+
+                _value = _ret
+                for _key in keys[:-1]:
+                    if _key not in _value:
+                        _value[_key] = {}
+                    _value = _value[_key]
+                _value[keys[-1]] = value
+
+        return _ret

stdlibx_config-0.1.0/src/stdlibx/config/loaders/file.py

@@ -0,0 +1,29 @@
+from __future__ import annotations
+
+from pathlib import Path
+from typing import TYPE_CHECKING, Any, Callable, Mapping
+
+if TYPE_CHECKING:
+    from os import PathLike
+
+    from stdlibx.config._types import SupportsRead
+
+
+class FileLoader:
+    def __init__(
+        self,
+        path: str | PathLike[str],
+        parser: Callable[[SupportsRead[bytes]], Mapping[str, Any]],
+        *,
+        missing_ok: bool = False,
+    ) -> None:
+        self.__path = Path(path)
+        self.__missing_ok = missing_ok
+        self.__parser = parser
+
+    def load(self) -> Mapping[str, Any]:
+        if self.__missing_ok is True and self.__path.exists() is False:
+            return {}
+
+        with open(self.__path, "rb") as fp:
+            return self.__parser(fp)

stdlibx_config-0.1.0/src/stdlibx/config/loaders/json.py

@@ -0,0 +1,14 @@
+from __future__ import annotations
+
+import json
+from typing import TYPE_CHECKING
+
+from stdlibx.config.loaders.file import FileLoader
+
+if TYPE_CHECKING:
+    from os import PathLike
+
+
+class JsonLoader(FileLoader):
+    def __init__(self, path: str | PathLike[str], *, missing_ok: bool = False) -> None:
+        super().__init__(path, json.load, missing_ok=missing_ok)

stdlibx_config-0.1.0/src/stdlibx/config/loaders/yaml.py

@@ -0,0 +1,23 @@
+from __future__ import annotations
+
+from typing import TYPE_CHECKING, Literal
+
+from ruamel.yaml import YAML
+from stdlibx.config.loaders.file import FileLoader
+
+if TYPE_CHECKING:
+    from os import PathLike
+
+
+class YamlLoader(FileLoader):
+    def __init__(
+        self,
+        path: str | PathLike[str],
+        *,
+        missing_ok: bool = False,
+        yaml_typ: Literal["rt", "safe", "unsafe", "full", "base"] | None = None,
+        yaml_pure: bool = False,
+    ) -> None:
+        super().__init__(
+            path, YAML(typ=yaml_typ, pure=yaml_pure).load, missing_ok=missing_ok
+        )