Enum PlanError 

pub enum PlanError {
    BuildClient(Error),
    Prefetch(ReqwestResponseError),
    GenPath(Error),
    Resume(StateError),
}

Why a download plan could not be produced.

Every variant is fatal for the plan: no DownloadPlan exists, and nothing has been written to disk. PlanError::emit maps each one onto the equivalent Event for callers that consume the event stream rather than the return value.

Variants

BuildClient(Error)

The HTTP client could not be built (TLS / backend initialization, etc.).

Prefetch(ReqwestResponseError)

Prefetch exhausted its retry budget; this is the failure of the last attempt. Earlier attempts were reported as Event::PrefetchError.

GenPath(Error)

The output path could not be computed (unwritable directory, a file name that is invalid on this platform, etc.).

Resume(StateError)

An explicit plan_resume could not continue the interrupted download.

Implementations

impl PlanError

pub fn emit(self, tx: &Tx)

Forward this error to the event channel as the matching *Error event.

Used by the one-shot crate::download / crate::resume wrappers, whose callers only observe the event stream.

Trait Implementations

impl Debug for PlanError

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

Formats the value using the given formatter.

impl Display for PlanError

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

Formats the value using the given formatter.

impl Error for PlanError

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.