austial-orm 0.1.5__tar.gz

austial_orm-0.1.5/.gitignore

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

austial_orm-0.1.5/PKG-INFO

@@ -0,0 +1,9 @@
+Metadata-Version: 2.4
+Name: austial-orm
+Version: 0.1.5
+Summary: DatabaseModule wrapping SQLAlchemy's async engine/session -- mirrors @nestjs/typeorm (no main-monorepo equivalent).
+Requires-Python: >=3.11
+Requires-Dist: aiosqlite>=0.20.0
+Requires-Dist: austial-common
+Requires-Dist: austial-core
+Requires-Dist: sqlalchemy>=2.0.30

austial_orm-0.1.5/pyproject.toml

@@ -0,0 +1,28 @@
+[project]
+name = "austial-orm"
+dynamic = ["version"]
+description = "DatabaseModule wrapping SQLAlchemy's async engine/session -- mirrors @nestjs/typeorm (no main-monorepo equivalent)."
+requires-python = ">=3.11"
+dependencies = [
+    "austial-common",
+    "austial-core",
+    "sqlalchemy>=2.0.30",
+    "aiosqlite>=0.20.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_orm-0.1.5/src/austial/orm/__init__.py

@@ -0,0 +1,3 @@
+from austial.orm.database_module import DATABASE_ENGINE, DATABASE_SESSION_FACTORY, DatabaseModule
+
+__all__ = ["DATABASE_ENGINE", "DATABASE_SESSION_FACTORY", "DatabaseModule"]

austial_orm-0.1.5/src/austial/orm/database_module.py

@@ -0,0 +1,61 @@
+"""``DatabaseModule`` -- mirrors ``@nestjs/typeorm``'s ``TypeOrmModule.forRoot[Async]()``.
+
+Backed by SQLAlchemy's async engine; defaults to a local sqlite file so a
+freshly generated project works with zero external services.
+"""
+
+from __future__ import annotations
+
+from collections.abc import Callable, Sequence
+from typing import Any
+
+from sqlalchemy.ext.asyncio import async_sessionmaker, create_async_engine
+
+from austial.common.decorators.modules import Module
+from austial.core.dynamic_module import DynamicModule
+
+DATABASE_ENGINE = "DATABASE_ENGINE"
+DATABASE_SESSION_FACTORY = "DATABASE_SESSION_FACTORY"
+
+
+@Module()
+class DatabaseModule:
+    """Import via ``DatabaseModule.for_root(url=...)`` or
+    ``DatabaseModule.for_root_async(use_factory=..., inject=[ConfigService])``,
+    mirroring Nest's TypeORM dynamic-module conventions. Exposes two tokens
+    other providers can ``Inject(...)``: ``DATABASE_ENGINE`` and
+    ``DATABASE_SESSION_FACTORY``."""
+
+    @staticmethod
+    def for_root(url: str = "sqlite+aiosqlite:///./austial.db", **engine_kwargs: Any) -> DynamicModule:
+        engine = create_async_engine(url, **engine_kwargs)
+        session_factory = async_sessionmaker(engine, expire_on_commit=False)
+        return DynamicModule(
+            module=DatabaseModule,
+            providers=[
+                {"provide": DATABASE_ENGINE, "useValue": engine},
+                {"provide": DATABASE_SESSION_FACTORY, "useValue": session_factory},
+            ],
+            exports=[DATABASE_ENGINE, DATABASE_SESSION_FACTORY],
+        )
+
+    @staticmethod
+    def for_root_async(*, use_factory: Callable[..., str], inject: Sequence[Any] = ()) -> DynamicModule:
+        def _build_engine(*deps: Any):
+            return create_async_engine(use_factory(*deps))
+
+        def _build_session_factory(engine: Any):
+            return async_sessionmaker(engine, expire_on_commit=False)
+
+        return DynamicModule(
+            module=DatabaseModule,
+            providers=[
+                {"provide": DATABASE_ENGINE, "useFactory": _build_engine, "inject": list(inject)},
+                {
+                    "provide": DATABASE_SESSION_FACTORY,
+                    "useFactory": _build_session_factory,
+                    "inject": [DATABASE_ENGINE],
+                },
+            ],
+            exports=[DATABASE_ENGINE, DATABASE_SESSION_FACTORY],
+        )