austial-config 0.1.5__tar.gz

austial_config-0.1.5/.gitignore

@@ -0,0 +1,11 @@
+__pycache__/
+*.py[cod]
+.venv/
+.env
+*.db
+.pytest_cache/
+.coverage
+htmlcov/
+dist/
+build/
+*.egg-info/

austial_config-0.1.5/PKG-INFO

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: austial-config
+Version: 0.1.5
+Summary: ConfigModule/ConfigService for .env-backed configuration -- mirrors @nestjs/config (no main-monorepo equivalent).
+Requires-Python: >=3.11
+Requires-Dist: austial-common
+Requires-Dist: austial-core
+Requires-Dist: pydantic-settings>=2.4.0

austial_config-0.1.5/pyproject.toml

@@ -0,0 +1,27 @@
+[project]
+name = "austial-config"
+dynamic = ["version"]
+description = "ConfigModule/ConfigService for .env-backed configuration -- mirrors @nestjs/config (no main-monorepo equivalent)."
+requires-python = ">=3.11"
+dependencies = [
+    "austial-common",
+    "austial-core",
+    "pydantic-settings>=2.4.0",
+]
+
+[build-system]
+requires = ["hatchling", "hatch-vcs"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/austial"]
+
+[tool.uv.sources]
+austial-common = { workspace = true }
+austial-core = { workspace = true }
+
+[tool.hatch.version]
+source = "vcs"
+
+[tool.hatch.version.raw-options]
+root = "../.."

austial_config-0.1.5/src/austial/config/__init__.py

@@ -0,0 +1,4 @@
+from austial.config.config_module import ConfigModule
+from austial.config.config_service import ConfigService
+
+__all__ = ["ConfigModule", "ConfigService"]

austial_config-0.1.5/src/austial/config/config_module.py

@@ -0,0 +1,31 @@
+"""``ConfigModule`` -- mirrors ``@nestjs/config``'s ``ConfigModule.forRoot()``."""
+
+from __future__ import annotations
+
+import os
+
+from austial.common.decorators.modules import Module
+from austial.config.config_service import ConfigService
+from austial.core.dynamic_module import DynamicModule
+
+
+@Module()
+class ConfigModule:
+    """Import via ``ConfigModule.for_root()`` in ``AppModule``'s ``imports=[...]``,
+    exactly like Nest's ``ConfigModule.forRoot()``."""
+
+    @staticmethod
+    def for_root(env_file: str = ".env", *, is_global: bool = True) -> DynamicModule:
+        try:
+            from dotenv import load_dotenv
+
+            load_dotenv(env_file, override=False)
+        except ImportError:  # pragma: no cover - python-dotenv ships with pydantic-settings
+            pass
+
+        service = ConfigService(dict(os.environ))
+        return DynamicModule(
+            module=ConfigModule,
+            providers=[{"provide": ConfigService, "useValue": service}],
+            exports=[ConfigService],
+        )

austial_config-0.1.5/src/austial/config/config_service.py

@@ -0,0 +1,22 @@
+"""``ConfigService`` -- mirrors ``@nestjs/config``'s ``ConfigService``."""
+
+from __future__ import annotations
+
+import os
+from typing import Any
+
+from austial.common.decorators.injectable import Injectable
+
+
+@Injectable()
+class ConfigService:
+    def __init__(self, env: dict | None = None):
+        self._env = env if env is not None else dict(os.environ)
+
+    def get(self, key: str, default: Any = None) -> Any:
+        return self._env.get(key, default)
+
+    def get_or_throw(self, key: str) -> Any:
+        if key not in self._env:
+            raise KeyError(f"Configuration key '{key}' is not defined")
+        return self._env[key]