Enum DownloadError 

pub enum DownloadError {
    Reqwest(Error),
    ReqwestMiddleware(Error),
    Tokio(Error),
    Url(ParseError),
    Indicatif(TemplateError),
    Join(JoinError),
    Custom(String),
}

Error type returned by all fallible operations in this library.

Each variant wraps the underlying error from the relevant subsystem, so callers can pattern-match on specific failure modes or rely on the Display impl for a human-readable message.

Examples

use cc_downloader::download::{DownloadOptions, download_paths};
use cc_downloader::errors::DownloadError;

let options = DownloadOptions {
    snapshot: "CC-MAIN-2024-46".to_string(),
    data_type: "wet",
    dst: std::path::Path::new("./output"),
    ..Default::default()
};
match download_paths(options).await {
    Ok(_) => println!("Done"),
    Err(DownloadError::Custom(msg)) => eprintln!("Resource not found: {msg}"),
    Err(e) => eprintln!("Download failed: {e}"),
}

Variants

Reqwest(Error)

An error from the underlying HTTP client (reqwest).

ReqwestMiddleware(Error)

An error from the retry middleware (reqwest_middleware).

Tokio(Error)

An I/O error, either from tokio::io or the standard library.

Url(ParseError)

A URL parsing error.

Indicatif(TemplateError)

An error constructing a progress bar template (indicatif).

Join(JoinError)

A task join error from the async runtime.

Custom(String)

A domain-level error, e.g. an unrecognised snapshot reference or an inaccessible paths URL. The inner String contains the full message printed to the user.

Trait Implementations

impl Debug for DownloadError

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

Formats the value using the given formatter.

impl Display for DownloadError

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

Formats the value using the given formatter.

impl From<Error> for DownloadError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DownloadError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<Error> for DownloadError

fn from(err: Error) -> Self

Converts to this type from the input type.

impl From<JoinError> for DownloadError

fn from(err: JoinError) -> Self

Converts to this type from the input type.

impl From<ParseError> for DownloadError

fn from(err: ParseError) -> Self

Converts to this type from the input type.

impl From<String> for DownloadError

fn from(s: String) -> DownloadError

Converts to this type from the input type.

impl From<TemplateError> for DownloadError

fn from(err: TemplateError) -> Self

Converts to this type from the input type.