Struct Lifecycle 

pub struct Lifecycle { /* private fields */ }

Process/engine lifecycle with atomic admission and active-op accounting.

Admission and op registration happen in one synchronized path so shutdown cannot race a half-admitted operation.

Implementations

impl Lifecycle

pub fn new() -> Self

pub fn state(&self) -> LifecycleState

pub fn active_ops(&self) -> usize

pub fn try_begin_op(&self) -> Result<OpAdmission<'_>, AdmissionError>

Atomically admit one operation if still Running.

On success, active count is incremented; caller MUST drop the returned OpAdmission (or call Self::end_op) when the op finishes.

pub fn shutdown(&self, timeout: Duration) -> Result<(), ShutdownError>

Close admission and wait for active ops to reach zero.

On success transitions to Stopped. On timeout leaves ShuttingDown and returns ShutdownError::Busy — does not claim completion and does not authorize cache clears.

Idempotent: calling while already Stopped succeeds. Calling while ShuttingDown continues waiting for the remaining active count.

pub fn mark_stopped_if_idle(&self) -> bool

Force Stopped only when active is zero (test helper / finalizer).

pub fn is_running(&self) -> bool

Whether new work may be admitted.

Trait Implementations

impl Debug for Lifecycle

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

Formats the value using the given formatter.

impl Default for Lifecycle

fn default() -> Self

Returns the “default value” for a type.