Enum PrebuiltError 

pub enum PrebuiltError {
    NoMatchingAsset,
    Download(String),
    ChecksumMismatch {
        expected: String,
        actual: String,
    },
    Extract(String),
    UnsupportedArchive {
        url: String,
    },
    UnsafeUrl {
        url: String,
    },
    InvalidSha256 {
        sha256: String,
    },
    TooLarge {
        max: u64,
    },
    Io(Error),
    Verify(CommandVerifyError),
}

Why a prebuilt-binary install attempt failed. Variants distinguish “no asset for this host” (caller falls back to the setup script) from “asset matched but couldn’t be installed” (caller surfaces the error — security failures and network issues should not silently trigger a build).

Variants

NoMatchingAsset

Host triple has no entry in extension.prebuilt. Caller should fall back to the setup script. Not really an error — just a signal that there’s nothing to try.

Download(String)

Network / HTTP problem fetching the URL.

ChecksumMismatch

Downloaded bytes don’t match the declared SHA-256. Treated as a hard failure (don’t fall back to setup) since this could indicate tampering, mirror corruption, or a stale manifest.

Fields

expected: String

actual: String

Extract(String)

tar / unzip exited non-zero or wasn’t on PATH.

UnsupportedArchive

The archive doesn’t end in a recognized suffix (we support .tar.gz / .tgz / .tar.xz / .tar.bz2 / .zip).

Fields

url: String

UnsafeUrl

Asset URL must be https:// (or file:// in tests).

Fields

url: String

InvalidSha256

Manifest checksum is not exactly 64 hex characters.

Fields

sha256: String

TooLarge

Prebuilt response or stream exceeded the configured size cap.

Fields

max: u64

Io(Error)

I/O setting up the temp file or moving extracted artifacts.

Verify(CommandVerifyError)

Asset extracted but the manifest’s extension.command still doesn’t resolve. The archive layout is wrong.

Trait Implementations

impl Debug for PrebuiltError

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

Formats the value using the given formatter.

impl Display for PrebuiltError

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

Formats the value using the given formatter.

impl Error for PrebuiltError

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<CommandVerifyError> for PrebuiltError

fn from(source: CommandVerifyError) -> Self

Converts to this type from the input type.

impl From<Error> for PrebuiltError

fn from(source: Error) -> Self

Converts to this type from the input type.