#interprocess-communication #message-bus #rpc-service #rpc #service #inter-process #async

aldrin-core

Shared core components of Aldrin, a message bus for service-oriented RPC and interprocess communication

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

Download history 5/week @ 2024-06-24 1/week @ 2024-07-08 160/week @ 2024-07-22 20/week @ 2024-07-29 7/week @ 2024-08-12 1/week @ 2024-08-19 8/week @ 2024-08-26 1/week @ 2024-09-02 119/week @ 2024-09-16 96/week @ 2024-09-23 22/week @ 2024-09-30 7/week @ 2024-10-07

244 downloads per month
Used in 3 crates

MIT/Apache

565KB
15K SLoC

Aldrin

Crates.io Crates.io Build status

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 by aldrin and aldrin-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