austial-testing 0.1.5__py3-none-any.whl

austial/testing/__init__.py

@@ -0,0 +1,3 @@
+from austial.testing.testing_module import Test, TestingModule, TestingModuleBuilder
+
+__all__ = ["Test", "TestingModule", "TestingModuleBuilder"]

austial/testing/testing_module.py

@@ -0,0 +1,64 @@
+"""``Test.create_testing_module(...).compile()`` -- mirrors ``@nestjs/testing``."""
+
+from __future__ import annotations
+
+from collections.abc import Sequence
+from typing import Any
+
+from fastapi import FastAPI
+
+from austial.common.decorators.modules import Module
+from austial.core.app import AustialApplication
+from austial.core.container import Container
+from austial.core.module_scanner import scan_module
+
+
+class TestingModule:
+    def __init__(self, container: Container, controllers: list):
+        self._container = container
+        self._controllers = controllers
+
+    def get(self, token: Any) -> Any:
+        """Fetches a resolved provider straight out of the DI container --
+        the whole point of testing modules: unit-test a service with its real
+        dependency graph, no manual mocking wiring required."""
+        return self._container.resolve(token)
+
+    def create_austial_application(self) -> AustialApplication:
+        """Mirrors ``moduleRef.createNestApplication()``. Call ``await app.init()``
+        before making requests against it."""
+        fastapi_app = FastAPI(title="Austial (test)")
+        return AustialApplication(self._container, fastapi_app, self._controllers, [])
+
+
+class TestingModuleBuilder:
+    def __init__(
+        self,
+        *,
+        imports: Sequence[Any] = (),
+        controllers: Sequence[type] = (),
+        providers: Sequence[Any] = (),
+    ):
+        @Module(imports=list(imports), controllers=list(controllers), providers=list(providers))
+        class _TestingRootModule:
+            pass
+
+        self._root_module = _TestingRootModule
+
+    async def compile(self) -> TestingModule:
+        container = Container()
+        scan_result = scan_module(self._root_module, container)
+        return TestingModule(container, scan_result.controllers)
+
+
+class Test:
+    """Entry point, mirrors Nest's ``Test.createTestingModule({...})``."""
+
+    @staticmethod
+    def create_testing_module(
+        *,
+        imports: Sequence[Any] = (),
+        controllers: Sequence[type] = (),
+        providers: Sequence[Any] = (),
+    ) -> TestingModuleBuilder:
+        return TestingModuleBuilder(imports=imports, controllers=controllers, providers=providers)

austial_testing-0.1.5.dist-info/METADATA

@@ -0,0 +1,8 @@
+Metadata-Version: 2.4
+Name: austial-testing
+Version: 0.1.5
+Summary: TestingModule builder for overriding providers in unit/e2e tests -- mirrors @nestjs/testing.
+Requires-Python: >=3.11
+Requires-Dist: austial-common
+Requires-Dist: austial-core
+Requires-Dist: fastapi>=0.115.0

austial_testing-0.1.5.dist-info/RECORD

@@ -0,0 +1,5 @@
+austial/testing/__init__.py,sha256=nvnEOYST0Umvi6o-pvru0bZmD3dL8N_CekTKr8BWuKU,146
+austial/testing/testing_module.py,sha256=nJMaVpnsgUGaQn-1xut4f0AIamDscODPw3e1EQBwxlA,2211
+austial_testing-0.1.5.dist-info/METADATA,sha256=UB_pGSzLdZW4GZiDxSrRWH-I957i-t9cziRc3YGZkyA,275
+austial_testing-0.1.5.dist-info/WHEEL,sha256=lCkmxWfQsSc9CfIClYeavTdQeEX2toPqufh9gI35EQA,87
+austial_testing-0.1.5.dist-info/RECORD,,

austial_testing-0.1.5.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.31.0
+Root-Is-Purelib: true
+Tag: py3-none-any