Enum ActivityError 

pub enum ActivityError {
    Retry(String),
    NonRetry(String),
}

Error type for activity operations that supports retry semantics.

This enum distinguishes between errors that should trigger a retry and those that indicate permanent failure.

Examples

use runner_q::ActivityError;
use runner_q::ActivityHandlerResult;

// Retryable error - temporary network issue
let retry_error = ActivityError::Retry("Network timeout".to_string());

// Non-retryable error - invalid input data
let permanent_error = ActivityError::NonRetry("Invalid user ID format".to_string());

// Using in activity handlers
fn process_user_data(payload: serde_json::Value) -> ActivityHandlerResult {
    let user_id = payload["user_id"].as_str()
        .ok_or_else(|| ActivityError::NonRetry("Missing user_id".to_string()))?;
     
    if user_id.is_empty() {
        return Err(ActivityError::NonRetry("Empty user_id".to_string()));
    }
     
    // Simulate processing that might fail temporarily
    if payload["retry_processing"].as_bool().unwrap_or(false) {
        Err(ActivityError::Retry("Processing failed, will retry".to_string()))
    } else {
        Ok(Some(serde_json::json!({"processed": true})))
    }
}

Variants

Retry(String)

Error that should trigger a retry attempt.

Use this for temporary failures like network timeouts, temporary service unavailability, or other transient issues that might resolve on retry.

NonRetry(String)

Error that should not trigger a retry.

Use this for permanent failures like invalid input data, authentication errors, or other issues that won’t be resolved by retrying.

Trait Implementations

impl Debug for ActivityError

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

Formats the value using the given formatter.

impl Display for ActivityError

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

Formats the value using the given formatter.

impl Error for ActivityError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0: use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0: replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for ActivityError

fn from(error: Error) -> Self

Converts to this type from the input type.

impl From<Error> for ActivityError

fn from(error: Error) -> Self

Converts to this type from the input type.