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.

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, 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>

Transition from Starting → Running.

Called when the service’s run() method is entered.

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

Transition from Running → BackingOff.

Called when the service’s run() returns an Err.

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

Transition from BackingOff → Starting (retry).

Called when the backoff timer has expired and the supervisor is about to restart the service.

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

Transition to Stopping from any alive phase.

Called when the cancellation token is triggered.

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

Transition to Terminated from Stopping, Running, Starting, or BackingOff.

This is the terminal state; no further transitions are 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.