Initial (g)RPC implementation

asynchronix/src/ports.rs

@@ -0,0 +1,35 @@
+//! Model ports for event and query broadcasting.
+//!
+//! Models typically contain [`Output`] and/or [`Requestor`] ports, exposed as
+//! public member variables. Output ports broadcast events to all connected
+//! input ports, while requestor ports broadcast queries to, and retrieve
+//! replies from, all connected replier ports.
+//!
+//! On the surface, output and requestor ports only differ in that sending a
+//! query from a requestor port also returns an iterator over the replies from
+//! all connected ports. Sending a query is more costly, however, because of the
+//! need to wait until all connected models have processed the query. In
+//! contrast, since events are buffered in the mailbox of the target model,
+//! sending an event is a fire-and-forget operation. For this reason, output
+//! ports should generally be preferred over requestor ports when possible.
+
+mod input;
+mod output;
+mod sink;
+mod source;
+
+pub use input::markers;
+pub use input::{InputFn, ReplierFn};
+pub use output::{Output, Requestor};
+pub use sink::{
+    event_buffer::EventBuffer, event_slot::EventSlot, EventSink, EventSinkStream, EventSinkWriter,
+};
+pub use source::{EventSource, QuerySource, ReplyReceiver};
+
+#[derive(Copy, Clone, Debug, Eq, PartialEq, Hash)]
+/// Unique identifier for a connection between two ports.
+pub struct LineId(u64);
+
+/// Error raised when the specified line cannot be found.
+#[derive(Copy, Clone, Debug)]
+pub struct LineError {}