elbus - Rust-native IPC broker
Note: the project is under development and in alpha stage
What is elbus
The library can be embedded in any Rust project or be used as a standalone server.
Available at https://elbus.readthedocs.io/
The following communication patterns are supported out-of-the-box:
- one-to-one messages
- one-to-many messages
The following channels are supported:
- async channels between threads/futures (Rust only)
- UNIX sockets (local machine)
- TCP sockets
In addition to Rust, elbus has also bindings for the following languages:
- Python (sync): https://pypi.org/project/elbus/
- Python (async): https://pypi.org/project/elbus-async/
Rust crate: https://crates.io/crates/elbus
A client should register with a name "group.subgroup.client" (subgroups are optional). The client's name can not start with dot (".", reserved for internal broker clients) if registered via IPC.
The client's name must be unique, otherwise the broker refuses the registration.
Broadcast messages are sent to multiple clients at once. Use "?" for any part of the path, "*" as the ending for wildcards. E.g.:
"?.test.*" - the message is be sent to clients "g1.test.client1", "g1.test.subgroup.client2" etc.
Use MQTT-format for topics: "+" for any part of the path, "#" as the ending for wildcards. E.g. a client, subscribed to "+/topic/#" receives publications sent to "x/topic/event", "x/topic/sub/event" etc.
An optional included RPC layer for one-to-one messaging can be used. The layer is similar to JSON RPC but is optimized for byte communications.
Security and reliability model
elbus has ZERO security model in favor of simplicity and speed. Also, elbus is not designed to work via unstable connections, all clients should be connected either from the local machine or using high-speed reliable local network communications.
If you need a pub/sub server for a wide area network, try PSRT.
See examples folder.
Build a stand-alone server
cargo build --features server,broker-api
The "broker-api" feature is optional. When enabled, it allows to call broker default internal functions.
About the authors
Bohemia Automation / Altertech is a group of companies with 15+ years of experience in the enterprise automation and industrial IoT. Our setups include power plants, factories and urban infrastructure. Largest of them have 1M+ sensors and controlled devices and the bar raises upper and upper every day.