pamoja-loopback 0.1.17__py3-none-any.whl

pamoja/loopback/__init__.py

@@ -0,0 +1,16 @@
+"""Idiomatic loopback-broker facade.
+
+An in-process broker: publish on one link, receive on another, with no broker
+process, no network, and no hardware. It is what makes a message flow testable
+from a unit test rather than only from a deployment.
+"""
+
+from __future__ import annotations
+
+from pamoja._native import LoopbackBroker, LoopbackTransport, Message
+
+__all__ = [
+    "LoopbackBroker",
+    "LoopbackTransport",
+    "Message",
+]

pamoja_loopback-0.1.17.dist-info/METADATA

@@ -0,0 +1,113 @@
+Metadata-Version: 2.5
+Name: pamoja-loopback
+Version: 0.1.17
+Summary: An in-process transport with topic matching and a fault injector, for testing with no broker.
+Project-URL: Repository, https://github.com/molexxxx/pamoja
+Project-URL: Documentation, https://pamoja.molex.cloud/docs/guides/loopback.html
+Author: molexxxx
+License: MIT
+License-File: LICENSE-MIT
+Keywords: iot,loopback,pamoja,robotics
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Typing :: Typed
+Requires-Python: >=3.10
+Requires-Dist: pamoja-native==0.1.17
+Description-Content-Type: text/markdown
+
+# pamoja-loopback
+
+An in-process transport with topic matching and a fault injector, for testing with no broker. One capability of [pamoja](https://github.com/molexxxx/pamoja), one memory-safe Rust core with bindings for TypeScript, Python, and C#.
+
+[![API reference](https://raw.githubusercontent.com/molexxxx/pamoja/main/.github/badges/btn-api.svg)](https://pamoja.molex.cloud/docs/reference/python/pamoja/loopback.html)
+[![read the guide](https://raw.githubusercontent.com/molexxxx/pamoja/main/.github/badges/btn-guide.svg)](https://pamoja.molex.cloud/docs/guides/loopback.html)
+[![documentation](https://raw.githubusercontent.com/molexxxx/pamoja/main/.github/badges/btn-docs.svg)](https://pamoja.molex.cloud/docs/)
+
+## Install
+
+```sh
+pip install pamoja-loopback
+```
+
+```python
+from pamoja import loopback
+```
+
+This pulls in `pamoja-native`, the compiled engine. `pip install pamoja` is the whole framework in one package.
+
+## Example
+
+The script the test suite runs, spliced here as it ran.
+
+From [`bindings/python/guides/loopback.py`](https://github.com/molexxxx/pamoja/blob/main/bindings/python/guides/loopback.py):
+
+```python
+import asyncio
+
+from pamoja.core import PamojaError
+from pamoja.loopback import LoopbackBroker
+
+
+async def main() -> None:
+    # One broker and two links off it, all in this process. Nothing binds a port and
+    # nothing has to be running for the traffic below to flow, which is what makes this
+    # the link to develop a node against before it has a real one.
+    broker = LoopbackBroker()
+    publisher = broker.link()
+    subscriber = broker.link()
+    await publisher.connect()
+    await subscriber.connect()
+
+    # A `+` stands for exactly one level, so this takes the mixer's temperature but not the
+    # raw reading a level below it.
+    await subscriber.subscribe("line/+/temp")
+    await publisher.send("line/mixer/temp/raw", b"2150")
+    await publisher.send("line/mixer/temp", b"21.5")
+
+    message = await subscriber.recv()
+    print(f"line/+/temp took {message.payload.decode()} from {message.topic}")
+
+    # A `#` covers every level that remains, so a second link takes the whole subtree,
+    # including the reading the single-level filter passed over.
+    watcher = broker.link()
+    await watcher.connect()
+    await watcher.subscribe("line/#")
+    await publisher.send("line/mixer/temp/raw", b"2150")
+
+    deep = await watcher.recv()
+    print(f"line/#     took {deep.payload.decode()} from {deep.topic}")
+
+    # A link that has been disconnected reports the failure instead of dropping the
+    # reading, which is the case a test wants to reach without unplugging anything.
+    await publisher.disconnect()
+    try:
+        await publisher.send("line/mixer/temp", b"21.6")
+        print("a disconnected link took a reading, which should never happen")
+    except PamojaError as error:
+        print(f"disconnected refused the reading: {error}")
+
+    return message, deep
+
+
+message, deep = asyncio.run(main())
+```
+
+## The same capability in every language
+
+| Language | Package | Reference |
+| --- | --- | --- |
+| Rust | [`pamoja-loopback`](https://crates.io/crates/pamoja-loopback) | [reference](https://pamoja.molex.cloud/docs/reference/rust/pamoja_loopback/index.html), [docs.rs](https://docs.rs/pamoja-loopback), [install](https://pamoja.molex.cloud/docs/reference/rust.html#rust-loopback) |
+| TypeScript | [`@pamoja/loopback`](https://www.npmjs.com/package/@pamoja/loopback) | [reference](https://pamoja.molex.cloud/docs/reference/node/modules/_pamoja_loopback.html), [install](https://pamoja.molex.cloud/docs/reference/node.html#node-loopback) |
+| Python | [`pamoja-loopback`](https://pypi.org/project/pamoja-loopback/) | [reference](https://pamoja.molex.cloud/docs/reference/python/pamoja/loopback.html), [install](https://pamoja.molex.cloud/docs/reference/python.html#python-loopback) |
+| C# | [`Pamoja.Loopback`](https://www.nuget.org/packages/Pamoja.Loopback) | [reference](https://pamoja.molex.cloud/docs/reference/dotnet/api/Pamoja.Loopback.html), [install](https://pamoja.molex.cloud/docs/reference/dotnet.html#dotnet-loopback) |
+
+## Documentation
+
+- [`pamoja.loopback` reference](https://pamoja.molex.cloud/docs/reference/python/pamoja/loopback.html), every class and function in this module.
+- [The Loopback guide](https://pamoja.molex.cloud/docs/guides/loopback.html), with the same example in Rust, TypeScript, and C#.
+- [Every capability](https://pamoja.molex.cloud/docs/), and the [install page](https://pamoja.molex.cloud/docs/install.html).
+
+## License
+
+MIT

pamoja_loopback-0.1.17.dist-info/RECORD

@@ -0,0 +1,6 @@
+pamoja/loopback/__init__.py,sha256=sU_MOsygwuCfPD6Opcc4HKMBBoCoKyb0Y5RYjW5oQvc,436
+pamoja/loopback/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+pamoja_loopback-0.1.17.dist-info/METADATA,sha256=r91YYK8Mm4HcLbnzebIYtlrBfolF0fd0DI1yL_4zT4M,5208
+pamoja_loopback-0.1.17.dist-info/WHEEL,sha256=zOwg4jB6zX2kU910N-cMawjivD6tO8NEWvE12je1bVk,87
+pamoja_loopback-0.1.17.dist-info/licenses/LICENSE-MIT,sha256=f6NfyVO02r56R7vpDizB94FR7Xmntgl0QVQcJ-Mhmlg,1072
+pamoja_loopback-0.1.17.dist-info/RECORD,,

pamoja_loopback-0.1.17.dist-info/WHEEL

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

pamoja_loopback-0.1.17.dist-info/licenses/LICENSE-MIT

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Anthony Wiedman
+
+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.