# pamoja-loopback
In-process loopback transport for pamoja: a broker-free Transport for tests, examples, and simulators.
<a href="https://crates.io/crates/pamoja-loopback"><img height="28" alt="crates.io" src="https://raw.githubusercontent.com/molexxxx/pamoja/main/.github/badges/btn-cratesio.svg"></a>
<a href="https://docs.rs/pamoja-loopback"><img height="28" alt="docs.rs" src="https://raw.githubusercontent.com/molexxxx/pamoja/main/.github/badges/btn-docsrs.svg"></a>
An in-process loopback transport for hardware-free testing and examples.
[`LoopbackTransport`] implements the core [`Transport`](pamoja_core::Transport)
trait against a shared in-memory [`LoopbackBroker`] instead of a network, so
examples, the simulators, and the cross-language conformance scenarios can
exercise the full publish/subscribe path with no broker process and no
hardware. Topic filters follow MQTT semantics, including the `+` single-level
and `#` multi-level wildcards.
Clone one broker into every transport that should share a namespace: a publish
on any transport is delivered to every transport whose subscriptions match.
[`Faulty`] decorates any transport to inject send failures, so degraded-link
behavior such as store-and-forward retry can be tested deterministically.
## License
MIT - part of the [pamoja](https://github.com/molexxxx/pamoja) workspace: one memory-safe Rust core with bindings for every language.