Enum Error 

#[non_exhaustive]
pub enum Error {
    Read {
        path: PathBuf,
        source: Error,
    },
    Write {
        path: PathBuf,
        source: Error,
    },
    Walker(WalkerError),
    Lock(LockError),
    DuplicateInput(String),
    InputNotFound(String),
    AddFollowDepthLimit {
        path: String,
        segments: usize,
    },
    Validation(Vec<ValidationError>),
}

Error for crate::edit::FlakeEdit operations.

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.

Read

Failed to read a flake file. Carries the path that the read was attempted against so the caller can surface it.

Fields

path: PathBuf

source: Error

Write

Failed to write a flake file.

Fields

path: PathBuf

source: Error

Walker(WalkerError)

The CST walker rejected a change. See WalkerError for details.

Lock(LockError)

A failure parsing or walking flake.lock. See LockError for the per-variant breakdown.

DuplicateInput(String)

Tried to add an input that already exists. The wrapped string is the existing input id.

InputNotFound(String)

Tried to operate on an input id that is not declared in the flake.

AddFollowDepthLimit

The add-follow subcommand received a path deeper than parent.child. flake-edit follow accepts deeper paths, bounded by crate::config::FollowConfig::max_depth when that is set; this guard catches typos in the explicit-path command before they produce nested inputs.*.inputs.*.follows chains.

Fields

path: String

segments: usize

Validation(Vec<ValidationError>)

Pre-edit validation found one or more fatal issues in flake.nix.

Implementations

impl Error

pub fn hint(&self) -> Option<String>

Actionable hint to display alongside the error, when one exists.

Hints live here rather than in #[error(...)] strings so the binary can render them on a separate hint: line and library callers can choose to surface or ignore them.

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

Per-error rendering of a Validation aggregate as one bullet per inner error. 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<Error> for Error

fn from(source: Error) -> Self

Converts to this type from the input type.

impl From<LockError> for Error

fn from(source: LockError) -> Self

Converts to this type from the input type.

impl From<WalkerError> for Error

fn from(source: WalkerError) -> Self

Converts to this type from the input type.