Enum InstallerError 

pub enum InstallerError {
    MissingDependency {
        name: String,
        hint: Option<String>,
    },
    PythonVersionUnsupported {
        detected: String,
        minimum: String,
        maximum: Option<String>,
    },
    PythonNotFound {
        detail: String,
    },
    CommandFailed {
        command: String,
        exit_code: Option<i32>,
        stderr: String,
    },
    EnvError {
        var: String,
        detail: String,
    },
    PathNotFound {
        path: String,
        purpose: String,
    },
    NvidiaContamination {
        packages: Vec<String>,
    },
    PackageBlocked {
        package: String,
        component: String,
    },
    RocmNotFound {
        detail: String,
    },
    VenvError {
        path: String,
        detail: String,
    },
    Other {
        message: String,
    },
}

Common error types for installer operations.

Each variant represents a distinct failure mode encountered during component installation. All variants produce human-readable error messages via Display and integrate with std::error::Error.

Validation

• VAL-INFRA-009: InstallerError enum with common failure modes
• VAL-INFRA-022: Graceful handling of missing dependencies (no panics)

Variants

MissingDependency

A required dependency is missing (command not found).

Fields

name: String

Name of the missing command or tool.

hint: Option<String>

Optional hint for how to install it.

PythonVersionUnsupported

Python version is not in the supported range.

Fields

detected: String

The detected Python version string (e.g., “3.8”).

minimum: String

The minimum supported version (e.g., “3.10”).

maximum: Option<String>

Optional maximum version (e.g., “3.13” for ROCm PyTorch).

PythonNotFound

Python interpreter not found.

Fields

detail: String

Optional detail message.

CommandFailed

A subprocess command failed.

Fields

command: String

The command that was run.

exit_code: Option<i32>

The exit code (if available).

stderr: String

stderr output (truncated).

EnvError

An environment variable is missing or invalid.

Fields

var: String

The variable name.

detail: String

Description of the problem.

PathNotFound

A required file or directory does not exist.

Fields

path: String

The path that was expected.

purpose: String

What the path was needed for.

NvidiaContamination

NVIDIA/CUDA contamination detected in Python environment.

Fields

packages: Vec<String>

List of detected NVIDIA/CUDA packages.

PackageBlocked

Package installation blocked by guard policy.

Fields

package: String

The blocked package name.

component: String

The component that attempted the install.

RocmNotFound

ROCm installation not found or invalid.

Fields

detail: String

Detail message.

VenvError

Virtual environment error.

Fields

path: String

The venv path.

detail: String

What went wrong.

Other

Generic error with message.

Fields

message: String

Error message.

Trait Implementations

impl Debug for InstallerError

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

Formats the value using the given formatter.

impl Display for InstallerError

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

Formats the value using the given formatter.

impl Error for InstallerError

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.