Enum ErrorCode 

#[non_exhaustive]
pub enum ErrorCode {
    ServiceUnavailable,
    ConnectionFailed,
    Timeout,
    RateLimited,
    NotFound,
    AlreadyExists,
    Conflict,
    InvalidInput,
    MissingField,
    InvalidFormat,
    Unauthorized,
    Forbidden,
    TokenExpired,
    InvalidToken,
    Internal,
    DatabaseError,
    ExternalService,
    Cancelled,
}

Machine-readable error code.

Defined as an enum so downstream code gets exhaustive match checking. #[non_exhaustive] allows new variants to be added without a SemVer break.

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.

ServiceUnavailable

The downstream service is unavailable; retryable.

ConnectionFailed

Could not establish a connection to a dependency; retryable.

Timeout

An operation exceeded its deadline; retryable.

RateLimited

Request was rejected because a rate limit was exceeded; retryable.

NotFound

The requested resource does not exist.

AlreadyExists

A resource with the same identity already exists.

Conflict

The request conflicts with the current state of a resource.

InvalidInput

One or more input fields failed validation.

MissingField

A required field was absent from the request.

InvalidFormat

A field value could not be parsed into the expected format.

Unauthorized

The caller has not been authenticated.

Forbidden

The caller is authenticated but does not have permission.

TokenExpired

The authentication token has expired.

InvalidToken

The authentication token is malformed or unrecognised.

Internal

An unexpected internal error occurred.

DatabaseError

A database operation failed.

ExternalService

An external service returned an error; retryable.

Cancelled

The operation was cancelled by the caller or system before completion (e.g., context cancellation, client disconnect).

Implementations

impl ErrorCode

pub fn is_retryable(self) -> bool

Returns true for transient errors worth retrying.

pub fn http_status(self) -> StatusCode

Canonical HTTP status code for this error.

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

Stable string representation (for logging / serialisation).

pub fn from_wire(value: &str) -> Option<Self>

Parse the stable string produced by as_str back into a code — the inverse of as_str.

Returns None for an unrecognised string (for example a code introduced by a newer peer over a versioned wire), letting callers choose a typed fallback rather than guessing. The mapping is kept in lock-step with as_str by a parity test.

Trait Implementations

impl Clone for ErrorCode

fn clone(&self) -> ErrorCode

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Copy for ErrorCode

impl Debug for ErrorCode

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for ErrorCode

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for ErrorCode

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

Formats the value using the given formatter.

impl Eq for ErrorCode

impl Hash for ErrorCode

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 ErrorCode

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ErrorCode

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 ErrorCode