Enum ForgeError 

#[non_exhaustive]
pub enum ForgeError {
    Config {
        context: String,
        source: Option<Box<dyn Error + Sync + Send>>,
    },
    Database(Error),
    JobCancelled(String),
    Serialization(String),
    Deserialization(String),
    Io(Error),
    InvalidArgument(String),
    NotFound(String),
    Unauthorized(String),
    Forbidden(String),
    Validation(String),
    Timeout(String),
    Internal {
        context: String,
        source: Option<Box<dyn Error + Sync + Send>>,
    },
    InvalidState(String),
    RateLimitExceeded {
        retry_after: Duration,
        limit: u32,
        remaining: u32,
    },
    ServiceUnavailable(String),
    WorkflowSuspended(SuspendReason),
}

Core error type mapping variants to HTTP status codes.

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.

Config

Fields

context: String

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

Database(Error)

JobCancelled(String)

Serialization(String)

Deserialization(String)

Io(Error)

InvalidArgument(String)

NotFound(String)

Unauthorized(String)

Forbidden(String)

Validation(String)

Timeout(String)

Internal

Fields

context: String

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

InvalidState(String)

RateLimitExceeded

Fields

retry_after: Duration

limit: u32

remaining: u32

ServiceUnavailable(String)

Service unavailable (503).

WorkflowSuspended(SuspendReason)

Internal control signal raised when a workflow handler suspends (ctx.sleep(...) / ctx.wait_for_event(...)). The executor handles it before any HTTP mapping layer; it is never returned to a client.

Implementations

impl ForgeError

pub fn not_found(msg: impl Into<String>) -> ForgeError

pub fn config(msg: impl Into<String>) -> ForgeError

pub fn unauthorized(msg: impl Into<String>) -> ForgeError

pub fn forbidden(msg: impl Into<String>) -> ForgeError

pub fn validation(msg: impl Into<String>) -> ForgeError

pub fn timeout(msg: impl Into<String>) -> ForgeError

pub fn internal(msg: impl Into<String>) -> ForgeError

pub fn internal_with( msg: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> ForgeError

pub fn config_with( msg: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> ForgeError

pub fn http_status(&self) -> u16

Canonical variant-to-HTTP-status mapping.

pub fn is_client_error(&self) -> bool

pub fn is_server_error(&self) -> bool

pub fn is_retryable(&self) -> bool

Trait Implementations

impl Debug for ForgeError

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

Formats the value using the given formatter.

impl Display for ForgeError

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

Formats the value using the given formatter.

impl Error for ForgeError

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<CircuitBreakerError> for ForgeError

fn from(e: CircuitBreakerError) -> ForgeError

Converts to this type from the input type.

impl From<Error> for ForgeError

fn from(source: Error) -> ForgeError

Converts to this type from the input type.

impl From<Error> for ForgeError

fn from(source: Error) -> ForgeError

Converts to this type from the input type.

impl From<Error> for ForgeError

fn from(e: Error) -> ForgeError

Converts to this type from the input type.