Struct ServiceLifecycle 

pub struct ServiceLifecycle { /* private fields */ }

Full lifecycle tracker for a single supervised service.

Wraps the ServicePhase enum with timing data, counters, and transition validation logic. The supervisor holds one of these per managed service.

Implementations

impl ServiceLifecycle

pub fn new(service_name: impl Into<String>) -> Self

Create a new lifecycle tracker in the Starting phase.

pub fn phase(&self) -> ServicePhase

Current lifecycle phase.

pub fn service_name(&self) -> &str

Service name as configured on construction.

pub fn age(&self) -> Duration

How long the service has existed (since first Starting).

pub fn time_in_current_phase(&self) -> Duration

How long the service has been in its current phase.

pub fn start_count(&self) -> u32

Total number of times the service has been started.

pub fn total_failures(&self) -> u32

Total failures over the service’s lifetime.

pub fn last_error(&self) -> Option<&str>

The last error message recorded on a failed transition, if any.

pub fn termination_reason(&self) -> Option<&TerminationReason>

Why the service terminated (only Some when phase is Terminated).

pub fn cumulative_running_time(&self) -> Duration

Cumulative wall-clock time spent in the Running phase.

If the service is currently running, includes time up to now.

pub fn transition_to_running(&mut self) -> Result<(), TransitionError>

Move from Starting to Running.

pub fn transition_to_backing_off( &mut self, error: &str, backoff_duration: Duration, ) -> Result<(), TransitionError>

Move from Running (or Starting) to BackingOff after a failure.

pub fn transition_to_restarting(&mut self) -> Result<(), TransitionError>

Transition from BackingOff → Starting (retry).

pub fn transition_to_stopping(&mut self) -> Result<(), TransitionError>

Move to Stopping on cancellation — services drain after this.

pub fn transition_to_terminated( &mut self, reason: TerminationReason, ) -> Result<(), TransitionError>

Transition to Terminated. Terminal — no further transitions allowed.

Trait Implementations

impl Clone for ServiceLifecycle

fn clone(&self) -> ServiceLifecycle

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for ServiceLifecycle

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

Formats the value using the given formatter.

impl Display for ServiceLifecycle

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

Formats the value using the given formatter.

impl From<&ServiceLifecycle> for ServiceLifecycleSnapshot

fn from(lc: &ServiceLifecycle) -> Self

Converts to this type from the input type.