Enum RustvelloError 

#[non_exhaustive]
pub enum RustvelloError {
    Retry {
        reason: String,
    },
    ConcurrencyRetry {
        task_id: TaskId,
        reason: String,
    },
    Serialization {
        message: String,
    },
    TaskNotFound {
        task_id: TaskId,
    },
    TaskNotRegistered {
        task_id: TaskId,
    },
    CycleDetected {
        task_id: TaskId,
        message: String,
    },
    RunnerNotExecutable {
        task_id: TaskId,
        message: String,
    },
    TaskClassNotFound {
        task_id: TaskId,
    },
    InvocationNotFound {
        invocation_id: InvocationId,
    },
    InvalidStatusTransition {
        invocation_id: InvocationId,
        from_status: InvocationStatus,
        to_status: InvocationStatus,
        allowed_statuses: Vec<InvocationStatus>,
    },
    OwnershipViolation {
        invocation_id: InvocationId,
        from_status: InvocationStatus,
        to_status: InvocationStatus,
        current_owner: String,
        attempted_owner: String,
        reason: String,
    },
    StatusRaceCondition {
        invocation_id: InvocationId,
        previous_status: InvocationStatus,
        expected_status: InvocationStatus,
        actual_status: InvocationStatus,
    },
    TaskExecution {
        error_type: String,
        message: String,
        traceback: Option<String>,
    },
    Infrastructure {
        kind: InfraErrorKind,
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Configuration {
        message: String,
    },
    Internal {
        message: String,
    },
    NotSupported {
        backend: String,
        method: String,
    },
}

Root error type — mirrors pynenc’s exception hierarchy.

Each variant maps 1:1 to a pynenc exception class (see 302 §4).

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Retry

Task explicitly requested a retry

Fields

reason: String

ConcurrencyRetry

Concurrency control triggered a retry

Fields

task_id: TaskId

reason: String

Serialization

Serialization/deserialization error

Fields

message: String

TaskNotFound

Task definition not found in any registry

Fields

task_id: TaskId

TaskNotRegistered

Task exists but is not registered in this app instance

Fields

task_id: TaskId

CycleDetected

Dependency cycle detected in task graph

Fields

task_id: TaskId

message: String

RunnerNotExecutable

Runner cannot execute this task type

Fields

task_id: TaskId

message: String

TaskClassNotFound

Task class/type not found during deserialization

Fields

task_id: TaskId

InvocationNotFound

Invocation not found

Fields

invocation_id: InvocationId

InvalidStatusTransition

Invalid status transition attempted

Fields

invocation_id: InvocationId

from_status: InvocationStatus

to_status: InvocationStatus

allowed_statuses: Vec<InvocationStatus>

OwnershipViolation

Runner ownership violation during status transition

Fields

invocation_id: InvocationId

from_status: InvocationStatus

to_status: InvocationStatus

current_owner: String

attempted_owner: String

reason: String

StatusRaceCondition

Status changed between read and write (optimistic locking failure)

Fields

invocation_id: InvocationId

previous_status: InvocationStatus

expected_status: InvocationStatus

actual_status: InvocationStatus

TaskExecution

Task function raised an error during execution. Carries the original exception type name for retry matching.

Fields

error_type: String

message: String

traceback: Option<String>

Infrastructure

Unified infrastructure error with structured classification.

Fields

kind: InfraErrorKind

message: String

source: Option<Box<dyn Error + Send + Sync>>

Configuration

Configuration error

Fields

message: String

Internal

Generic internal error

Fields

message: String

NotSupported

Backend does not support this operation.

Fields

backend: String

method: String

Implementations

impl RustvelloError

pub fn state_backend(message: impl Into<String>) -> Self

State backend query/storage error (not retriable).

pub fn broker_err(message: impl Into<String>) -> Self

Broker messaging error (not retriable).

pub fn runner_err(message: impl Into<String>) -> Self

Runner infrastructure error.

pub fn connection_err(message: impl Into<String>) -> Self

Connection failure (retriable).

Trait Implementations

impl Debug for RustvelloError

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

Formats the value using the given formatter.

impl Display for RustvelloError

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

Formats the value using the given formatter.

impl Error for RustvelloError

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.