Enum ErrorCategory 

#[non_exhaustive]
pub enum ErrorCategory {
    BadRequest,
    Unauthorized,
    Forbidden,
    NotFound,
    UnprocessableEntity,
    Conflict,
    RateLimited,
    Timeout,
    Unavailable,
    Internal,
}

A coarse classification every klauthed error maps onto.

The category is the single source of truth for cross-cutting policy — HTTP status, retryability, client-vs-server — so individual error types only have to answer “which category am I?” rather than re-deriving an HTTP code each.

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

Caller sent something invalid (validation, malformed input). 400.

Unauthorized

Authentication is missing or invalid. 401.

Forbidden

Authenticated but not allowed. 403.

NotFound

The target resource does not exist. 404.

UnprocessableEntity

The request was structurally valid but semantically unprocessable — e.g. a field value fails a business rule, a required relationship does not exist, or a constraint would be violated. 422.

Distinct from BadRequest: the server understood the request; it simply cannot be fulfilled as-is. Use this for validation errors surfaced after successful parsing.

Conflict

The request conflicts with current state. 409.

RateLimited

The caller has been rate limited. 429.

Timeout

The operation timed out. 504.

Unavailable

A dependency (DB, cache, broker, upstream) is unavailable. 503.

Internal

An unexpected server-side fault. 500.

Implementations

impl ErrorCategory

pub fn http_status(&self) -> u16

The conventional HTTP status for this category.

pub fn is_retryable(&self) -> bool

Whether retrying the operation might succeed (transient conditions).

pub fn is_client_error(&self) -> bool

Whether this represents a caller error (4xx) rather than a server fault.

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

A stable, lowercase label.

Trait Implementations

impl Clone for ErrorCategory

fn clone(&self) -> ErrorCategory

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for ErrorCategory

impl Debug for ErrorCategory

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCategory

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCategory

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

Formats the value using the given formatter.

impl Eq for ErrorCategory

impl Hash for ErrorCategory

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for ErrorCategory

fn eq(&self, other: &ErrorCategory) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for ErrorCategory

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for ErrorCategory