Enum FetchError 

#[non_exhaustive]
pub enum FetchError {
    Api(ApiError),
    Io {
        path: PathBuf,
        source: Error,
    },
    RepoNotFound {
        repo_id: String,
    },
    Auth {
        reason: String,
    },
    InvalidPattern {
        pattern: String,
        reason: String,
    },
    Checksum {
        filename: String,
        expected: String,
        actual: String,
    },
    Timeout {
        filename: String,
        seconds: u64,
    },
    PartialDownload {
        path: Option<PathBuf>,
        failures: Vec<FileFailure>,
    },
    ChunkedDownload {
        filename: String,
        reason: String,
    },
    Http(String),
    InvalidArgument(String),
    NoFilesMatched {
        repo_id: String,
    },
}

Errors that can occur during model fetching.

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.

Api(ApiError)

The hf-hub API returned an error.

Io

An I/O error occurred while accessing the local filesystem.

Fields

path: PathBuf

The path that caused the error.

source: Error

The underlying I/O error.

RepoNotFound

The repository was not found or is inaccessible.

Fields

repo_id: String

The repository identifier that was not found.

Auth

Authentication failed (missing or invalid token).

Reserved for future use. Currently, auth failures surface as FetchError::Api because hf-hub does not distinguish them.

Fields

reason: String

Description of the authentication failure.

InvalidPattern

An invalid glob pattern was provided for filtering.

Fields

pattern: String

The glob pattern that failed to parse.

reason: String

Description of the parse error.

Checksum

SHA256 checksum mismatch after download.

Fields

filename: String

The filename that failed verification.

expected: String

The expected SHA256 hex digest.

actual: String

The actual SHA256 hex digest computed from the file.

Timeout

A download operation timed out.

Fields

filename: String

The filename that timed out.

seconds: u64

The timeout duration in seconds.

PartialDownload

One or more files failed to download.

Contains the successful path and a list of per-file failures.

Fields

path: Option<PathBuf>

The snapshot directory (if any files succeeded).

failures: Vec<FileFailure>

Per-file failure details.

ChunkedDownload

A chunked (multi-connection) download failed.

Fields

filename: String

The filename that failed.

reason: String

Description of the failure.

Http(String)

An HTTP request to the HuggingFace API failed.

InvalidArgument(String)

An invalid argument was provided.

NoFilesMatched

The repository exists but no files matched after filtering, or the repository contains no files at all.

Fields

repo_id: String

The repository identifier.

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<ApiError> for FetchError

fn from(source: ApiError) -> Self

Converts to this type from the input type.