Enum ToolchainError 

pub enum ToolchainError {
    RegistryError {
        message: String,
    },
    CacheError {
        message: String,
    },
    DigestMismatch {
        tool: String,
        expected: String,
        actual: String,
    },
    ExecutorUnavailable {
        tool: String,
    },
    RecipeUnsupported {
        tool: String,
        constructs: Vec<String>,
    },
    IoError(Error),
}

Errors raised while resolving or installing a runtime toolchain.

Variants

RegistryError

Registry / download / resolution failure (Homebrew API, GHCR blob pull, RepoSources discovery, archive extraction, …). Also covers toolchain-artifact registry operations: publishing a built toolchain to an OCI registry and pulling one back down.

Fields

message: String

Underlying registry error description.

CacheError

Cache or config-serialisation failure.

Fields

message: String

Underlying cache error description.

DigestMismatch

A downloaded artifact’s sha256 did not match the expected digest (either a formula urls.stable.checksum, an upstream-published digest, or a lockfile pin). The partial download is deleted before this is returned.

Fields

tool: String

The tool / artifact whose digest failed to verify.

expected: String

The expected sha256 (bare lowercase hex).

actual: String

The sha256 actually computed over the downloaded bytes.

ExecutorUnavailable

A containerized build step was required but no runtime executor has been registered. Toolchain builds must NEVER fall back to a host subprocess, so this is a hard error rather than a degraded path.

Fields

tool: String

The tool whose containerized build could not be executed.

RecipeUnsupported

A build recipe uses constructs this crate’s recipe interpreter does not support, so the toolchain cannot be built from it.

Fields

tool: String

The tool whose recipe could not be interpreted.

constructs: Vec<String>

The unsupported recipe constructs that were encountered.

IoError(Error)

Underlying I/O error.

Trait Implementations

impl Debug for ToolchainError

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

Formats the value using the given formatter.

impl Display for ToolchainError

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

Formats the value using the given formatter.

impl Error for ToolchainError

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<Error> for ToolchainError

fn from(source: Error) -> Self

Converts to this type from the input type.