Enum HashlineError 

pub enum HashlineError {
    Parse {
        line: u32,
        msg: String,
    },
    NotFound {
        path: String,
    },
    MissingSnapshotTag(String),
    UnseenLines(String),
    Mismatch {
        detail: String,
        expected: String,
        actual: String,
    },
    DuplicateCanonicalPath {
        path: String,
    },
    NoOp {
        path: String,
    },
    LineOutOfBounds {
        line: u32,
        total: usize,
    },
    Io(Error),
}

The umbrella error type for the hashline crate.

Structured errors raised across the parser, tokenizer, patcher, and recovery paths. Defined here (per the omp-adoption design §3.10) so the lower-level tokenizer/parser can reference it without an extra module.

Variants

Parse

A patch grammar / structural parse error at a given line.

Fields

line: u32

1-indexed source line where the parse error occurred.

msg: String

Human-readable parse error detail.

NotFound

File does not exist.

Fields

path: String

Canonical file path that could not be found.

MissingSnapshotTag(String)

Section omitted the mandatory snapshot tag (omp missingSnapshotTagMessage).

UnseenLines(String)

An anchored edit referenced unseen lines (omp unseenLinesMessage).

Mismatch

Snapshot tag mismatch with live content (omp MismatchError).

Fields

detail: String

Pre-formatted diagnostic message.

expected: String

Snapshot tag the section was bound to.

actual: String

Snapshot tag the live file actually produced.

DuplicateCanonicalPath

Multiple sections resolve to the same canonical path.

Fields

path: String

Canonical path targeted by more than one section.

NoOp

Edits resulted in no net change.

Fields

path: String

Path whose applied edits produced no net change.

LineOutOfBounds

Anchor line out of bounds for the file.

Fields

line: u32

1-indexed anchor line that exceeds the file’s bounds.

total: usize

Total number of lines in the file.

Io(Error)

Underlying I/O error.

Implementations

impl HashlineError

pub fn parse(line: u32, msg: impl Into<String>) -> Self

Construct a HashlineError::Parse (the form the tokenizer raises).

Trait Implementations

impl Debug for HashlineError

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

Formats the value using the given formatter.

impl Display for HashlineError

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

Formats the value using the given formatter.

impl Error for HashlineError

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 HashlineError

fn from(source: Error) -> Self

Converts to this type from the input type.