mq-bridge-py-basic 0.2.16__cp38-abi3-win_amd64.whl

mq_bridge/__init__.py

@@ -0,0 +1,17 @@
+from ._mq_bridge import (
+    MemoryDrainer,
+    Message,
+    NonRetryableError,
+    Publisher,
+    RetryableError,
+    Route,
+)
+
+__all__ = [
+    "MemoryDrainer",
+    "Message",
+    "NonRetryableError",
+    "Publisher",
+    "RetryableError",
+    "Route",
+]

mq_bridge/__init__.pyi

@@ -0,0 +1,108 @@
+from typing import Any, Callable, Dict, List, Mapping, Optional, Union
+
+JsonValue = Any
+HandlerResult = Optional[Union["Message", bytes, str, Dict[str, JsonValue], List[JsonValue], int, float, bool]]
+
+
+class RetryableError(Exception): ...
+
+
+class NonRetryableError(Exception): ...
+
+
+class Message:
+    def __init__(
+        self,
+        payload: bytes,
+        metadata: Optional[Mapping[str, str]] = ...,
+        id: Optional[str] = ...,
+    ) -> None: ...
+
+    @classmethod
+    def from_json(
+        cls,
+        data: JsonValue,
+        metadata: Optional[Mapping[str, str]] = ...,
+        id: Optional[str] = ...,
+    ) -> "Message": ...
+
+    @property
+    def payload(self) -> bytes: ...
+
+    @property
+    def metadata(self) -> Dict[str, str]: ...
+
+    @property
+    def id(self) -> Optional[str]: ...
+
+    def json(self) -> JsonValue: ...
+
+    def text(self) -> str: ...
+
+    def with_json(self, data: JsonValue) -> "Message": ...
+
+    def with_payload(self, payload: bytes) -> "Message": ...
+
+
+class Route:
+    @classmethod
+    def from_yaml(cls, path: str, name: str) -> "Route": ...
+
+    def with_handler(self, handler: Callable[[Message], HandlerResult]) -> "Route": ...
+
+    def add_handler(
+        self,
+        kind: str,
+        handler: Callable[[JsonValue], HandlerResult],
+    ) -> "Route": ...
+
+    def run(self) -> None: ...
+
+    def stop(self) -> None: ...
+
+
+class MemoryDrainer:
+    @classmethod
+    def from_topic(
+        cls,
+        topic: str,
+        capacity: int = ...,
+    ) -> "MemoryDrainer": ...
+
+    def drain(
+        self,
+        count: int,
+        timeout: Optional[float] = ...,
+        batch_size: int = ...,
+    ) -> int: ...
+
+
+class Publisher:
+    @classmethod
+    def from_yaml(cls, path: str, name: str) -> "Publisher": ...
+
+    def send(
+        self,
+        message: Union[Message, bytes],
+        metadata: Optional[Mapping[str, str]] = ...,
+    ) -> None: ...
+
+    def request(
+        self,
+        message: Union[Message, bytes],
+        metadata: Optional[Mapping[str, str]] = ...,
+    ) -> Message: ...
+
+    def send_json(
+        self,
+        data: JsonValue,
+        metadata: Optional[Mapping[str, str]] = ...,
+        id: Optional[str] = ...,
+    ) -> None: ...
+
+    def request_json(
+        self,
+        data: JsonValue,
+        metadata: Optional[Mapping[str, str]] = ...,
+        id: Optional[str] = ...,
+    ) -> Message: ...

mq_bridge/py.typed

@@ -0,0 +1 @@
+

mq_bridge_py_basic-0.2.16.dist-info/METADATA

@@ -0,0 +1,110 @@
+Metadata-Version: 2.4
+Name: mq-bridge-py-basic
+Version: 0.2.16
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Programming Language :: Rust
+License-File: LICENSE.python
+Summary: Python bindings for mq-bridge (basic: all-platform messaging set)
+Keywords: messaging,tokio,pyo3,maturin,mq-bridge
+License: MIT
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
+Project-URL: Homepage, https://github.com/marcomq/mq-bridge
+Project-URL: Issues, https://github.com/marcomq/mq-bridge/issues
+Project-URL: Repository, https://github.com/marcomq/mq-bridge
+
+# mq-bridge Python bindings
+
+Thin Python bindings for the Rust `mq-bridge` core.
+
+## Install
+
+Pick exactly one distribution. Both install the same import path: `mq_bridge`.
+
+| Package | Install | Includes |
+| :--- | :--- | :--- |
+| Full | `pip install mq-bridge-py` | Basic set plus Kafka, AWS, gRPC, MongoDB, SQLx |
+| Basic | `pip install mq-bridge-py-basic` | HTTP, NATS, MQTT, AMQP, WebSocket, ZeroMQ, middleware |
+
+Memory and file endpoints are always present in both packages. Use `mq-bridge-py-basic` when you want the lean all-platform wheel set. Use `mq-bridge-py` when you need Kafka or the heavier non-messaging backends.
+
+The public API stays close to mq-bridge itself:
+
+- `Route.from_yaml(path, name)` loads one named route
+- `Route.with_handler(...)` attaches a raw `Message` handler, with lazy `json()`/`text()` readers and `with_json()`/`with_payload()` response helpers
+- `Route.add_handler(kind, ...)` uses mq-bridge's `kind` dispatch and delivers decoded JSON
+- `RetryableError` and `NonRetryableError` let Python handlers signal retry intent
+- `Publisher.from_yaml(path, name)` loads one named publisher
+- `Publisher.send_json(...)` and `Publisher.request_json(...)` serialize Python JSON values in Rust
+
+The Python surface is synchronous and blocking. Tokio, broker I/O, routing, and batching all stay in Rust.
+
+## Local development
+
+`uv` is a good fit here for the Python-side developer workflow, while `maturin` stays the build backend:
+
+```bash
+cd python/mq-bridge-py
+uv sync --group dev --no-install-project
+uv run maturin develop
+uv run pytest -q
+```
+
+Performance smoke tests are skipped by default because they start routes and measure
+local throughput:
+
+```bash
+cd python/mq-bridge-py
+MQ_BRIDGE_RUN_PERF_TESTS=1 uv run pytest -q -m performance
+```
+
+## Examples
+
+Raw message handler:
+
+```bash
+cd python/mq-bridge-py
+uv run python examples/raw_route.py
+```
+
+Kind-based JSON handler:
+
+```bash
+cd python/mq-bridge-py
+uv run python examples/json_route.py
+```
+
+Memory benchmark:
+
+```bash
+cd python/mq-bridge-py
+uv run maturin develop --release
+uv run python examples/bench_memory.py --messages 100000
+```
+
+## Analysis
+
+HTTP comparison benchmark, driven by a native load generator (`wrk`) so the
+client is never the bottleneck. It boots each server itself (mq-bridge in worker
+and direct executor modes, plus FastAPI, Starlette, Sanic, aiohttp, and
+FastStream when installed) and drives each with `wrk`:
+
+```bash
+cd python/mq-bridge-py
+uv run maturin develop --release
+uv sync --group bench   # optional Python HTTP peers
+uv run python analysis/bench_http_native.py --connections 1,8,32 --duration 8
+```
+
+Requires `wrk` on `PATH` (`brew install wrk`). The FastStream target compares its
+ASGI custom-route path over Uvicorn; it is not a broker-backed subscriber/publisher
+benchmark. The examples use included sample configs or create temporary configs.
+

mq_bridge_py_basic-0.2.16.dist-info/RECORD

@@ -0,0 +1,9 @@
+mq_bridge/__init__.py,sha256=c5SSu1m4xFDj0hhoqlh2DkOZuAgDCLUlFIN2ulYx-WU,274
+mq_bridge/__init__.pyi,sha256=JZU0bM8TTEXc29i7lalabbIcvW3oGuTki3y4EdacxeI,2503
+mq_bridge/_mq_bridge.pyd,sha256=bkDnWZ3SaJFYgA9NOA23sRCXzPpdMF8gBdWsM5JiNUY,19311104
+mq_bridge/py.typed,sha256=frcCV1k9oG9oKj3dpUqdJg1PxRT2RSN_XKdLCPjaYaY,2
+mq_bridge_py_basic-0.2.16.dist-info/METADATA,sha256=hAaX1DMVy1524taDf1xKk6y8WDv231oLaAVQ8D2i8-o,3955
+mq_bridge_py_basic-0.2.16.dist-info/WHEEL,sha256=pFIXPOkq6jL2LlDfuKG9tv96ZyWzqxYbGCGPlqgMguc,95
+mq_bridge_py_basic-0.2.16.dist-info/licenses/LICENSE.python,sha256=j286SjhChHuapJue5Z_zDsrFwKuTZ2cwR2ebkm6SFvo,1094
+mq_bridge_py_basic-0.2.16.dist-info/sboms/mq-bridge-py.cyclonedx.json,sha256=m9S-FCsWBH4JUvjStDl7lcrL9PN21mtZDm_MMlj5-9I,363934
+mq_bridge_py_basic-0.2.16.dist-info/RECORD,,

mq_bridge_py_basic-0.2.16.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: maturin (1.14.0)
+Root-Is-Purelib: false
+Tag: cp38-abi3-win_amd64

mq_bridge_py_basic-0.2.16.dist-info/licenses/LICENSE.python

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Marco Mengelkoch
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.