Enum Error 

#[non_exhaustive]
pub enum Error {
    NotFound {
        uri: String,
    },
    NotModified {
        uri: String,
    },
    Unauthenticated {
        message: String,
    },
    PermissionDenied {
        message: String,
    },
    RateLimited {
        retry_after_ms: u64,
    },
    Http {
        status: u16,
        message: String,
    },
    InvalidUrl {
        message: String,
    },
    Crawl {
        source_kind: &'static str,
        message: String,
    },
    Extract {
        message: String,
    },
    Embed {
        message: String,
    },
    Format {
        message: String,
    },
    DimMismatch {
        index: usize,
        query: usize,
    },
    Timeout {
        duration_ms: u64,
    },
    Backend {
        backend: &'static str,
        message: String,
    },
    Io {
        source: Error,
    },
}

The unified error type for every link-r operation.

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.

NotFound

A resource (page, index file) could not be found.

Fields

uri: String

The URI/path that was missing.

NotModified

The remote returned 304 Not Modified — used as the unchanged sentinel for incremental rebuilds.

Fields

uri: String

The URI that was unchanged.

Unauthenticated

Authentication was required and failed or was missing.

Fields

message: String

Human-readable detail.

PermissionDenied

The credential was valid but lacked permission.

Fields

message: String

Human-readable detail.

RateLimited

The remote rate-limited us; retry after the given delay.

Fields

retry_after_ms: u64

Suggested backoff in milliseconds (from Retry-After / x-ratelimit-reset).

Http

A non-success HTTP status that isn’t modelled more specifically.

Fields

status: u16

The HTTP status code.

message: String

Human-readable detail.

InvalidUrl

A malformed or unsupported URL.

Fields

message: String

Human-readable detail.

Crawl

Discovery/crawl failed for a source.

Fields

source_kind: &'static str

The source kind (e.g. "http", "fs").

message: String

Human-readable detail.

Extract

Content extraction failed.

Fields

message: String

Human-readable detail.

Embed

Embedding failed.

Fields

message: String

Human-readable detail.

Format

The on-disk index format was invalid or corrupt.

Fields

message: String

Human-readable detail.

DimMismatch

A query/index dimension mismatch (e.g. searching with the wrong embedder).

Fields

index: usize

The index’s embedding dimension.

query: usize

The query vector’s dimension.

Timeout

An operation timed out.

Fields

duration_ms: u64

The elapsed budget in milliseconds.

Backend

An error originating from a named backend dependency.

Fields

backend: &'static str

The backend that produced the error (e.g. "reqwest", "fastembed").

message: String

Human-readable detail.

Io

An underlying I/O error.

Fields

source: Error

The wrapped I/O error.

Implementations

impl Error

pub fn not_found(uri: impl Into<String>) -> Self

Construct a Error::NotFound.

pub fn not_modified(uri: impl Into<String>) -> Self

Construct a Error::NotModified.

pub fn unauthenticated(message: impl Into<String>) -> Self

Construct a Error::Unauthenticated.

pub fn permission_denied(message: impl Into<String>) -> Self

Construct a Error::PermissionDenied.

pub fn rate_limited(retry_after_ms: u64) -> Self

Construct a Error::RateLimited.

pub fn http(status: u16, message: impl Into<String>) -> Self

Construct a Error::Http.

pub fn invalid_url(message: impl Into<String>) -> Self

Construct a Error::InvalidUrl.

pub fn crawl(source_kind: &'static str, message: impl Into<String>) -> Self

Construct a Error::Crawl.

pub fn extract(message: impl Into<String>) -> Self

Construct a Error::Extract.

pub fn embed(message: impl Into<String>) -> Self

Construct a Error::Embed.

pub fn format(message: impl Into<String>) -> Self

Construct a Error::Format.

pub fn backend(backend: &'static str, message: impl Into<String>) -> Self

Construct a Error::Backend.

pub fn is_retriable(&self) -> bool

Whether retrying the failed operation could plausibly succeed.

Drives backoff in the fetch/crawl layer: timeouts, rate limits, transient HTTP 5xx/408/429, and recoverable I/O conditions are retriable; logical errors (not found, auth, format) are not.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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 Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

graph-r core (byte codecs, container, mmap) reports malformed images as format errors; its I/O stays I/O.

fn from(e: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.