Enum JobResult 

pub enum JobResult {
    Completed,
    RetryAfter(Duration),
    Snooze(Duration),
    Cancel(String),
    WaitForCallback(CallbackGuard),
}

Result of executing a job handler.

Picking the right variant for re-runs

Three primitives can put the job back on the queue. They differ in what they say about why:

Primitive	Means	Increments attempt	Delay shape
JobError::Retryable	“this attempt failed; try again”	yes	DB-computed exponential backoff
JobResult::RetryAfter	“this attempt failed; try again after delay X”	yes	caller-specified
JobResult::Snooze	“this attempt didn’t fail — it’s just not time yet”	no	caller-specified

Rule of thumb: if every “non-success” return is a “not yet” rather than a failure (polling, waiting for an upstream signal, rate limiting), use Snooze so max_attempts keeps its plain meaning of bounding genuine failures. If the handler observed a real failure and wants a specific retry delay rather than the default exponential backoff, use RetryAfter. See awa/examples/poll_until_deadline.rs for a deadline-bounded polling example.

Variants

Completed

Job completed successfully.

RetryAfter(Duration)

Job should be retried after the given duration. Increments attempt. Use when this attempt failed and you want a caller-specified delay instead of the default exponential backoff produced by JobError::Retryable.

Snooze(Duration)

Job should be re-scheduled after the given duration without counting as a failed attempt. Use for polling-style waits where each “not yet” probe is normal — max_attempts should only bound genuine handler failures, not the polling cadence.

Cancel(String)

Job should be cancelled. Records the reason in the job’s errors column and sets state to cancelled — no DLQ, no failure event. Use for graceful give-up (e.g. handler-side deadline expiry, user-requested abort).

WaitForCallback(CallbackGuard)

Job is waiting for an external callback (webhook completion).

Obtain the required guard from ctx.register_callback() or ctx.register_callback_with_config().

Trait Implementations

impl Debug for JobResult

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

Formats the value using the given formatter.