python-cq 0.8.0__tar.gz → 0.9.1__tar.gz

{python_cq-0.8.0 → python_cq-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: python-cq
-Version: 0.8.0
+Version: 0.9.1
 Summary: Lightweight CQRS library for async Python projects.
 Project-URL: Repository, https://github.com/100nm/python-cq
 Author: remimd

{python_cq-0.8.0 → python_cq-0.9.1}/cq/__init__.py

@@ -1,3 +1,4 @@
+from ._core.defer import DeferredBus
 from ._core.dispatcher.bus import Bus
 from ._core.dispatcher.pipe import Pipe
 from ._core.message import (
@@ -25,6 +26,7 @@ __all__ = (
     "CQScope",
     "Command",
     "CommandBus",
+    "DeferredBus",
     "Event",
     "EventBus",
     "Middleware",

python_cq-0.9.1/cq/_core/defer.py

@@ -0,0 +1,10 @@
+from abc import abstractmethod
+from typing import Protocol
+
+
+class DeferredBus[I](Protocol):
+    __slots__ = ()
+
+    @abstractmethod
+    async def defer(self, input_value: I, /) -> None:
+        raise NotImplementedError

{python_cq-0.8.0 → python_cq-0.9.1}/cq/_core/handler.py

@@ -151,8 +151,8 @@ class HandlerDecorator[I, O]:
 
 
 def _resolve_input_type[I, O](handler_type: HandlerType[[I], O]) -> type[I]:
-    fake_handle_method = handler_type.handle.__get__(NotImplemented)
-    signature = inspect_signature(fake_handle_method, eval_str=True)
+    fake_method = handler_type.handle.__get__(NotImplemented, handler_type)
+    signature = inspect_signature(fake_method, eval_str=True)
 
     for parameter in signature.parameters.values():
         input_type = parameter.annotation

python_cq-0.9.1/cq/ext/fastapi.py

@@ -0,0 +1,44 @@
+from dataclasses import dataclass
+from typing import Annotated, Any
+
+from fastapi import BackgroundTasks, Depends
+from injection.ext.fastapi import Inject
+
+from cq import Bus, Command, CommandBus, DeferredBus, Event, EventBus, Query, QueryBus
+
+__all__ = ("DeferredCommandBus", "DeferredEventBus", "DeferredQueryBus")
+
+
+@dataclass(repr=False, eq=False, frozen=True, slots=True)
+class FastAPIDeferredBus[I](DeferredBus[I]):
+    background_tasks: BackgroundTasks
+    bus: Bus[I, Any]
+
+    async def defer(self, input_value: I, /) -> None:
+        self.background_tasks.add_task(self.bus.dispatch, input_value)
+
+
+async def new_deferred_command_bus[T](
+    background_tasks: BackgroundTasks,
+    command_bus: Inject[CommandBus[T]],
+) -> DeferredBus[Command]:
+    return FastAPIDeferredBus(background_tasks, command_bus)
+
+
+async def new_deferred_event_bus(
+    background_tasks: BackgroundTasks,
+    event_bus: Inject[EventBus],
+) -> DeferredBus[Event]:
+    return FastAPIDeferredBus(background_tasks, event_bus)
+
+
+async def new_deferred_query_bus[T](
+    background_tasks: BackgroundTasks,
+    query_bus: Inject[QueryBus[T]],
+) -> DeferredBus[Query]:
+    return FastAPIDeferredBus(background_tasks, query_bus)
+
+
+DeferredCommandBus = Annotated[DeferredBus[Command], Depends(new_deferred_command_bus)]
+DeferredEventBus = Annotated[DeferredBus[Event], Depends(new_deferred_event_bus)]
+DeferredQueryBus = Annotated[DeferredBus[Query], Depends(new_deferred_query_bus)]

python_cq-0.9.1/cq/ext/fastapi.pyi

@@ -0,0 +1,5 @@
+from cq import Command, DeferredBus, Event, Query
+
+type DeferredCommandBus = DeferredBus[Command]
+type DeferredEventBus = DeferredBus[Event]
+type DeferredQueryBus = DeferredBus[Query]

{python_cq-0.8.0 → python_cq-0.9.1}/pyproject.toml

@@ -14,6 +14,8 @@ example = [
     "pydantic",
 ]
 test = [
+    "fastapi",
+    "httpx",
     "pytest",
     "pytest-asyncio",
     "pytest-cov",
@@ -21,7 +23,7 @@ test = [
 
 [project]
 name = "python-cq"
-version = "0.8.0"
+version = "0.9.1"
 description = "Lightweight CQRS library for async Python projects."
 license = "MIT"
 license-files = ["LICENSE"]