Enum Error 

#[non_exhaustive]
pub enum Error {
    Flake(Error),
    Config(ConfigError),
    Io(Error),
    FlakeNotFound {
        path: PathBuf,
        source: Error,
    },
    FlakeDirEmpty {
        path: PathBuf,
    },
    IncompatibleFollowOptions,
    NoUri,
    NoId,
    NoInputs,
    InvalidUri {
        uri: String,
        source: NixUriError,
    },
    InvalidInputId {
        id: String,
        source: AttrPathParseError,
    },
    InvalidFollowsPath {
        path: String,
        source: AttrPathParseError,
    },
    CouldNotInferId {
        uri: String,
    },
    InputNotPinnable {
        id: String,
    },
    CouldNotRemove {
        id: ChangeId,
    },
    LockFile {
        path: PathBuf,
        source: Error,
    },
    FollowsCreateFailed {
        id: String,
    },
    ValidationAfterEdit(Vec<ValidationError>),
    Batch {
        failures: Vec<(PathBuf, Box<Error>)>,
    },
}

Errors raised inside the binary’s command and handler layer.

One layer combining the per-subcommand operations and the top-level dispatcher.

Variants (Non-exhaustive)

Non-exhaustive enums could have additional variants added in future. Therefore, when matching against variants of non-exhaustive enums, an extra wildcard arm must be added to account for any future variants.

Flake(Error)

A failure inside the library edit / walk / lock layer.

Config(ConfigError)

A configuration loading failure.

Io(Error)

An io error not otherwise classified (e.g. nix subprocess failure).

FlakeNotFound

flake.nix could not be opened or located.

Fields

path: PathBuf

source: Error

FlakeDirEmpty

The directory passed to --flake exists but contains no flake.nix.

Fields

path: PathBuf

IncompatibleFollowOptions

--flake and --lock were combined with the batch follow [PATHS...] form, which owns its own per-file editor.

NoUri

A subcommand was invoked without a URI argument when one is required.

NoId

A subcommand was invoked without an input id when one is required.

NoInputs

An input list was empty when at least one was required.

InvalidUri

A flake reference could not be parsed by nix_uri.

Fields

uri: String

source: NixUriError

InvalidInputId

An input id was malformed; carries the typed parse error.

Fields

id: String

source: AttrPathParseError

InvalidFollowsPath

A follows path was malformed; carries the typed parse error.

Fields

path: String

source: AttrPathParseError

CouldNotInferId

nix_uri rendered a flake reference but could not infer an id from it.

Fields

uri: String

InputNotPinnable

The named input has no concrete URL to pin against (e.g. a follows-only input or a non-standard reference shape).

Fields

id: String

CouldNotRemove

Removing an input did not produce a syntax change.

Fields

id: ChangeId

LockFile

Could not load flake.lock. The wrapped library error already classifies the underlying failure.

Fields

path: PathBuf

source: Error

FollowsCreateFailed

A follow <input> <target> invocation could not establish the follows relationship.

Fields

id: String

ValidationAfterEdit(Vec<ValidationError>)

Validation of flake.nix failed after applying speculative edits. Distinct from crate::Error::Validation (which fires before edits) because the diagnostic flow needs to render the staged edits too.

Batch

Aggregated failures from a follow [PATHS...] batch. Each entry pairs the offending path with the error processing it produced.

Fields

failures: Vec<(PathBuf, Box<Error>)>

Implementations

impl Error

pub fn batch_bullets(&self) -> Option<Vec<String>>

Per-failure rendering of a Batch aggregate. Each item joins the path with the error and its full source chain so a reader sees the underlying cause without the renderer descending per-bullet.

pub fn validation_bullets(&self) -> Option<Vec<String>>

Per-error rendering of a ValidationAfterEdit aggregate. Returns None for non-aggregate variants.

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.

impl From<ConfigError> for Error

fn from(source: ConfigError) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.