Struct TimerBuilder 

pub struct TimerBuilder { /* private fields */ }

Builds and starts a timer with less boilerplate.

Implementations

impl TimerBuilder

pub fn once(delay: Duration) -> Self

Creates a builder for a one-time timer.

pub fn at(deadline: Instant) -> Self

Creates a builder for a one-time timer at a deadline.

pub fn recurring(schedule: RecurringSchedule) -> Self

Creates a builder for a recurring schedule.

pub fn callback_timeout(self, callback_timeout: Duration) -> Self

Sets a timeout for each callback execution.

pub fn retry_policy(self, retry_policy: RetryPolicy) -> Self

Retries failed callback executions according to the provided policy.

pub fn max_retries(self, max_retries: usize) -> Self

Retries failed callback executions up to max_retries times.

pub fn fixed_backoff(self, delay: Duration) -> Self

Applies a fixed delay between retry attempts.

pub fn linear_backoff(self, step: Duration) -> Self

Applies a linearly increasing delay between retry attempts.

pub fn exponential_backoff(self, base: Duration) -> Self

Applies an exponentially increasing delay between retry attempts.

pub fn paused_start(self) -> Self

Starts the timer in the paused state.

pub fn with_events_disabled(self) -> Self

Disables broadcast event emission for the timer.

pub fn label(self, label: impl Into<String>) -> Self

Sets a label for the started timer.

pub fn tag(self, key: impl Into<String>, value: impl Into<String>) -> Self

Adds a metadata tag for the started timer.

pub async fn start<F>(self, callback: F) -> Result<Timer, TimerError>

where F: TimerCallback + 'static,

Starts the configured timer and returns the handle.