Enum RuntimeError 

pub enum RuntimeError {
    Io(Error),
    ChannelClosed,
    ChannelFull,
    BlockingInAsyncContext,
    Timeout,
    Cancelled,
    TaskPanicked(Box<str>),
    NoRuntime,
    ScopeClosed,
    ScopeDrainTimeout(usize),
    Http(Arc<str>),
    BadRequest(Box<str>),
    MalformedBody(Box<str>),
    Multipart(Box<str>),
    Database(Box<str>),
    Tls(Box<str>),
    InvalidArgument(Box<str>),
    Schedule(Box<str>),
    MessageQueue(Box<str>),
    Config(Box<str>),
    Secret(Box<str>),
    Dns(Box<str>),
    Acme(Box<str>),
}

Common error type used across Camber runtime, HTTP, and support modules.

Variants

Io(Error)

Wrapper for underlying I/O failures.

ChannelClosed

A channel send or receive failed because the other side was dropped.

ChannelFull

A non-blocking channel send failed because the buffer is full.

BlockingInAsyncContext

A blocking operation was requested from a single-thread async executor.

Timeout

An operation exceeded its configured timeout.

Cancelled

Cooperative cancellation was requested.

TaskPanicked(Box<str>)

A spawned task unwound with a panic payload.

NoRuntime

A runtime-requiring entry point was called with no runtime context.

ScopeClosed

Admission was attempted at or after the root scope’s close transition.

ScopeDrainTimeout(usize)

The bounded scope drain expired before every child exited on its own, carrying how many the boundary found outstanding. Only the async subset of that count was then aborted and joined: a non-preemptible blocking child is counted here and cannot be force-stopped at all. So this counts children that failed to exit cooperatively — not children still running when run returns, and not children the drain managed to stop.

Http(Arc<str>)

An HTTP client, server, or protocol-level failure occurred.

BadRequest(Box<str>)

The caller supplied invalid request data.

MalformedBody(Box<str>)

A request body could not be parsed as its declared representation.

Carries the parser’s own account of the failure, which is operator detail: the HTTP rejection boundary answers the peer with fixed safe text and never with this string.

Multipart(Box<str>)

A multipart/form-data body could not be parsed.

Held apart from RuntimeError::MalformedBody so the two parsers stay distinguishable through a handler’s ?, rather than being told apart later by their text.

Database(Box<str>)

A database interaction failed.

Camber never constructs this variant — it ships no database layer. It is provided so an application’s own data access code can report through the same RuntimeError its handlers already return, instead of introducing a second error type and a conversion at every ?.

Tls(Box<str>)

TLS setup or handshake failed.

InvalidArgument(Box<str>)

A public API was called with an invalid argument.

Schedule(Box<str>)

Schedule parsing or execution setup failed.

MessageQueue(Box<str>)

A message queue transport or protocol error occurred.

Config(Box<str>)

Configuration loading or validation failed.

Secret(Box<str>)

Secret loading or decoding failed.

Dns(Box<str>)

DNS provider or lookup handling failed.

Acme(Box<str>)

ACME certificate provisioning or renewal failed.

Trait Implementations

impl Debug for RuntimeError

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

Formats the value using the given formatter.

impl Display for RuntimeError

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

Formats the value using the given formatter.

impl Error for RuntimeError

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 RuntimeError

fn from(source: Error) -> Self

Converts to this type from the input type.