Enum BosonError 

pub enum BosonError {
    TaskNotFound(String),
    JobNotFound(String),
    RunNotFound(String),
    TaskConfigNotFound(String),
    ParamError(String),
    SignatureMismatch {
        expected: String,
        actual: String,
    },
    InvalidConfig(String),
    Backend {
        message: String,
        source: Option<Box<dyn StdError + Send + Sync>>,
    },
    Internal {
        message: String,
        source: Option<Box<dyn StdError + Send + Sync>>,
    },
    RateLimited(String),
    UnknownBackend(String),
}

Errors that can occur in Boson operations.

Variants

TaskNotFound(String)

Task not found in registry.

JobNotFound(String)

Job not found.

RunNotFound(String)

Run not found.

TaskConfigNotFound(String)

Task config not found.

ParamError(String)

Parameter serialization/deserialization error.

SignatureMismatch

Signature mismatch between job and current task.

Fields

expected: String

Expected signature from the enqueued job.

actual: String

Current task signature in the registry.

InvalidConfig(String)

Invalid priority or pool.

Backend

Persistence / adapter backend failure.

Fields

message: String

Operator-safe summary (stable for logs and HTTP bodies).

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

Optional underlying adapter error for Error::source chains.

Internal

Internal error.

Fields

message: String

Operator-safe summary.

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

Optional underlying cause for Error::source chains.

RateLimited(String)

Enqueue blocked by rate limit or in-flight cap; caller should retry after backoff.

UnknownBackend(String)

Named queue backend not registered on the router.

Implementations

impl BosonError

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

Backend failure without an underlying source.

pub fn backend_source( message: impl Into<String>, source: impl StdError + Send + Sync + 'static, ) -> Self

Backend failure wrapping an underlying error.

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

Internal failure without an underlying source.

pub fn internal_source( message: impl Into<String>, source: impl StdError + Send + Sync + 'static, ) -> Self

Internal failure wrapping an underlying error.

pub fn backend_message(&self) -> Option<&str>

Message text for Self::Backend, if this is a backend error.

pub fn is_backend_unique_violation(&self) -> bool

True when a backend adapter reported a unique / duplicate-key constraint failure.

Trait Implementations

impl Debug for BosonError

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

Formats the value using the given formatter.

impl Display for BosonError

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

Formats the value using the given formatter.

impl Error for BosonError

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 BosonError

fn from(err: Error) -> Self

Converts to this type from the input type.