8 releases (breaking)
0.8.0 | Sep 22, 2024 |
---|---|
0.7.0 | Jul 25, 2024 |
0.6.0 | Jun 7, 2024 |
0.5.0 | May 29, 2024 |
0.1.0 | Nov 24, 2023 |
#14 in #message-bus
244 downloads per month
Used in 3 crates
565KB
15K
SLoC
Aldrin
Aldrin is a message bus for service-oriented RPC and general interprocess communication.
Aldrin busses are star-shaped: there is a cental component, called the broker, to which multiple clients can connect. These client can then publish services for other clients to use.
Services are described in a small DSL called Aldrin schema and are composed of functions and events. Schemata are then processed by a code generator, which can output both client and server-side code.
Here is a small toy example of an echo service:
service Echo {
uuid = 8920965f-110a-42ec-915c-2a65a3c47d1f;
version = 1;
fn echo @ 1 {
args = string;
ok = string;
err = enum {
EmptyString @ 1;
}
}
fn echo_all @ 2 {
args = string;
err = enum {
EmptyString @ 1;
}
}
event echoed_to_all @ 1 = string;
}
Crate organization
aldrin
: This is the main crate, aimed at writing both client and server applications.aldrin-broker
: Implements the broker-side of the protocol.aldrin-core
: Shared protocol primitives used byaldrin
andaldrin-broker
.aldrin-test
: Utilities for setting up unit tests of Aldrin services.aldrin-parser
: Parser library for Aldrin schemata.aldrin-codegen
: Implements client and server code generation from Aldrin schemata.aldrin-gen
: Standalone frontend to the parser and code generation.aldrin-macros
: Contains a macro for code generation at compile-time.
Dependencies
~0.6–6.5MB
~45K SLoC