Enum ValidationError 

pub enum ValidationError {
    InvalidReference {
        source_entity_type: &'static str,
        source_id: EntityId,
        field_name: &'static str,
        referenced_id: EntityId,
        expected_type: &'static str,
    },
    DuplicateId {
        entity_type: &'static str,
        id: EntityId,
    },
    CascadeCycle {
        cycle_ids: Vec<EntityId>,
    },
    InvalidFillingConfig {
        hydro_id: EntityId,
        reason: String,
    },
    DisconnectedBus {
        bus_id: EntityId,
    },
    InvalidPenalty {
        entity_type: &'static str,
        entity_id: EntityId,
        field_name: &'static str,
        reason: String,
    },
}

Errors produced during System construction and validation.

Returned by the System builder when loading and validating entity collections. Each variant captures enough context to pinpoint the invalid input without requiring the caller to re-inspect the data.

Examples

use cobre_core::{EntityId, ValidationError};

let err = ValidationError::DuplicateId {
    entity_type: "Bus",
    id: EntityId(1),
};
assert!(err.to_string().contains("Bus"));

Variants

InvalidReference

A cross-reference field (e.g., bus_id, downstream_id) refers to an entity ID that does not exist in the system.

Fields

source_entity_type: &'static str

The entity type containing the invalid reference.

source_id: EntityId

The ID of the entity containing the invalid reference.

field_name: &'static str

The name of the field containing the invalid reference.

referenced_id: EntityId

The referenced ID that does not exist.

expected_type: &'static str

The entity type that was expected.

DuplicateId

Duplicate entity ID within a single entity collection.

Fields

entity_type: &'static str

The entity type with the duplicated ID.

id: EntityId

The duplicated entity ID.

CascadeCycle

The hydro cascade contains a cycle.

Fields

cycle_ids: Vec<EntityId>

IDs of hydros forming the cycle.

InvalidFillingConfig

A hydro’s filling configuration is invalid.

Fields

hydro_id: EntityId

The hydro whose filling configuration is invalid.

reason: String

Human-readable explanation of why the configuration is invalid.

DisconnectedBus

A bus has no connections (no lines, generators, or loads).

Emitted by cobre-io validation.

Fields

bus_id: EntityId

The ID of the disconnected bus.

InvalidPenalty

Entity-level penalty value is invalid (e.g., negative cost).

Emitted by cobre-io validation.

Fields

entity_type: &'static str

The entity type with the invalid penalty.

entity_id: EntityId

The ID of the entity with the invalid penalty.

field_name: &'static str

The name of the penalty field that is invalid.

reason: String

Human-readable explanation of why the penalty is invalid.

Trait Implementations

impl Clone for ValidationError

fn clone(&self) -> ValidationError

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for ValidationError

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

Formats the value using the given formatter.

impl Display for ValidationError

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

Formats the value using the given formatter.

impl Error for ValidationError

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.