Enum FailureKind 

pub enum FailureKind {
    MissingHome,
    UnsupportedShell,
    InvalidTargetPath,
    DefaultPathUnavailable,
    CompletionTargetUnavailable,
    CompletionFileUnreadable,
    ProfileUnavailable,
    ProfileCorrupted,
}

Stable failure kinds for recoverable operational errors.

crate::Error::Failure wraps a FailureReport carrying one of these kinds so callers can branch on failure categories without parsing human-readable text.

Variants

MissingHome

HOME was not available and no fallback path could be derived.

UnsupportedShell

The requested shell is not implemented.

InvalidTargetPath

The requested target path was invalid.

This typically means a provided path_override did not include a usable parent directory.

DefaultPathUnavailable

The default managed install path could not be resolved.

CompletionTargetUnavailable

The completion file or its directory could not be created or written.

CompletionFileUnreadable

The completion file existed but could not be read as expected.

ProfileUnavailable

The managed shell profile could not be written or removed.

ProfileCorrupted

The managed shell profile was present but malformed.

This usually means a previously managed block has a missing end marker or otherwise cannot be updated safely.

Implementations

impl FailureKind

pub const fn code(self) -> &'static str

Returns a stable machine-readable code for monitoring and telemetry.

pub const fn is_retryable(self) -> bool

Returns whether the kind is generally worth a retry with corrected environment or timing.

Trait Implementations

impl Clone for FailureKind

fn clone(&self) -> FailureKind

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for FailureKind

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

Formats the value using the given formatter.

impl PartialEq for FailureKind

fn eq(&self, other: &FailureKind) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Copy for FailureKind

impl Eq for FailureKind

impl StructuralPartialEq for FailureKind