python-cq 0.25.0__py3-none-any.whl → 0.25.2__py3-none-any.whl

cq/_core/middleware.py

@@ -71,11 +71,13 @@ def resolve_handler_source[**P, T](
     | HandleFunction[P, T],
     /,
 ) -> HandlerType[P, T] | Any:
-    while True:
-        try:
-            call_next = call_next.call_next  # type: ignore[union-attr]
-        except AttributeError:
-            return call_next.source  # type: ignore[union-attr]
+    while isinstance(call_next, _BoundMiddleware):
+        call_next = call_next.call_next
+
+    if isinstance(call_next, HandleFunction):
+        return call_next.source
+
+    return call_next
 
 
 @dataclass(repr=False, eq=False, frozen=True, slots=True)

cq/_core/related_events.py

@@ -25,7 +25,7 @@ class AnyIORelatedEvents(RelatedEvents):
     task_group: TaskGroup = field(default_factory=create_task_group)
     history: list[Event] = field(default_factory=list, init=False)
 
-    def __bool__(self) -> bool:  # pragma: no cover
+    def __bool__(self) -> bool:
         return bool(self.history)
 
     async def __aenter__(self) -> Self:

cq/middlewares/retry.py

@@ -21,6 +21,9 @@ class RetryMiddleware:
         delay: float = 0,
         exceptions: Sequence[type[BaseException]] = (Exception,),
     ) -> None:
+        if retry < 1:
+            raise ValueError(f"`retry` must be at least 1, got {retry}.")
+
         self.__delay = delay
         self.__exceptions = tuple(exceptions)
         self.__retry = retry

{python_cq-0.25.0.dist-info → python_cq-0.25.2.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-cq
-Version: 0.25.0
+Version: 0.25.2
 Summary: CQRS library for async Python projects.
 Project-URL: Documentation, https://python-cq.remimd.dev
 Project-URL: Repository, https://github.com/100nm/python-cq
@@ -32,10 +32,17 @@ Description-Content-Type: text/markdown
 
 # python-cq
 
-[![PyPI - Version](https://img.shields.io/pypi/v/python-cq.svg?color=4051b5&style=for-the-badge)](https://pypi.org/project/python-cq)
-[![PyPI - Downloads](https://img.shields.io/pypi/dm/python-cq.svg?color=4051b5&style=for-the-badge)](https://pypistats.org/packages/python-cq)
+[![PyPI - Version](https://shieldcn.dev/pypi/v/python-cq.svg?variant=secondary)](https://pypi.org/project/python-cq)
+[![PyPI - Downloads](https://shieldcn.dev/pypi/dm/python-cq.svg?variant=secondary)](https://pypistats.org/packages/python-cq)
 
-**python-cq** is an async-first Python library for organizing code around CQRS. It separates reads (queries), writes (commands), and notifications (events) into dedicated message buses, and lets you plug in any dependency injection framework behind a small protocol.
+**python-cq** is an async-first Python library for organizing code around CQRS. It routes commands, queries, and events to their handlers through dedicated buses, and lets you put a queue in front of any of them when a message should be processed later. Dependency injection is pluggable behind a small protocol.
+
+The library is made of two independent parts:
+
+* **Routing**: messages, handlers, buses, middlewares, and command pipelines. This is the core of the library and what most applications need.
+* **Queuing**: a `Queue` protocol and a `Pump` that drains a queue into any async callable, typically a bus.
+
+You can use routing without ever touching queuing, and the queuing primitives work with any dispatcher, not only the buses of this library.
 
 ## What is CQRS?
 
@@ -49,13 +56,13 @@ CQRS is often discussed alongside distributed systems and Event Sourcing, but th
 
 ## Three message types
 
-| Type      | Intent                                | Handlers              | Returns                  |
-|-----------|---------------------------------------|-----------------------|--------------------------|
-| `Command` | Change the state of the system        | Exactly one           | The handler's return value |
-| `Query`   | Read state without side effects       | Exactly one           | The handler's return value |
-| `Event`   | Notify that something has happened    | Zero, one, or many    | Nothing                  |
+| Type      | Intent                             | Handlers           | Returns                    |
+|-----------|------------------------------------|--------------------|----------------------------|
+| `Command` | Change the state of the system     | Exactly one        | The handler's return value |
+| `Query`   | Read state without side effects    | Exactly one        | The handler's return value |
+| `Event`   | Notify that something has happened | Zero, one, or many | Nothing                    |
 
-A `Command` is allowed to return a value (for convenience, typically an id or a result object), but that does not mean it should be used as a query. Keep intent clear.
+A `Command` is allowed to return a value (for convenience, typically an id or a result object), but that does not make it a query. Keep intent clear.
 
 ## Installation
 
@@ -67,7 +74,7 @@ With the default DI backend ([python-injection](https://github.com/100nm/python-
 pip install "python-cq[injection]"
 ```
 
-Without dependency injection (you will need to implement a `DIAdapter`):
+Without dependency injection (you will need to implement a `DIAdapter` to inject anything into your handlers):
 
 ```bash
 pip install python-cq
@@ -105,7 +112,7 @@ async def main(bus: CommandBus[int]) -> None:
 asyncio.run(main())
 ```
 
-The decorator registers the handler against the type of its first `handle` parameter. The bus is resolved by the DI container and dispatched to that handler.
+The decorator registers the handler against the type annotation of the first `handle` parameter. The bus is resolved by the DI container and forwards the command to that handler.
 
 ## Prerequisites
 

{python_cq-0.25.0.dist-info → python_cq-0.25.2.dist-info}/RECORD

@@ -3,8 +3,8 @@ cq/exceptions.py,sha256=lmIpWDbPPwdS9bAAKxUvampA1KKmB706wWaB2mKZyPc,111
 cq/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cq/_core/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cq/_core/message.py,sha256=uyFgiFCm3kVhWFzJ2gBtWNub_cgfCdyXXSJirBW05OQ,286
-cq/_core/middleware.py,sha256=EKrAXCbDEZmGn9JTGpL06Nd0DflTTFbDB1Z7Ja3CqmI,3710
-cq/_core/related_events.py,sha256=vPltQdmQjnfb3eOB2lO6dxqjJEsGOjOyCNj7_2ehNAk,1389
+cq/_core/middleware.py,sha256=cckYp7gTsCFH76-DnT2yOTv8QPYH2IlGWtpmDuDcupo,3706
+cq/_core/related_events.py,sha256=msJ0J-ydtxJ5My8qPLhMIFuCCvzbB_WBDD0CTwOEC-0,1369
 cq/_core/common/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cq/_core/common/typing.py,sha256=xtXsqzyATZ0LTVfjB-J4sB6dPKHKrpXqd1bZIkwVljA,504
 cq/_core/queuing/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -28,8 +28,8 @@ cq/ext/injection.py,sha256=DLdALqRYaJ80wWEcw2wbZRUrNMiZVGg0AdgYIt5FrP8,3150
 cq/middlewares/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 cq/middlewares/contextlib.py,sha256=_kwbXteGADGuzD-o2pPoPWOeTKiXcPCNuDmpG-f-YnY,875
 cq/middlewares/exc.py,sha256=ecAMoksj6B4osySSZ9g_cBR35_tiABQdpII-Drxkz44,1604
-cq/middlewares/retry.py,sha256=L6X_Wa2TZ0IYNXmi8oexTXQyM_lkjJt5Ew4D-2VzwBY,957
-python_cq-0.25.0.dist-info/METADATA,sha256=E360s2Dd_Bgp3ApM1TdTLcxS0hM8GWtbsIeE5vLRrVk,4562
-python_cq-0.25.0.dist-info/WHEEL,sha256=THafob7ofN-NsuMN7Mg4qZyHaQI7KkD-QlcQatYhXPo,87
-python_cq-0.25.0.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
-python_cq-0.25.0.dist-info/RECORD,,
+cq/middlewares/retry.py,sha256=WkpMYfAVUR8bnZ1NejX8zeKuPtfCIJlDEj8r4ZkqGBU,1054
+python_cq-0.25.2.dist-info/METADATA,sha256=vFbIJUJ02nNrYB8Wx4CbZwwC5OSvPm4Y-tel5ytHeY0,5032
+python_cq-0.25.2.dist-info/WHEEL,sha256=2iZrJkDIkeDh0k9SikKMqFuRP-ua6mb4Ir1AsER4BEw,87
+python_cq-0.25.2.dist-info/licenses/LICENSE,sha256=oC77BOa9kaaQni5rW-Z-ytz3E5h4EVg248BHg9UFgyg,1063
+python_cq-0.25.2.dist-info/RECORD,,

{python_cq-0.25.0.dist-info → python_cq-0.25.2.dist-info}/WHEEL

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