Enum CoolError 

#[non_exhaustive]
pub enum CoolError {
    BadRequest(String),
    NotAcceptable(String),
    Unauthorized(String),
    UnsupportedMediaType(String),
    Forbidden(String),
    NotFound(String),
    Conflict(String),
    Validation(String),
    PreconditionFailed(String),
    Codec(String),
    Database(String),
    DatabaseTyped(DbErrorInfo),
    Internal(String),
}

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.

BadRequest(String)

4xx — String is the public message returned to the client.

NotAcceptable(String)

Unauthorized(String)

UnsupportedMediaType(String)

Forbidden(String)

NotFound(String)

Conflict(String)

Validation(String)

PreconditionFailed(String)

Codec(String)

5xx — String is operator-only detail. Never returned to clients; the public message is a fixed canned string per variant.

Database(String)

Database error with only a stringified detail. Preserved for back-compat; new code should prefer DatabaseTyped produced by cratestack_sqlx::cool_error_from_sqlx.

DatabaseTyped(DbErrorInfo)

Database error with structured information preserved from the driver.

Use CoolError::db_sqlstate and CoolError::db_constraint to access the typed fields without matching on this variant directly.

Internal(String)

Implementations

impl CoolError

pub fn code(&self) -> &'static str

pub fn status_code(&self) -> StatusCode

pub fn public_message(&self) -> Cow<'_, str>

Public, safe-to-expose message returned in HTTP responses.

For 4xx variants this is the caller-supplied string. For 5xx variants this is a fixed canned message; the caller-supplied string flows to detail instead and is recorded via tracing only.

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

Operator-only detail string. For 5xx variants this is the message supplied at construction time; for 4xx variants this returns the same string as public_message (callers are expected to pre-redact 4xx messages they emit).

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

Returns the SQLSTATE code if this is a DatabaseTyped error with a known code (e.g. "23505" for unique_violation).

Always returns None for the legacy Database(String) variant; to get typed access, use cratestack_sqlx::cool_error_from_sqlx at the conversion site.

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

Returns the constraint name if this is a DatabaseTyped error that carries constraint information (e.g. "accounts_email_key").

Always returns None for the legacy Database(String) variant; to get typed access, use cratestack_sqlx::cool_error_from_sqlx at the conversion site.

pub fn into_response(self) -> CoolErrorResponse

Trait Implementations

impl Debug for CoolError

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

Formats the value using the given formatter.

impl Display for CoolError

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

Formats the value using the given formatter.

impl Error for CoolError

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.