orbit-events
orbit-events provides a bounded topic and byte-payload stream for processes
in the same Orbit fleet. Applications normally use it through
orbitive::events; direct package access remains available.
use Arc;
use OrbitEventBus;
use Fleet;
let fleet = new;
let bus = new;
let mut cursor = bus.cursor_at_head;
bus.publish?;
let poll = bus.poll;
assert_eq!;
assert_eq!;
# Ok::
All topics share one per-node ring, and every subscriber owns an independent
cursor. Polling advances the cursor across every observed frame. A topic filter
changes which events are returned, not which frames are consumed. If the
cursor falls behind the retained window, OrbitEventPoll::lagged reports the
loss.
On Linux and FreeBSD, an SHM-backed bus can create a process-local
RingEventFd. Consumers drain that readiness signal and then poll the ring;
the fd does not carry event data, and wakeups may coalesce.
The crate does not provide acknowledgement, durable replay, consumer groups, typed serialization, handler dispatch, or network transport.