Enum LoadError 

pub enum LoadError {
    Io {
        path: PathBuf,
        source: Error,
    },
    IncludeCycle {
        cycle: Vec<String>,
    },
    ParseErrors {
        path: PathBuf,
        errors: Vec<ParseError>,
    },
    PathTraversal {
        include_path: String,
        base_dir: PathBuf,
    },
    Decryption {
        path: PathBuf,
        message: String,
    },
    GlobNoMatch {
        pattern: String,
    },
    GlobError {
        pattern: String,
        message: String,
    },
    TooManyFiles {
        limit: usize,
    },
}

Errors that can occur during loading.

Variants

Io

IO error reading a file.

Fields

path: PathBuf

The path that failed to read.

source: Error

The underlying IO error.

IncludeCycle

Include cycle detected.

The Display string intentionally begins with Duplicate filename parsed: to match Python beancount’s wording for the same condition. The pta-standards include-cycle-detection conformance test asserts on the substring "Duplicate filename", so this wording is load-bearing (#765). The full cycle path is preserved in a trailing parenthetical for debuggability.

Fields

cycle: Vec<String>

The cycle of file paths. The last element is the re-encountered filename (equal to one of the earlier entries), and it’s the one quoted in the "Duplicate filename parsed:" prefix.

ParseErrors

Parse errors occurred.

Fields

path: PathBuf

The file with parse errors.

errors: Vec<ParseError>

The parse errors.

PathTraversal

Path traversal attempt detected.

Fields

include_path: String

The include path that attempted traversal.

base_dir: PathBuf

The base directory.

Decryption

GPG decryption failed.

Fields

path: PathBuf

The encrypted file path.

message: String

Error message from GPG.

GlobNoMatch

Glob pattern did not match any files.

Fields

pattern: String

The glob pattern that matched nothing.

GlobError

Glob pattern expansion failed.

Fields

pattern: String

The glob pattern that failed.

message: String

The error message.

TooManyFiles

More files were referenced than the 16-bit file-id space allows.

File ids are u16 on every Spanned value, so a ledger may reference at most u16::MAX files via includes/globs. Reported as an error rather than panicking, since load is a never-panic-on-input surface.

Fields

limit: usize

The maximum number of files supported.

Trait Implementations

impl Debug for LoadError

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

Formats the value using the given formatter.

impl Display for LoadError

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

Formats the value using the given formatter.

impl Error for LoadError

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<LoadError> for ProcessError

fn from(source: LoadError) -> Self

Converts to this type from the input type.