Struct TimeoutClassifier 

pub struct TimeoutClassifier<C = SystemTimeoutClock> { /* private fields */ }

Pure timeout classifier for observability.

The TimeoutClassifier provides side-effect free timeout classification based on elapsed execution time. It is used to inspect execution duration relative to configured timeouts without performing any enforcement actions.

Invariants

• Classification is purely observational - no side effects or state changes.
• Given (timeout_secs, elapsed), classification is deterministic.

Implementations

impl TimeoutClassifier<SystemTimeoutClock>

pub fn new() -> Self

Creates a timeout classifier using the default system clock.

impl<C> TimeoutClassifier<C>

where C: TimeoutClock,

pub fn with_clock(clock: C) -> Self

Creates a timeout classifier with an explicit clock implementation.

pub fn classify( &self, timeout_secs: Option<u64>, elapsed: Duration, ) -> TimeoutClassification

Classifies elapsed execution relative to a configured timeout.

This is a pure, side-effect free operation that only inspects elapsed time and returns a deterministic classification.

pub fn execute_and_classify<T, F>( &self, timeout_secs: Option<u64>, operation: F, ) -> GuardedExecution<T>

where F: FnOnce() -> T,

Executes operation, captures elapsed time, and classifies timeout outcome.

The timeout decision is deterministic for a given (timeout_secs, elapsed). This method wraps the operation with timing but performs no enforcement.

Trait Implementations

impl<C: Clone> Clone for TimeoutClassifier<C>

fn clone(&self) -> TimeoutClassifier<C>

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl<C: Debug> Debug for TimeoutClassifier<C>

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

Formats the value using the given formatter.

impl Default for TimeoutClassifier<SystemTimeoutClock>

fn default() -> Self

Returns the “default value” for a type.