Enum Context7Error 

pub enum Context7Error {
    RetriesExhausted {
        attempts: u32,
    },
    NoValidApiKey,
    InvalidResponse {
        status: u16,
    },
    ApiReturned400 {
        message: String,
    },
    LibraryNotFound {
        library_id: String,
    },
    KeysOperationFailed,
}

Structured errors for the Context7 API client.

Variants

RetriesExhausted

All available API keys have been exhausted after the given number of attempts.

Fields

attempts: u32

Number of attempts made before exhaustion.

NoValidApiKey

All keys failed due to authentication errors (401/403).

InvalidResponse

The API returned an unexpected HTTP status code.

Fields

status: u16

HTTP status code returned by the API.

ApiReturned400

The API returned HTTP 400 with an error message.

Fields

message: String

Error message returned by the API.

LibraryNotFound

The requested library was not found (HTTP 404).

Fields

library_id: String

Library identifier that was not found.

KeysOperationFailed

A keys operation failed (e.g., invalid index, no keys stored). The caller already printed a user-friendly message; this signals exit code 1.

Implementations

impl Context7Error

pub fn exit_code(&self) -> i32

Maps each error variant to a BSD-style exit code (sysexits.h).

Code	Constant	Meaning
1	generic	Unspecified runtime error
65	EX_DATAERR	Invalid input data
66	EX_NOINPUT	Requested resource not found
69	EX_UNAVAILABLE	Service unavailable after retry
74	EX_IOERR	I/O or network error
77	EX_NOPERM	Permission / authentication denied

Trait Implementations

impl Debug for Context7Error

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

Formats the value using the given formatter.

impl Display for Context7Error

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

Formats the value using the given formatter.

impl Error for Context7Error

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.