Enum IngestError 

pub enum IngestError {
    Io {
        path: PathBuf,
        source: Error,
    },
    Parse {
        path: Option<PathBuf>,
        source: Error,
    },
    NotATrace {
        path: Option<PathBuf>,
        source: Error,
    },
    JsonLines {
        path: Option<PathBuf>,
    },
}

Everything that can go wrong loading a trace. The library path returns this rather than panicking.

The parse family carries an optional path because amberfork diff reads two inputs — an error that doesn’t say which file broke is a dead end. load_file fills it in; from_json_str has no path to give (embedded demo pair, future stdin).

Variants

Io

The file could not be read.

Fields

path: PathBuf

source: Error

Parse

The input was not parseable JSON. The canonical loader reserves this for malformed JSON — shape problems classify as Self::NotATrace — while the format adapters (tape, whowhen) use it for any serde failure on their foreign shapes.

Fields

path: Option<PathBuf>

source: Error

NotATrace

Valid JSON, but not shaped like a canonical trace (issue #20). The serde detail names the field or variant that broke; the display adds what a trace needs and points to the format reference so the first error is not a dead end.

Fields

path: Option<PathBuf>

source: Error

JsonLines

The input looks like JSON-Lines — the shape of a raw exporter transcript, the likeliest first mistake (issue #20). amberfork takes a single JSON trace per file; the display points to the conversion guide.

Fields

path: Option<PathBuf>

Implementations

impl IngestError

pub fn with_path(self, path: &Path) -> Self

Attach the originating file to a parse-family error — load_file knows the path, from_json_str doesn’t. Io already names its file. Public because a caller that reads the bytes itself (the CLI’s format-sniffing loader) still wants the file attributed.

Trait Implementations

impl Debug for IngestError

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

Formats the value using the given formatter.

impl Display for IngestError

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

Formats the value using the given formatter.

impl Error for IngestError

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.