Enum LoadError 

pub enum LoadError {
    IoError {
        path: PathBuf,
        source: Error,
    },
    ParseError {
        path: PathBuf,
        message: String,
    },
    SchemaError {
        path: PathBuf,
        field: String,
        message: String,
    },
    CrossReferenceError {
        source_file: PathBuf,
        source_entity: String,
        target_collection: String,
        target_entity: String,
    },
    ConstraintError {
        description: String,
    },
    PolicyIncompatible {
        check: String,
        policy_value: String,
        system_value: String,
    },
}

Errors that can occur during case loading.

Variants are ordered by the pipeline phase in which they typically occur: I/O read → parse → schema validation → cross-reference validation → semantic constraint validation → warm-start policy compatibility.

Examples

use cobre_io::LoadError;
use std::path::PathBuf;

let err = LoadError::SchemaError {
    path: PathBuf::from("system/hydros.json"),
    field: "bus_id".to_string(),
    message: "required field is missing".to_string(),
};
assert!(err.to_string().contains("bus_id"));

Variants

IoError

Filesystem read failure (file not found, permission denied, I/O error).

Fields

path: PathBuf

Path to the file that could not be read.

source: Error

Underlying I/O error.

ParseError

JSON or Parquet parsing failure (malformed content, encoding error).

Fields

path: PathBuf

Path to the file that failed to parse.

message: String

Human-readable description of the parse failure.

SchemaError

Schema validation failure (missing required field, wrong type, value out of range).

Fields

path: PathBuf

Path to the file containing the invalid entry.

field: String

Dot-separated field path within the JSON object (e.g., "hydros[3].bus_id").

message: String

Human-readable description of the schema violation.

CrossReferenceError

Cross-reference validation failure (dangling entity ID, broken foreign key).

Fields

source_file: PathBuf

Path to the file that contains the dangling reference.

source_entity: String

String identifier of the entity that holds the broken reference (e.g., "Hydro 'H1'").

target_collection: String

Name of the collection that was expected to contain target_entity (e.g., "bus registry").

target_entity: String

String identifier of the entity that could not be found (e.g., "BUS_99").

ConstraintError

Semantic constraint violation (acyclic cascade, complete coverage, consistency).

Fields

description: String

Human-readable description of the violated constraint.

PolicyIncompatible

Warm-start policy is structurally incompatible with the current system.

See SS7.1 in input-loading-pipeline.md for the four compatibility checks.

Fields

check: String

Name of the failing compatibility check (e.g., "hydro count").

policy_value: String

Value recorded in the policy file.

system_value: String

Value present in the current system.

Implementations

impl LoadError

pub fn io(path: impl AsRef<Path>, source: Error) -> Self

Construct an LoadError::IoError wrapping an std::io::Error with path context.

Do not implement From<std::io::Error> instead — that conversion loses the path context required for diagnostic messages.

Examples

use cobre_io::LoadError;
use std::io;

let io_err = io::Error::new(io::ErrorKind::NotFound, "no such file");
let err = LoadError::io("system/hydros.json", io_err);
assert!(err.to_string().contains("system/hydros.json"));

pub fn parse(path: impl AsRef<Path>, message: impl Into<String>) -> Self

Construct a LoadError::ParseError with path context and a message.

Examples

use cobre_io::LoadError;

let err = LoadError::parse("stages.json", "unexpected end of input");
assert!(err.to_string().contains("stages.json"));
assert!(err.to_string().contains("unexpected end of input"));

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 EstimationError

fn from(source: LoadError) -> Self

Converts to this type from the input type.