https://github.com/powersemmi/ruststream
An async messaging framework for Rust
https://github.com/powersemmi/ruststream
asyncapi distributed-systems rust stream-processing
Last synced: 11 days ago
JSON representation
An async messaging framework for Rust
- Host: GitHub
- URL: https://github.com/powersemmi/ruststream
- Owner: powersemmi
- License: apache-2.0
- Created: 2026-05-31T11:44:05.000Z (17 days ago)
- Default Branch: main
- Last Pushed: 2026-06-05T05:34:34.000Z (12 days ago)
- Last Synced: 2026-06-06T01:14:12.567Z (12 days ago)
- Topics: asyncapi, distributed-systems, rust, stream-processing
- Language: Rust
- Homepage: https://powersemmi.github.io/ruststream/
- Size: 942 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
RustStream
An async messaging framework for Rust: broker-agnostic traits, a router runtime, codecs, AsyncAPI generation, Prometheus metrics, and a conformance harness for broker authors.
---
RustStream connects your service to a message broker through a small set of generic traits, then
gives you a router, middleware, codecs, and tooling on top. The core depends on no broker, so each
broker is an independent crate held to one contract; broker-specific configuration never leaks into
the framework.
## Features
- **Broker-agnostic core.** Just traits and types, zero broker dependencies. Brokers are separate
crates, and the contract is checked by a conformance harness.
- **Fully async on tokio.** No blocking APIs in the public surface.
- **Subscribers are `Stream`s, not callbacks.** Back-pressure comes for free.
- **Ack consumes `self`.** Double-ack is a compile error.
- **Pluggable codecs:** JSON, MessagePack, and CBOR behind cargo features.
- **Zero-boilerplate binaries.** `#[ruststream::app]` generates `main`; the `ruststream` CLI
scaffolds projects, runs them, and generates the AsyncAPI document.
- **AsyncAPI 3.0 and Prometheus metrics,** served from your own HTTP stack.
- **Colored console logging** behind the `logging` feature; the generated CLI installs it on `run`,
with verbosity driven by `RUST_LOG`.
- **Capability traits** for optional features (batch subscribe, transactions, request-reply,
partitioning); a broker implements only what it supports.
## Install
```toml
[dependencies]
ruststream = { version = "0.2", features = ["macros", "memory", "json"] }
serde = { version = "1", features = ["derive"] }
```
The CLI ships with the crate behind the `cli` feature:
```bash
cargo install ruststream --features cli
```
## Write a service
```rust
use ruststream::codec::JsonCodec;
use ruststream::memory::MemoryBroker;
use ruststream::runtime::{AppInfo, HandlerResult, RustStream};
use ruststream::subscriber;
use serde::Deserialize;
#[derive(Debug, Deserialize)]
struct Order {
id: u64,
}
#[subscriber("orders")]
async fn handle(order: &Order) -> HandlerResult {
println!("got order {}", order.id);
HandlerResult::Ack
}
#[ruststream::app]
fn app() -> RustStream {
RustStream::new(AppInfo::new("orders", "0.1.0"))
.with_broker(MemoryBroker::new(), |b| b.include(handle, JsonCodec))
}
```
`#[ruststream::app]` generates `main`, so there is no runtime boilerplate.
## Run it
```bash
ruststream run # start the service (or: cargo run -- run)
ruststream asyncapi gen # print the AsyncAPI document
ruststream new my-service # scaffold a new project
```
## Test it
Unit-test handlers against the in-memory broker, with no external service. It does core routing
only, so you assert on handler behaviour, middleware, and decoding exactly as in production. See the
[testing guide](https://powersemmi.github.io/ruststream/guides/testing/).
## Documentation
- Guide and tutorials:
- API reference:
- Writing a broker:
## Ecosystem
- [`ruststream-nats`](https://github.com/powersemmi/ruststream-nats): the NATS broker (Core NATS and
JetStream).
- [`ruststream-py`](https://github.com/powersemmi/ruststream-py): Python bindings.
Concrete brokers live in their own crates and pull `ruststream` from crates.io.
## Contributing
```bash
just check # fmt, clippy, and feature checks
just test # the test suite
```
## License
Licensed under the [Apache-2.0](./LICENSE) license.
Inspired by [FastStream](https://github.com/airtai/faststream).