engin 0.1.0rc2__py3-none-any.whl → 0.2.0a1__py3-none-any.whl

engin/_cli/_check.py

@@ -50,13 +50,6 @@ def check_dependencies(
         for missing_type in sorted_missing:
             console.print(f"  • {missing_type}", style="red")
 
-        available_providers = sorted(
-            str(provider.return_type_id) for provider in assembler.providers
-        )
-        console.print("\nAvailable providers:", style="yellow")
-        for available_type in available_providers:
-            console.print(f"  • {available_type}", style="yellow")
-
         raise typer.Exit(code=1)
     else:
         console.print("✅ All dependencies are satisfied!", style="green bold")

engin/_cli/_graph.html

@@ -400,7 +400,7 @@
         }
 
         if (node.style_classes && node.style_classes.length > 0) {
-            styleClasses = `:::${node.style_classes.join(' ')}`;
+            styleClasses = `:::${node.style_classes.join(',')}`;
         }
 
         return shape + styleClasses;

engin/_dependency.py

@@ -171,6 +171,9 @@ class Provide(Dependency[Any, T]):
             override: (optional) allow this provider to override other providers for the
                 same type from the same package.
         """
+        if not callable(factory):
+            msg = "Provided value is not callable, did you mean to use Supply instead?"
+            raise ValueError(msg)
         super().__init__(func=factory)
         self._scope = scope
         self._override = override

engin/_engin.py

@@ -179,7 +179,9 @@ class Engin:
             try:
                 async with supervisor:
                     await self._stop_requested_event.wait()
-                    await self._shutdown()
+
+                # shutdown after stopping supervised tasks
+                await self._shutdown()
             except BaseException:
                 await self._shutdown()
 
@@ -262,6 +264,7 @@ async def _stop_engin_on_signal(stop_requested_event: Event) -> None:
 
         # windows does not support signal_handlers, so this is the workaround
         def ctrlc_handler(sig: int, frame: FrameType | None) -> None:
+            LOG.debug(f"received {signal.SIGINT.name} signal")
             nonlocal should_stop
             if should_stop:
                 raise KeyboardInterrupt("Forced keyboard interrupt")

engin/_supervisor.py

@@ -15,7 +15,7 @@ if typing.TYPE_CHECKING:
 
 LOG = logging.getLogger("engin")
 
-TaskFactory: TypeAlias = Callable[[], Awaitable[None]]
+AsyncFunction: TypeAlias = Callable[[], Awaitable[None]]
 
 
 class OnException(Enum):
@@ -41,15 +41,16 @@ class _SupervisorTask:
     """
     Attributes:
         - factory: a coroutine function that can create the task.
-        - on_exception: determines the behaviour when task raises an exception.
+        - on_exception: determines the behaviour when the task raises an exception.
         - complete: will be set to true if task stops for any reason except cancellation.
         - last_exception: the last exception raised by the task.
     """
 
-    factory: TaskFactory
+    factory: AsyncFunction
     on_exception: OnException
     complete: bool = False
     last_exception: Exception | None = None
+    shutdown_hook: AsyncFunction | None = None
 
     async def __call__(self) -> None:
         # loop to allow for restarting erroring tasks
@@ -63,7 +64,6 @@ class _SupervisorTask:
                 raise
             except Exception as err:
                 self.last_exception = err
-
                 if self.on_exception == OnException.IGNORE:
                     LOG.warning(
                         f"supervisor task '{self.name}' raised {type(err).__name__} "
@@ -107,9 +107,17 @@ class Supervisor:
         self._task_group: TaskGroup | None = None
 
     def supervise(
-        self, func: TaskFactory, *, on_exception: OnException = OnException.SHUTDOWN
+        self,
+        func: AsyncFunction,
+        *,
+        on_exception: OnException = OnException.SHUTDOWN,
+        shutdown_hook: AsyncFunction | None = None,
     ) -> None:
-        self._tasks.append(_SupervisorTask(factory=func, on_exception=on_exception))
+        self._tasks.append(
+            _SupervisorTask(
+                factory=func, on_exception=on_exception, shutdown_hook=shutdown_hook
+            )
+        )
 
     @property
     def empty(self) -> bool:
@@ -122,6 +130,7 @@ class Supervisor:
         self._task_group = await anyio.create_task_group().__aenter__()
 
         for task in self._tasks:
+            LOG.info(f"supervising task: {task.name}")
             self._task_group.start_soon(task, name=task.name)
 
     async def __aexit__(
@@ -132,6 +141,10 @@ class Supervisor:
         /,
     ) -> None:
         if self._task_group:
+            for task in self._tasks:
+                if task.shutdown_hook is not None:
+                    LOG.debug(f"supervised task shutdown hook: {task.name}")
+                    await task.shutdown_hook()
             if not self._task_group.cancel_scope.cancel_called:
                 self._task_group.cancel_scope.cancel()
             await self._task_group.__aexit__(exc_type, exc_value, traceback)

{engin-0.1.0rc2.dist-info → engin-0.2.0a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: engin
-Version: 0.1.0rc2
+Version: 0.2.0a1
 Summary: An async-first modular application framework
 Project-URL: Homepage, https://github.com/invokermain/engin
 Project-URL: Documentation, https://engin.readthedocs.io/en/latest/
@@ -39,7 +39,7 @@ The Engin framework gives you:
 
 - A fully-featured dependency injection system.
 - A robust application runtime with lifecycle hooks and supervised background tasks.
-- Zero boiler-plate code reuse across applications.
+- Zero boilerplate code reuse across applications.
 - Integrations for other frameworks such as FastAPI.
 - Full async support.
 - CLI commands to aid local development.

{engin-0.1.0rc2.dist-info → engin-0.2.0a1.dist-info}/RECORD

@@ -1,27 +1,27 @@
 engin/__init__.py,sha256=O0vS570kZFBq7Kwy4FgeJFIhfo4aIg5mv_Z_9vAQRio,577
 engin/_assembler.py,sha256=0uXgtcO5M3EHg0I-TQK9y7LOzfxkLFmKia-zLyVHaxA,11178
 engin/_block.py,sha256=IacP4PoJKRhSQCbQSdoyCtmu362a4vj6qoUQKyaJwzI,3062
-engin/_dependency.py,sha256=xINk3sudxzsTmkUkNAKQwzBc0G0DfhpnrZli4z3ALBY,9459
-engin/_engin.py,sha256=oGaf_iedMNKxl3rbADpPzIvNtTx1Pfs-6o0e8yRrmHk,9532
+engin/_dependency.py,sha256=Ie-z0obe7Ut6TF1O7BjP3Z7i216ufKqSeT_D82krdAc,9615
+engin/_engin.py,sha256=1bgZmdmRlwHIZ9pz5rysYgvFu5s8e0gzlc9iq-Of97c,9651
 engin/_graph.py,sha256=y1g7Lm_Zy5GPEgRsggCKV5DDaDzcwUl8v3IZCK8jyGI,1631
 engin/_introspect.py,sha256=VdREX6Lhhga5SnEP9G7mjHkgJR4mpqk_SMnmL2zTcqY,966
 engin/_lifecycle.py,sha256=cSWe3euZkmpxmUPFvph2lsTtvuZbxttEfBL-RnOI7lo,5325
 engin/_option.py,sha256=nZcdrehp1QwgxMUoIpsM0PJuu1q1pbXzhcVsetbsHpc,223
-engin/_supervisor.py,sha256=HI0D4StqSJZE2l6x7RtouRLKWx1HOhUmLHqu8pUcWbQ,4343
+engin/_supervisor.py,sha256=WGio-mfPHo2Wdfqo5ZB66WAoAU2ey0urwM0Dl4vRUTA,4824
 engin/_type_utils.py,sha256=H3Tl-kJr2wY2RhaTXP9GrMqa2RsXMijHbjHKe1AxGmc,2276
 engin/exceptions.py,sha256=lSMOJI4Yl-VIM0yDzFWbPhC0mQm4f0WvGULr9SldIaY,2353
 engin/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 engin/_cli/__init__.py,sha256=Ixk3NoZeIN8Bj53I625uqJdLyyT9Gpbe_4GtNy-KQwM,636
-engin/_cli/_check.py,sha256=YA37Gi4rimKIH-XMs7SEAFkSRNBIMG8OCKfF3W1V3-g,1976
+engin/_cli/_check.py,sha256=w9GA9RmCgSflvSU7EQqXKiOCqgrZB-pLS_UoJOqV56E,1666
 engin/_cli/_common.py,sha256=6tyjxAkROCViw0LOFdx-X1U-iSXKyeW5CoE9UxWRybI,3282
-engin/_cli/_graph.html,sha256=YIv34LR00aWsWgjNrqO4XBNu4frPo_y-i1CijaZyySo,29073
+engin/_cli/_graph.html,sha256=5Dw5eyhsrU8KrpdhGn1mxo5kTUTJLMSzT-MBKvSv13g,29073
 engin/_cli/_graph.py,sha256=MsxsNpL1v0v1AUT57ZS97l1diwacqRaPdVBObHHIGJE,6753
 engin/_cli/_inspect.py,sha256=_uzldpHA51IX4srpUGzL4lZNiepqucsO9M3Zo83XBBM,3159
 engin/extensions/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 engin/extensions/asgi.py,sha256=7vQFaVs1jxq1KbhHGN8k7x2UFab6SPUq2_hXfX6HiXU,3329
 engin/extensions/fastapi.py,sha256=7N6i-eZUEZRPo7kcvjS7kbRSY5QAPyKJXSeongSQ-OA,6371
-engin-0.1.0rc2.dist-info/METADATA,sha256=I7BtKglKAs30NQ6n73p3gzLhZhxcvsIZXuuM356Ipa4,3951
-engin-0.1.0rc2.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-engin-0.1.0rc2.dist-info/entry_points.txt,sha256=sW247zZUMxm0b5UKYvPuqQQljYDtU-j2zK3cu7gHwM0,41
-engin-0.1.0rc2.dist-info/licenses/LICENSE,sha256=XHh5LPUPKZWTBqBv2xxN2RU7D59nHoiJGb5RIt8f45w,1070
-engin-0.1.0rc2.dist-info/RECORD,,
+engin-0.2.0a1.dist-info/METADATA,sha256=OntxY2pdrpJuvpqb-zvj2SJwpohHmEjbjLmqc7w1zqE,3949
+engin-0.2.0a1.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
+engin-0.2.0a1.dist-info/entry_points.txt,sha256=sW247zZUMxm0b5UKYvPuqQQljYDtU-j2zK3cu7gHwM0,41
+engin-0.2.0a1.dist-info/licenses/LICENSE,sha256=XHh5LPUPKZWTBqBv2xxN2RU7D59nHoiJGb5RIt8f45w,1070
+engin-0.2.0a1.dist-info/RECORD,,