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

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/_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
@@ -106,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:
@@ -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.0rc3.dist-info → engin-0.2.0a1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: engin
-Version: 0.1.0rc3
+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.0rc3.dist-info → engin-0.2.0a1.dist-info}/RECORD

@@ -1,13 +1,13 @@
 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/_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=nRz8GMFBJ5dAzMBO94HL_U1W2c89ZXg_LPeoD4H-s-4,4397
+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
@@ -20,8 +20,8 @@ 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.0rc3.dist-info/METADATA,sha256=T_BJ7UppMFU5rbi9xCRaqBIrSUvoQChxBF3bVsDGVrM,3951
-engin-0.1.0rc3.dist-info/WHEEL,sha256=qtCwoSJWgHk21S1Kb4ihdzI2rlJ1ZKaIurTj_ngOhyQ,87
-engin-0.1.0rc3.dist-info/entry_points.txt,sha256=sW247zZUMxm0b5UKYvPuqQQljYDtU-j2zK3cu7gHwM0,41
-engin-0.1.0rc3.dist-info/licenses/LICENSE,sha256=XHh5LPUPKZWTBqBv2xxN2RU7D59nHoiJGb5RIt8f45w,1070
-engin-0.1.0rc3.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,,