Enum FetchError 

pub enum FetchError {
    NetworkTimeout {
        repo: String,
        elapsed: Duration,
    },
    RateLimited {
        retry_after: Duration,
    },
    ModelNotFound {
        repo: String,
    },
    FileNotFound {
        repo: String,
        file: String,
    },
    CorruptFile {
        path: PathBuf,
        expected_hash: String,
        actual_hash: String,
    },
    InsufficientDisk {
        required: u64,
        available: u64,
    },
    OutOfMemory {
        required: u64,
        available: u64,
    },
    AuthenticationFailed {
        message: String,
    },
    MissingToken,
    InvalidRepoId {
        repo_id: String,
    },
    UnsupportedFormat {
        format: String,
    },
    PickleSecurityRisk,
    ConfigParseError {
        message: String,
    },
    ShapeMismatch {
        tensor: String,
        expected: Vec<usize>,
        actual: Vec<usize>,
    },
    Io(Error),
    Json(Error),
    SafeTensorsParseError {
        message: String,
    },
    LeaderboardNotFound {
        kind: String,
    },
    LeaderboardParseError {
        message: String,
    },
    HttpError {
        message: String,
    },
    GgufWriteError {
        message: String,
    },
}

Errors that can occur during HuggingFace operations

Designed for Jidoka (built-in quality) - explicit error types enable proper error handling and recovery strategies.

Variants

NetworkTimeout

Network timeout during download

Fields

repo: String

elapsed: Duration

RateLimited

Rate limited by HuggingFace API

Fields

retry_after: Duration

ModelNotFound

Model repository not found

Fields

repo: String

FileNotFound

File not found in repository

Fields

repo: String

file: String

CorruptFile

Downloaded file is corrupt (checksum mismatch)

Fields

path: PathBuf

expected_hash: String

actual_hash: String

InsufficientDisk

Insufficient disk space

Fields

required: u64

available: u64

OutOfMemory

Out of memory during model loading

Fields

required: u64

available: u64

AuthenticationFailed

Authentication failed

Fields

message: String

MissingToken

Missing authentication token

InvalidRepoId

Invalid repository ID format

Fields

repo_id: String

UnsupportedFormat

Unsupported model format

Fields

format: String

PickleSecurityRisk

SECURITY: PyTorch pickle file detected

ConfigParseError

Model config parsing error

Fields

message: String

ShapeMismatch

Tensor shape mismatch

Fields

tensor: String

expected: Vec<usize>

actual: Vec<usize>

Io(Error)

IO error

Json(Error)

JSON parsing error

SafeTensorsParseError

SafeTensors parsing error

Fields

message: String

LeaderboardNotFound

Leaderboard not found

Fields

kind: String

LeaderboardParseError

Leaderboard data parsing error

Fields

message: String

HttpError

HTTP request error

Fields

message: String

GgufWriteError

GGUF write/serialization error

Fields

message: String

Implementations

impl FetchError

pub fn is_retryable(&self) -> bool

Check if error is retryable

pub fn retry_after(&self) -> Option<Duration>

Get retry delay if applicable

pub fn is_security_risk(&self) -> bool

Check if error is a security concern

Trait Implementations

impl Debug for FetchError

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

Formats the value using the given formatter.

impl Display for FetchError

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

Formats the value using the given formatter.

impl Error for FetchError

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 FetchError

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for FetchError

fn from(source: Error) -> Self

Converts to this type from the input type.