rabbitkit 0.9.0__tar.gz → 0.9.1__tar.gz

{rabbitkit-0.9.0/src/rabbitkit.egg-info → rabbitkit-0.9.1}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rabbitkit
-Version: 0.9.0
+Version: 0.9.1
 Summary: Production-grade RabbitMQ toolkit — sync/async, decorator routing, retry, compression, full configurability
 Author-email: Talaat Magdy <talaatmagdy75@gmail.com>
 License-Expression: MIT
@@ -60,6 +60,7 @@ Requires-Dist: rabbitkit[all]; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: httpx<1.0,>=0.27; extra == "dev"
 Requires-Dist: prometheus-client<2.0,>=0.20; extra == "dev"
+Requires-Dist: psutil>=5.9; extra == "dev"
 Requires-Dist: mkdocs>=1.6.0; extra == "dev"
 Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
 Requires-Dist: mkdocstrings[python]>=0.26.0; extra == "dev"
@@ -76,7 +77,7 @@ Requires-Dist: testcontainers[rabbitmq]>=4.0.0; extra == "integration"
 Requires-Dist: docker>=7.0.0; extra == "integration"
 Dynamic: license-file
 
-<p align="center"><img src="assets/logo.svg" alt="rabbitkit" width="420"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/talaatmagdyx/rabbitkit/main/assets/logo.svg" alt="rabbitkit" width="420"></p>
 
 # rabbitkit
 
@@ -84,10 +85,10 @@ Dynamic: license-file
 
 [![PyPI](https://img.shields.io/pypi/v/rabbitkit)](https://pypi.org/project/rabbitkit/)
 [![CI](https://github.com/talaatmagdyx/rabbitkit/actions/workflows/ci.yml/badge.svg)](https://github.com/talaatmagdyx/rabbitkit/actions/workflows/ci.yml)
-[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Typed](https://img.shields.io/badge/types-mypy%20--strict-blue)](pyproject.toml)
-[![Style](https://img.shields.io/badge/style-ruff-261230)](pyproject.toml)
+[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/talaatmagdyx/rabbitkit/blob/main/LICENSE)
+[![Typed](https://img.shields.io/badge/types-mypy%20--strict-blue)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
+[![Style](https://img.shields.io/badge/style-ruff-261230)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
 
 rabbitkit is a **RabbitMQ-first toolkit for Python services**. It gives you
 clean decorators, safe retries, dead-letter queues, publisher confirms,
@@ -192,6 +193,8 @@ tests, production-ready lifecycle.
 
 ## Installation
 
+Available on PyPI: **[pypi.org/project/rabbitkit](https://pypi.org/project/rabbitkit/)**
+
 ```bash
 pip install rabbitkit[async]        # AsyncBroker (aio-pika)
 pip install rabbitkit[sync]         # SyncBroker (pika)
@@ -401,13 +404,13 @@ only when loss is acceptable.
 ## Production profile
 
 The recommended baseline (see the
-[production checklist](docs/production/checklist.md)): quorum queues (+
+[production checklist](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/checklist.md)): quorum queues (+
 `delivery_limit`), per-queue retry/DLQ topology, publisher confirms on,
 mandatory publishing where routing matters, checked `PublishOutcome`s,
 explicit ack policies, structured logs, split readiness/liveness probes,
 management-API metrics for queue depth and consumer lag, idempotent
 handlers. Migrating existing classic queues to quorum? There's a tool:
-`rabbitkit topology migrate` ([guide](docs/quorum-migration.md)).
+`rabbitkit topology migrate` ([guide](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/quorum-migration.md)).
 
 ## Observability
 
@@ -430,7 +433,7 @@ middleware (bring any `CircuitBreakerProtocol` implementation, e.g.
 pybreaker).
 
 **Experimental** (may change without a deprecation cycle — read the
-[stability policy](docs/stability-policy.md)): RPC over direct reply-to,
+[stability policy](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/stability-policy.md)): RPC over direct reply-to,
 distributed locking, message signing, result backends, stream queues, the
 monitoring dashboard. Notable caveats: the default signing nonce cache is
 per-process (use a shared cache for real replay protection), and never
@@ -494,7 +497,7 @@ rabbitkit health myapp.main:broker
 The DLQ replay acks a message only after its republish is broker-confirmed —
 the recovery tool cannot itself lose messages.
 
-<p align="center"><img src="assets/demo.svg" alt="rabbitkit dlq inspect and replay demo" width="720"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/talaatmagdyx/rabbitkit/main/assets/demo.svg" alt="rabbitkit dlq inspect and replay demo" width="720"></p>
 
 ## Where rabbitkit fits
 
@@ -520,7 +523,7 @@ test infrastructure in every service.
 - at-most-once behavior is acceptable and a raw client is enough
 
 A detailed framework-by-framework comparison lives in
-[docs/comparison.md](docs/comparison.md).
+[docs/comparison.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/comparison.md).
 
 ## Architecture
 
@@ -551,25 +554,25 @@ Python ≥ 3.11 (tested: 3.11 / 3.12 / 3.13 / 3.14; 3.15 pre-release experimenta
 
 **📚 Full rendered docs: [talaatmagdyx.github.io/rabbitkit](https://talaatmagdyx.github.io/rabbitkit/)**
 
-- [Getting Started](docs/guide/getting-started.md)
-- [Full Guide](docs/guide/full-guide.md)
-- [Message Safety](docs/message-safety.md)
-- [Retry & DLQ](docs/retry-and-dlq.md)
-- [Production Checklist](docs/production/checklist.md)
-- [Idempotency Contract](docs/production/idempotency.md)
-- [Kubernetes](docs/kubernetes.md)
-- [Quorum Migration](docs/quorum-migration.md)
-- [Security](docs/security.md)
-- [Stability Policy](docs/stability-policy.md)
-- [Troubleshooting](docs/troubleshooting.md)
+- [Getting Started](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/guide/getting-started.md)
+- [Full Guide](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/guide/full-guide.md)
+- [Message Safety](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/message-safety.md)
+- [Retry & DLQ](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/retry-and-dlq.md)
+- [Production Checklist](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/checklist.md)
+- [Idempotency Contract](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/idempotency.md)
+- [Kubernetes](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/kubernetes.md)
+- [Quorum Migration](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/quorum-migration.md)
+- [Security](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/security.md)
+- [Stability Policy](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/stability-policy.md)
+- [Troubleshooting](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/troubleshooting.md)
 
 ## Contributing & security
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for local development and quality
+See [CONTRIBUTING.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/CONTRIBUTING.md) for local development and quality
 gates (ruff, `mypy --strict`, near-total test coverage — the bar is real).
-Found a vulnerability? Follow [SECURITY.md](SECURITY.md) and report it
+Found a vulnerability? Follow [SECURITY.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/SECURITY.md) and report it
 privately.
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/talaatmagdyx/rabbitkit/blob/main/LICENSE)

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/README.md

@@ -1,4 +1,4 @@
-<p align="center"><img src="assets/logo.svg" alt="rabbitkit" width="420"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/talaatmagdyx/rabbitkit/main/assets/logo.svg" alt="rabbitkit" width="420"></p>
 
 # rabbitkit
 
@@ -6,10 +6,10 @@
 
 [![PyPI](https://img.shields.io/pypi/v/rabbitkit)](https://pypi.org/project/rabbitkit/)
 [![CI](https://github.com/talaatmagdyx/rabbitkit/actions/workflows/ci.yml/badge.svg)](https://github.com/talaatmagdyx/rabbitkit/actions/workflows/ci.yml)
-[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Typed](https://img.shields.io/badge/types-mypy%20--strict-blue)](pyproject.toml)
-[![Style](https://img.shields.io/badge/style-ruff-261230)](pyproject.toml)
+[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/talaatmagdyx/rabbitkit/blob/main/LICENSE)
+[![Typed](https://img.shields.io/badge/types-mypy%20--strict-blue)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
+[![Style](https://img.shields.io/badge/style-ruff-261230)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
 
 rabbitkit is a **RabbitMQ-first toolkit for Python services**. It gives you
 clean decorators, safe retries, dead-letter queues, publisher confirms,
@@ -114,6 +114,8 @@ tests, production-ready lifecycle.
 
 ## Installation
 
+Available on PyPI: **[pypi.org/project/rabbitkit](https://pypi.org/project/rabbitkit/)**
+
 ```bash
 pip install rabbitkit[async]        # AsyncBroker (aio-pika)
 pip install rabbitkit[sync]         # SyncBroker (pika)
@@ -323,13 +325,13 @@ only when loss is acceptable.
 ## Production profile
 
 The recommended baseline (see the
-[production checklist](docs/production/checklist.md)): quorum queues (+
+[production checklist](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/checklist.md)): quorum queues (+
 `delivery_limit`), per-queue retry/DLQ topology, publisher confirms on,
 mandatory publishing where routing matters, checked `PublishOutcome`s,
 explicit ack policies, structured logs, split readiness/liveness probes,
 management-API metrics for queue depth and consumer lag, idempotent
 handlers. Migrating existing classic queues to quorum? There's a tool:
-`rabbitkit topology migrate` ([guide](docs/quorum-migration.md)).
+`rabbitkit topology migrate` ([guide](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/quorum-migration.md)).
 
 ## Observability
 
@@ -352,7 +354,7 @@ middleware (bring any `CircuitBreakerProtocol` implementation, e.g.
 pybreaker).
 
 **Experimental** (may change without a deprecation cycle — read the
-[stability policy](docs/stability-policy.md)): RPC over direct reply-to,
+[stability policy](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/stability-policy.md)): RPC over direct reply-to,
 distributed locking, message signing, result backends, stream queues, the
 monitoring dashboard. Notable caveats: the default signing nonce cache is
 per-process (use a shared cache for real replay protection), and never
@@ -416,7 +418,7 @@ rabbitkit health myapp.main:broker
 The DLQ replay acks a message only after its republish is broker-confirmed —
 the recovery tool cannot itself lose messages.
 
-<p align="center"><img src="assets/demo.svg" alt="rabbitkit dlq inspect and replay demo" width="720"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/talaatmagdyx/rabbitkit/main/assets/demo.svg" alt="rabbitkit dlq inspect and replay demo" width="720"></p>
 
 ## Where rabbitkit fits
 
@@ -442,7 +444,7 @@ test infrastructure in every service.
 - at-most-once behavior is acceptable and a raw client is enough
 
 A detailed framework-by-framework comparison lives in
-[docs/comparison.md](docs/comparison.md).
+[docs/comparison.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/comparison.md).
 
 ## Architecture
 
@@ -473,25 +475,25 @@ Python ≥ 3.11 (tested: 3.11 / 3.12 / 3.13 / 3.14; 3.15 pre-release experimenta
 
 **📚 Full rendered docs: [talaatmagdyx.github.io/rabbitkit](https://talaatmagdyx.github.io/rabbitkit/)**
 
-- [Getting Started](docs/guide/getting-started.md)
-- [Full Guide](docs/guide/full-guide.md)
-- [Message Safety](docs/message-safety.md)
-- [Retry & DLQ](docs/retry-and-dlq.md)
-- [Production Checklist](docs/production/checklist.md)
-- [Idempotency Contract](docs/production/idempotency.md)
-- [Kubernetes](docs/kubernetes.md)
-- [Quorum Migration](docs/quorum-migration.md)
-- [Security](docs/security.md)
-- [Stability Policy](docs/stability-policy.md)
-- [Troubleshooting](docs/troubleshooting.md)
+- [Getting Started](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/guide/getting-started.md)
+- [Full Guide](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/guide/full-guide.md)
+- [Message Safety](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/message-safety.md)
+- [Retry & DLQ](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/retry-and-dlq.md)
+- [Production Checklist](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/checklist.md)
+- [Idempotency Contract](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/idempotency.md)
+- [Kubernetes](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/kubernetes.md)
+- [Quorum Migration](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/quorum-migration.md)
+- [Security](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/security.md)
+- [Stability Policy](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/stability-policy.md)
+- [Troubleshooting](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/troubleshooting.md)
 
 ## Contributing & security
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for local development and quality
+See [CONTRIBUTING.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/CONTRIBUTING.md) for local development and quality
 gates (ruff, `mypy --strict`, near-total test coverage — the bar is real).
-Found a vulnerability? Follow [SECURITY.md](SECURITY.md) and report it
+Found a vulnerability? Follow [SECURITY.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/SECURITY.md) and report it
 privately.
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/talaatmagdyx/rabbitkit/blob/main/LICENSE)

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "rabbitkit"
-version = "0.9.0"
+version = "0.9.1"
 description = "Production-grade RabbitMQ toolkit — sync/async, decorator routing, retry, compression, full configurability"
 readme = "README.md"
 license = "MIT"
@@ -50,6 +50,7 @@ dev         = [
     "pytest>=8.0",
     "httpx>=0.27,<1.0",  # starlette TestClient (dashboard tests)
     "prometheus-client>=0.20,<2.0",  # PrometheusCollector tests
+    "psutil>=5.9",  # bench_resources (memory/FD tracking)
     "mkdocs>=1.6.0",
     "mkdocs-material>=9.5.0",
     "mkdocstrings[python]>=0.26.0",
@@ -138,3 +139,12 @@ warn_unused_configs = true
 asyncio_mode = "auto"
 testpaths = ["tests"]
 markers = ["integration: integration tests (may need RabbitMQ)"]
+filterwarnings = [
+    # rabbitkit's own operator-guidance warnings, exercised deliberately by
+    # tests (dedicated pytest.warns tests still assert they fire — pytest.warns
+    # bypasses these filters). Real users still see them.
+    "ignore:Starting a single-worker sync consumer:RuntimeWarning",
+    "ignore:SigningMiddleware is using the default in-memory:RuntimeWarning",
+    # third-party: testcontainers' own deprecated decorator
+    "ignore:The @wait_container_is_ready decorator is deprecated:DeprecationWarning",
+]

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/src/rabbitkit/_version.py

@@ -1,3 +1,3 @@
 """rabbitkit version — single source of truth."""
 
-__version__ = "0.9.0"
+__version__ = "0.9.1"

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/src/rabbitkit/async_/broker.py

@@ -219,6 +219,17 @@ class AsyncBroker:
             if self._in_flight == 0:
                 cond.notify_all()
 
+    @property
+    def started(self) -> bool:
+        """True between a successful ``start()`` and ``stop()``.
+
+        Public counterpart of ``_started`` — health checks
+        (:func:`rabbitkit.health.broker_health_check`) read this instead of
+        falling back to the private attribute (which emits a
+        DeprecationWarning).
+        """
+        return self._started
+
     @property
     def config(self) -> RabbitConfig:
         return self._config

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/src/rabbitkit/core/pipeline.py

@@ -37,6 +37,37 @@ from rabbitkit.serialization.base import Serializer
 logger = structlog.stdlib.get_logger(__name__)
 _stdlib_logger = logging.getLogger(__name__)
 
+# Transport "channel/connection died" exception class names. Matched by NAME
+# (not isinstance) because core/ never imports pika or aio-pika. Covers pika
+# (ChannelWrongStateError, ChannelClosed*, ConnectionClosed*, StreamLostError)
+# and aio-pika/aiormq (ChannelInvalidStateError, AMQPConnectionError).
+_CHANNEL_GONE_NAMES = frozenset(
+    {
+        "ChannelWrongStateError",
+        "ChannelClosed",
+        "ChannelClosedByBroker",
+        "ChannelClosedByClient",
+        "ChannelInvalidStateError",
+        "ConnectionClosed",
+        "ConnectionClosedByBroker",
+        "ConnectionWrongStateError",
+        "AMQPConnectionError",
+        "StreamLostError",
+    }
+)
+
+
+def _is_channel_gone(exc: BaseException) -> bool:
+    """True if *exc* (or its cause chain) is a transport channel/connection-death error."""
+    seen: set[int] = set()
+    current: BaseException | None = exc
+    while current is not None and id(current) not in seen:
+        if type(current).__name__ in _CHANNEL_GONE_NAMES:
+            return True
+        seen.add(id(current))
+        current = current.__cause__ or current.__context__
+    return False
+
 # M10: on the async path, bodies at/above this size are decoded in a worker
 # thread (asyncio.to_thread) so a large JSON/msgspec/pydantic parse doesn't
 # block the event loop. Below it, inline decode is faster than the thread hop.
@@ -1220,6 +1251,28 @@ class HandlerPipeline:
         exc: Exception,
     ) -> None:
         """Handle exception in sync pipeline per AckPolicy (Contract 1)."""
+        try:
+            self._handle_sync_exception_inner(route, message, exc)
+        except Exception as settle_exc:
+            # The settlement attempt itself failed because the channel or
+            # connection died (SIGTERM drain, broker restart, network cut).
+            # Nothing further can be settled on a dead channel and the broker
+            # will redeliver the unacked message — warn instead of letting a
+            # secondary exception escape as a full ERROR traceback.
+            if not _is_channel_gone(settle_exc):
+                raise
+            logger.warning(
+                "Channel closed before settlement (%s); leaving message "
+                "unsettled — the broker will redeliver it (at-least-once)",
+                type(settle_exc).__name__,
+            )
+
+    def _handle_sync_exception_inner(
+        self,
+        route: RouteDefinition,
+        message: RabbitMessage,
+        exc: Exception,
+    ) -> None:
         if message.is_settled:
             # Already settled (e.g., MANUAL mode handler settled then raised)
             logger.warning("Exception after settlement: %s", exc)
@@ -1261,6 +1314,25 @@ class HandlerPipeline:
         exc: Exception,
     ) -> None:
         """Handle exception in async pipeline per AckPolicy (Contract 1)."""
+        try:
+            await self._handle_async_exception_inner(route, message, exc)
+        except Exception as settle_exc:
+            # See _handle_sync_exception: a dead channel means nothing can be
+            # settled and the broker redelivers — warn, don't raise.
+            if not _is_channel_gone(settle_exc):
+                raise
+            logger.warning(
+                "Channel closed before settlement (%s); leaving message "
+                "unsettled — the broker will redeliver it (at-least-once)",
+                type(settle_exc).__name__,
+            )
+
+    async def _handle_async_exception_inner(
+        self,
+        route: RouteDefinition,
+        message: RabbitMessage,
+        exc: Exception,
+    ) -> None:
         if message.is_settled:
             logger.warning("Exception after settlement: %s", exc)
             return

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/src/rabbitkit/sync/broker.py

@@ -146,6 +146,17 @@ class SyncBroker:
             self._transport.on_blocked(value.on_blocked)
             self._transport.on_unblocked(value.on_unblocked)
 
+    @property
+    def started(self) -> bool:
+        """True between a successful ``start()`` and ``stop()``.
+
+        Public counterpart of ``_started`` — health checks
+        (:func:`rabbitkit.health.broker_health_check`) read this instead of
+        falling back to the private attribute (which emits a
+        DeprecationWarning).
+        """
+        return self._started
+
     @property
     def config(self) -> RabbitConfig:
         return self._config

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/src/rabbitkit/sync/transport.py

@@ -930,7 +930,22 @@ class SyncTransport:
             while self._consuming:
                 # process_data_events drains ALL channels' consumers + queued
                 # add_callback_threadsafe callbacks (acks from worker threads).
-                self._connection.process_data_events(time_limit=1.0)
+                try:
+                    self._connection.process_data_events(time_limit=1.0)
+                except ValueError as exc:
+                    # pika's SelectConnection ioloop raises a bare
+                    # ValueError("Timeout closed before call") when the
+                    # connection died between poll ticks (e.g. broker restart).
+                    # Re-raise it as the connection error it really is so
+                    # SyncBroker.run()'s recovery loop reconnects instead of
+                    # the consumer thread dying on an unrecognized exception.
+                    if self._connection.is_closed or "Timeout closed before call" in str(exc):
+                        import pika.exceptions
+
+                        raise pika.exceptions.AMQPConnectionError(
+                            f"connection lost mid-poll: {exc}"
+                        ) from exc
+                    raise
                 # L14: process_data_events returning (rather than raising a
                 # connection error) is itself evidence the I/O loop is alive
                 # and pumping -- fire once per tick regardless of whether any

{rabbitkit-0.9.0 → rabbitkit-0.9.1/src/rabbitkit.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: rabbitkit
-Version: 0.9.0
+Version: 0.9.1
 Summary: Production-grade RabbitMQ toolkit — sync/async, decorator routing, retry, compression, full configurability
 Author-email: Talaat Magdy <talaatmagdy75@gmail.com>
 License-Expression: MIT
@@ -60,6 +60,7 @@ Requires-Dist: rabbitkit[all]; extra == "dev"
 Requires-Dist: pytest>=8.0; extra == "dev"
 Requires-Dist: httpx<1.0,>=0.27; extra == "dev"
 Requires-Dist: prometheus-client<2.0,>=0.20; extra == "dev"
+Requires-Dist: psutil>=5.9; extra == "dev"
 Requires-Dist: mkdocs>=1.6.0; extra == "dev"
 Requires-Dist: mkdocs-material>=9.5.0; extra == "dev"
 Requires-Dist: mkdocstrings[python]>=0.26.0; extra == "dev"
@@ -76,7 +77,7 @@ Requires-Dist: testcontainers[rabbitmq]>=4.0.0; extra == "integration"
 Requires-Dist: docker>=7.0.0; extra == "integration"
 Dynamic: license-file
 
-<p align="center"><img src="assets/logo.svg" alt="rabbitkit" width="420"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/talaatmagdyx/rabbitkit/main/assets/logo.svg" alt="rabbitkit" width="420"></p>
 
 # rabbitkit
 
@@ -84,10 +85,10 @@ Dynamic: license-file
 
 [![PyPI](https://img.shields.io/pypi/v/rabbitkit)](https://pypi.org/project/rabbitkit/)
 [![CI](https://github.com/talaatmagdyx/rabbitkit/actions/workflows/ci.yml/badge.svg)](https://github.com/talaatmagdyx/rabbitkit/actions/workflows/ci.yml)
-[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](pyproject.toml)
-[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Typed](https://img.shields.io/badge/types-mypy%20--strict-blue)](pyproject.toml)
-[![Style](https://img.shields.io/badge/style-ruff-261230)](pyproject.toml)
+[![Python](https://img.shields.io/badge/python-3.11%20%7C%203.12%20%7C%203.13%20%7C%203.14-blue)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green.svg)](https://github.com/talaatmagdyx/rabbitkit/blob/main/LICENSE)
+[![Typed](https://img.shields.io/badge/types-mypy%20--strict-blue)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
+[![Style](https://img.shields.io/badge/style-ruff-261230)](https://github.com/talaatmagdyx/rabbitkit/blob/main/pyproject.toml)
 
 rabbitkit is a **RabbitMQ-first toolkit for Python services**. It gives you
 clean decorators, safe retries, dead-letter queues, publisher confirms,
@@ -192,6 +193,8 @@ tests, production-ready lifecycle.
 
 ## Installation
 
+Available on PyPI: **[pypi.org/project/rabbitkit](https://pypi.org/project/rabbitkit/)**
+
 ```bash
 pip install rabbitkit[async]        # AsyncBroker (aio-pika)
 pip install rabbitkit[sync]         # SyncBroker (pika)
@@ -401,13 +404,13 @@ only when loss is acceptable.
 ## Production profile
 
 The recommended baseline (see the
-[production checklist](docs/production/checklist.md)): quorum queues (+
+[production checklist](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/checklist.md)): quorum queues (+
 `delivery_limit`), per-queue retry/DLQ topology, publisher confirms on,
 mandatory publishing where routing matters, checked `PublishOutcome`s,
 explicit ack policies, structured logs, split readiness/liveness probes,
 management-API metrics for queue depth and consumer lag, idempotent
 handlers. Migrating existing classic queues to quorum? There's a tool:
-`rabbitkit topology migrate` ([guide](docs/quorum-migration.md)).
+`rabbitkit topology migrate` ([guide](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/quorum-migration.md)).
 
 ## Observability
 
@@ -430,7 +433,7 @@ middleware (bring any `CircuitBreakerProtocol` implementation, e.g.
 pybreaker).
 
 **Experimental** (may change without a deprecation cycle — read the
-[stability policy](docs/stability-policy.md)): RPC over direct reply-to,
+[stability policy](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/stability-policy.md)): RPC over direct reply-to,
 distributed locking, message signing, result backends, stream queues, the
 monitoring dashboard. Notable caveats: the default signing nonce cache is
 per-process (use a shared cache for real replay protection), and never
@@ -494,7 +497,7 @@ rabbitkit health myapp.main:broker
 The DLQ replay acks a message only after its republish is broker-confirmed —
 the recovery tool cannot itself lose messages.
 
-<p align="center"><img src="assets/demo.svg" alt="rabbitkit dlq inspect and replay demo" width="720"></p>
+<p align="center"><img src="https://raw.githubusercontent.com/talaatmagdyx/rabbitkit/main/assets/demo.svg" alt="rabbitkit dlq inspect and replay demo" width="720"></p>
 
 ## Where rabbitkit fits
 
@@ -520,7 +523,7 @@ test infrastructure in every service.
 - at-most-once behavior is acceptable and a raw client is enough
 
 A detailed framework-by-framework comparison lives in
-[docs/comparison.md](docs/comparison.md).
+[docs/comparison.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/comparison.md).
 
 ## Architecture
 
@@ -551,25 +554,25 @@ Python ≥ 3.11 (tested: 3.11 / 3.12 / 3.13 / 3.14; 3.15 pre-release experimenta
 
 **📚 Full rendered docs: [talaatmagdyx.github.io/rabbitkit](https://talaatmagdyx.github.io/rabbitkit/)**
 
-- [Getting Started](docs/guide/getting-started.md)
-- [Full Guide](docs/guide/full-guide.md)
-- [Message Safety](docs/message-safety.md)
-- [Retry & DLQ](docs/retry-and-dlq.md)
-- [Production Checklist](docs/production/checklist.md)
-- [Idempotency Contract](docs/production/idempotency.md)
-- [Kubernetes](docs/kubernetes.md)
-- [Quorum Migration](docs/quorum-migration.md)
-- [Security](docs/security.md)
-- [Stability Policy](docs/stability-policy.md)
-- [Troubleshooting](docs/troubleshooting.md)
+- [Getting Started](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/guide/getting-started.md)
+- [Full Guide](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/guide/full-guide.md)
+- [Message Safety](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/message-safety.md)
+- [Retry & DLQ](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/retry-and-dlq.md)
+- [Production Checklist](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/checklist.md)
+- [Idempotency Contract](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/production/idempotency.md)
+- [Kubernetes](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/kubernetes.md)
+- [Quorum Migration](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/quorum-migration.md)
+- [Security](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/security.md)
+- [Stability Policy](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/stability-policy.md)
+- [Troubleshooting](https://github.com/talaatmagdyx/rabbitkit/blob/main/docs/troubleshooting.md)
 
 ## Contributing & security
 
-See [CONTRIBUTING.md](CONTRIBUTING.md) for local development and quality
+See [CONTRIBUTING.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/CONTRIBUTING.md) for local development and quality
 gates (ruff, `mypy --strict`, near-total test coverage — the bar is real).
-Found a vulnerability? Follow [SECURITY.md](SECURITY.md) and report it
+Found a vulnerability? Follow [SECURITY.md](https://github.com/talaatmagdyx/rabbitkit/blob/main/SECURITY.md) and report it
 privately.
 
 ## License
 
-[MIT](LICENSE)
+[MIT](https://github.com/talaatmagdyx/rabbitkit/blob/main/LICENSE)

{rabbitkit-0.9.0 → rabbitkit-0.9.1}/src/rabbitkit.egg-info/requires.txt

@@ -24,6 +24,7 @@ rabbitkit[all]
 pytest>=8.0
 httpx<1.0,>=0.27
 prometheus-client<2.0,>=0.20
+psutil>=5.9
 mkdocs>=1.6.0
 mkdocs-material>=9.5.0
 mkdocstrings[python]>=0.26.0