bombay-rs 0.1.0

A pluggable process runtime over Bombay Behavior.
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47

//! bombay — a typed behavior runtime.
//!
//! The behavior half is [`behavior`]'s pure algebra (depended on, never
//! copied). Bombay Communication supplies the sole mailbox implementation. A
//! behavior is driven sequentially while its environment supplies events and
//! interprets effects. Runtime construction remains centralized in
//! [`System::spawn`]. Consumers that may publish an endpoint only after
//! initialization and its effects succeed use [`System::activate`].
//!
//! # Panic strategy
//!
//! Actor task panics are normalized as [`TaskOutcome::Panicked`], and terminal
//! retirement completes during unwinding. The runtime therefore requires
//! `panic = "unwind"`; abort-mode programs cannot preserve these public
//! lifecycle outcomes.

#[cfg(panic = "abort")]
compile_error!(
    "bombay requires panic=unwind to classify actor panics and complete terminal retirement"
);

// The behavior algebra, re-exported so actor users depend on one crate.
pub use behavior;

mod mailbox;
mod routing;
mod runtime;

// Terminal results are part of System's observable API; their implementation
// and all execution authority remain owned by Bombay Behavior Engine.
pub use bombay_engine::{RunError, RunExit};
pub(crate) use mailbox::{EventSender, EventSource, MailboxReceiver};
pub use mailbox::{MailboxAnchor, MailboxConfig, MailboxSender};
pub use routing::{
    ActorRef, AddressInUse, AddressRouter, DeliveryEndpoint, DeliveryRouter, EndpointRegistry,
    IncarnationEndpoint, MailboxDeliveryClosed, ObservesCreations, PeerObservationError,
    PeerObserver, RejectedDelivery, RouteSends, RoutingError, ShutdownRequestError,
};
pub(crate) use runtime::{
    ActorEnvironment, ChildLease, ChildRuntime, RuntimeBirthMode, SystemChildren,
};
pub use runtime::{
    BehaviorActivation, BehaviorRetirement, CreationFailure, Handle, LifecycleEvent, LifecycleSink,
    LifecycleTransition, NoLifecycle, RegistrationIdentity, RootActivation, RootEndpoint,
    RootOutcome, RootRetirement, RuntimeEffectError, ScheduleAfterError, System, SystemBirthError,
    TaskOutcome,
};