Struct LifecycleHandle 

pub struct LifecycleHandle { /* private fields */ }

RAII handle that runs a LifecycleDaemon’s lifecycle. Construction calls on_start; drop schedules on_stop on a detached task so the synchronous Drop impl can fire-and-forget the async shutdown.

For deterministic shutdown ordering (net aggregator shutdown waiting on the loop to fully drain before returning), use LifecycleHandle::stop instead of dropping.

Implementations

impl LifecycleHandle

pub async fn start( daemon: Arc<dyn LifecycleDaemon>, ) -> Result<Self, LifecycleError>

Construct a handle and run on_start synchronously against the async runtime. Errors abort — the handle is never created if start fails.

pub fn daemon(&self) -> &Arc<dyn LifecycleDaemon>

Borrow the underlying daemon for introspection. Operator tooling that wants type-erased access reads through this — the lifecycle handle alone doesn’t expose concrete daemon state.

pub async fn stop(self)

Shut the daemon down and await the teardown. Consumes the handle so a subsequent Drop doesn’t double-stop.

Trait Implementations

impl Drop for LifecycleHandle

fn drop(&mut self)

Executes the destructor for this type.

fn pin_drop(self: Pin<&mut Self>)

🔬This is a nightly-only experimental API. (pin_ergonomics)

Execute the destructor for this type, but different to Drop::drop, it requires self to be pinned.