Struct Worker 

pub struct Worker<Adapter, Handler> { /* private fields */ }

Runtime-neutral consumer loop over one Queue topic.

The worker owns the retry ceiling, the exponential backoff, and the dead-letter route; the adapter only has to honour the visibility delay passed to Queue::nack. It never spawns a thread or reads a clock, so it runs unchanged on any executor.

Implementations

impl<Adapter, Handler> Worker<Adapter, Handler>

pub fn new(queue: Adapter, topic: impl Into<String>, handler: Handler) -> Self

Creates a worker that consumes topic with handler.

pub const fn with_retry(self, retry: RetryPolicy) -> Self

Replaces the retry policy.

pub fn with_dead_letter(self, dead_letter: DeadLetter) -> Self

Replaces the dead-letter destination.

pub const fn with_idle_backoff(self, idle_backoff: Duration) -> Self

Sets how long Worker::run waits after an empty poll.

pub fn topic(&self) -> &str

Returns the consumed topic.

impl<Adapter, Handler, HandlerFuture> Worker<Adapter, Handler>

where Adapter: Queue, Handler: Fn(Delivery) -> HandlerFuture + Send + Sync, HandlerFuture: Future<Output = Result<(), JobError>> + Send,

pub async fn step(&self) -> Result<WorkerStep, QueueError>

Runs one receive, dispatch, and settle cycle.

Errors

Returns the adapter failure raised by receive, ack, nack, or the dead-letter publish. A handler failure is not an error: it is settled by the retry policy and reported in the WorkerStep.

pub async fn run<Sleep, SleepFuture>( &self, sleep: Sleep, ) -> Result<(), QueueError>

where Sleep: Fn(Duration) -> SleepFuture, SleepFuture: Future<Output = ()>,

Runs cycles until the adapter fails, awaiting sleep on an empty poll.

The caller owns the loop’s lifetime and its timer: race this future against a shutdown signal from its own runtime.

Errors

Returns the first adapter failure raised by a cycle.