Struct Runtime 

pub struct Runtime { /* private fields */ }

A composed kindling integration: a client (and durable-emit spooled client) over a daemon the runtime either started in-process or attached to.

Owns the embedded server task handle (when SpawnStrategy::Embedded), so shutdown can stop it.

Dropping a Runtime without calling shutdown does not stop an embedded daemon: the serve task was spawned onto the tokio runtime and keeps running until the runtime itself shuts down (or the daemon idles out). Call shutdown for deterministic teardown.

Implementations

impl Runtime

pub async fn start(config: RuntimeConfig) -> Result<Self, RuntimeError>

Start the runtime: build a client for the configured socket and wire the SpawnStrategy. Probes the daemon with a health call (which triggers attach-or-spawn) so a started runtime is immediately usable.

pub fn client(&self) -> &Client

Borrow the underlying daemon client for reads and non-spooled ops (health, retrieve, capsules, pins, …).

pub fn spooled_client(&self) -> &SpooledClient

Borrow the durable-emit spooled client. Append through this for outage-resilient writes.

pub fn strategy(&self) -> &SpawnStrategy

The SpawnStrategy this runtime was started with.

pub fn spawned_embedded_daemon(&self) -> bool

Whether this runtime started an embedded daemon (true) or attached to a pre-existing one (false). Only meaningful for SpawnStrategy::Embedded.

pub async fn shutdown(self) -> Result<(), RuntimeError>

Stop the runtime, aborting the embedded daemon task if this runtime started one. Attached daemons (started elsewhere) are left running.

Trait Implementations

impl Debug for Runtime

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.