Struct ApplicationLifecycle 

pub struct ApplicationLifecycle { /* private fields */ }

Shared process-local readiness and graceful-drain coordinator.

Required component labels are immutable and intentionally absent from the public health payload. Applications update them only after performing their own authenticated dependency checks. This type does not discover services, coordinate replicas, or authorize domain requests.

Implementations

impl ApplicationLifecycle

pub fn new() -> Self

Creates a lifecycle in the Starting phase without required components.

pub fn with_required_components<I, S>( components: I, ) -> Result<Self, ApplicationLifecycleError>

where I: IntoIterator<Item = S>, S: Into<String>,

Creates a lifecycle with an immutable bounded set of required components.

pub fn phase(&self) -> ApplicationPhase

Returns the current monotonic phase.

pub fn mark_ready(&self) -> Result<(), ApplicationLifecycleError>

Marks startup complete without overriding required component states.

pub fn set_component_ready( &self, component: impl Into<String>, ready: bool, ) -> Result<(), ApplicationLifecycleError>

Updates one pre-registered dependency readiness bit.

pub fn begin_draining(&self) -> Result<(), ApplicationLifecycleError>

Begins a monotonic drain and rejects all subsequent application requests.

pub fn mark_stopped(&self)

Marks the lifecycle stopped. This terminal transition is idempotent.

pub fn snapshot(&self) -> ReadinessSnapshot

Returns a secret-minimized readiness snapshot.

pub fn in_flight_requests(&self) -> usize

Returns admitted requests whose handler or HTTP response body is still active. Upgraded connections and detached background work require separate tracking.

pub async fn wait_for_drain( &self, timeout: Duration, ) -> Result<(), ApplicationLifecycleError>

Waits for admitted handlers and response bodies to finish or be dropped. This does not wait for client acknowledgement or upgraded connections.

Trait Implementations

impl Clone for ApplicationLifecycle

fn clone(&self) -> Self

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ApplicationLifecycle

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

Formats the value using the given formatter.

impl Default for ApplicationLifecycle

fn default() -> Self

Returns the “default value” for a type.