Skip to main content

rufield_core/
error.rs

1//! Core error type for RuField MFS data-model validation.
2
3use std::fmt;
4
5/// Errors raised by the core data model (validation failures, etc.).
6#[derive(Debug, Clone, PartialEq, Eq)]
7pub enum CoreError {
8    /// `shape.product()` did not equal `values.len()`.
9    ShapeMismatch {
10        /// Element count implied by `shape`.
11        expected: usize,
12        /// Actual `values.len()`.
13        actual: usize,
14    },
15    /// `axes.len()` did not equal `shape.len()`.
16    AxisRankMismatch {
17        /// Number of axes provided.
18        axes: usize,
19        /// Rank of the shape.
20        rank: usize,
21    },
22    /// A generic validation failure with a message.
23    Invalid(String),
24}
25
26impl fmt::Display for CoreError {
27    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
28        match self {
29            CoreError::ShapeMismatch { expected, actual } => write!(
30                f,
31                "field tensor shape mismatch: shape implies {expected} values but got {actual}"
32            ),
33            CoreError::AxisRankMismatch { axes, rank } => write!(
34                f,
35                "field tensor axis/rank mismatch: {axes} axes for rank-{rank} shape"
36            ),
37            CoreError::Invalid(m) => write!(f, "invalid field data: {m}"),
38        }
39    }
40}
41
42impl std::error::Error for CoreError {}