Enum Error 

pub enum Error {
    UnsupportedPlatform {
        os: String,
        arch: String,
    },
    UnknownPlatformSlug(String),
    Io {
        context: String,
        source: Error,
    },
    Http(Error),
    HttpStatus {
        url: String,
        status: u16,
    },
    CurlFailed {
        url: String,
        code: i32,
    },
    ChecksumMismatch {
        expected: String,
        actual: String,
    },
    TomlParse(Error),
    Zip(ZipError),
    HyperdNotInArchive,
    ScrapeFailed(&'static str),
}

Errors produced while downloading, verifying, and installing hyperd.

Every fallible function in this crate returns a Result<T, Error>. The variants line up with the phases of bootstrap: platform detection, HTTP/curl fetching, TOML parsing, archive extraction, and checksum verification.

Variants

UnsupportedPlatform

The host (os / arch combination) has no published hyperd build.

Fields

os: String

Operating-system identifier returned by std::env::consts::OS.

arch: String

Architecture identifier returned by std::env::consts::ARCH.

UnknownPlatformSlug(String)

A platform slug (e.g. "macos-arm64") did not match any known target.

Io

A filesystem or I/O operation failed, enriched with contextual text.

Fields

context: String

Human-readable description of the operation that was attempted.

source: Error

Underlying std::io::Error returned by the OS.

Http(Error)

A reqwest HTTP client error (connection failure, TLS issue, etc.).

HttpStatus

A server returned a non-success HTTP status while fetching url.

Fields

url: String

URL that was being fetched when the failure occurred.

status: u16

HTTP response status code.

CurlFailed

The fallback curl subprocess exited with a non-zero status.

Fields

url: String

URL passed to curl.

code: i32

curl exit code.

ChecksumMismatch

The downloaded archive did not match the expected SHA-256 checksum.

Fields

expected: String

Hex-encoded expected digest (from hyperd-version.toml).

actual: String

Hex-encoded digest computed from the downloaded bytes.

TomlParse(Error)

The hyperd-version.toml file could not be parsed.

Zip(ZipError)

The downloaded ZIP archive was malformed or could not be extracted.

HyperdNotInArchive

The archive did not contain a recognizable hyperd executable.

ScrapeFailed(&'static str)

Scraping the public releases page for the latest version failed.

Implementations

impl Error

pub fn unsupported_platform( os: impl Into<String>, arch: impl Into<String>, ) -> Self

Constructs an Self::UnsupportedPlatform error.

pub fn unknown_platform_slug(slug: impl Into<String>) -> Self

Constructs an Self::UnknownPlatformSlug error.

pub fn io(context: impl Into<String>, source: Error) -> Self

Constructs an Self::Io error.

pub fn http_status(url: impl Into<String>, status: u16) -> Self

Constructs an Self::HttpStatus error.

pub fn curl_failed(url: impl Into<String>, code: i32) -> Self

Constructs an Self::CurlFailed error.

pub fn checksum_mismatch( expected: impl Into<String>, actual: impl Into<String>, ) -> Self

Constructs an Self::ChecksumMismatch error.

Trait Implementations

impl Debug for Error

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

Formats the value using the given formatter.

impl Display for Error

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

Formats the value using the given formatter.

impl Error for Error

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.