Enum AprenderError 

pub enum AprenderError {
    DimensionMismatch {
        expected: String,
        actual: String,
    },
    SingularMatrix {
        det: f64,
    },
    ConvergenceFailure {
        iterations: usize,
        final_loss: f64,
    },
    InvalidHyperparameter {
        param: String,
        value: String,
        constraint: String,
    },
    BackendUnavailable {
        backend: String,
    },
    Io(Error),
    Serialization(String),
    Other(String),
    FormatError {
        message: String,
    },
    UnsupportedVersion {
        found: (u8, u8),
        supported: (u8, u8),
    },
    ChecksumMismatch {
        expected: u32,
        actual: u32,
    },
    SignatureInvalid {
        reason: String,
    },
    DecryptionFailed {
        message: String,
    },
    ValidationError {
        message: String,
    },
}

Main error type for Aprender operations.

Provides detailed context about failures including dimension mismatches, singular matrices, convergence issues, and invalid hyperparameters.

Examples

use aprender::error::AprenderError;

let err = AprenderError::DimensionMismatch {
    expected: "100x10".to_string(),
    actual: "100x5".to_string(),
};
assert!(err.to_string().contains("dimension mismatch"));

Variants

DimensionMismatch

Matrix/vector dimensions don’t match for the operation.

Fields

expected: String

Expected dimensions description

actual: String

Actual dimensions found

SingularMatrix

Matrix is singular (non-invertible).

Fields

det: f64

Determinant value (close to zero)

ConvergenceFailure

Optimization failed to converge within iteration limit.

Fields

iterations: usize

Number of iterations attempted

final_loss: f64

Final loss value

InvalidHyperparameter

Invalid hyperparameter value provided.

Fields

param: String

Parameter name

value: String

Provided value

constraint: String

Constraint description

BackendUnavailable

Requested compute backend is not available.

Fields

backend: String

Backend name (e.g., “GPU”, “AVX-512”)

Io(Error)

I/O error (file not found, permission denied, etc.).

Serialization(String)

Serialization/deserialization error.

Other(String)

Generic error with string message.

FormatError

Invalid or corrupt model format.

Fields

message: String

Error description

UnsupportedVersion

Unsupported format version.

Fields

found: (u8, u8)

Version found

supported: (u8, u8)

Maximum supported version

ChecksumMismatch

Checksum verification failed.

Fields

expected: u32

Expected checksum

actual: u32

Actual checksum

SignatureInvalid

Signature verification failed.

Fields

reason: String

Reason for failure

DecryptionFailed

Decryption failed (wrong password or corrupt data).

Fields

message: String

Error details

ValidationError

Poka-yoke validation failed (APR-POKA-001 - Jidoka gate).

Fields

message: String

Validation failure message

Implementations

impl AprenderError

pub fn dimension_mismatch( context: &str, expected: usize, actual: usize, ) -> AprenderError

Create a dimension mismatch error with descriptive context

pub fn index_out_of_bounds(index: usize, len: usize) -> AprenderError

Create an index out of bounds error

pub fn empty_input(context: &str) -> AprenderError

Create an empty input error

Trait Implementations

impl Debug for AprenderError

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

Formats the value using the given formatter.

impl Display for AprenderError

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

Formats the value using the given formatter.

impl Error for AprenderError

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<&str> for AprenderError

fn from(msg: &str) -> AprenderError

Converts to this type from the input type.

impl From<AprFormatError> for AprenderError

APR-2231 wrapper error seam: the sovereign apr-format leaf owns its own AprFormatError; here aprender-core From-wraps it into AprenderError so the leaf’s ?-results flow transparently into framework code and the leaf stays free of any dependency on this error type. Variant set mirrors the leaf’s AprFormatError; the leaf-only InvalidOffset / HeaderTooLarge fold into FormatError (no information loss — the Display text is preserved).

fn from(err: AprFormatError) -> AprenderError

Converts to this type from the input type.

impl From<ContractError> for AprenderError

fn from(err: ContractError) -> AprenderError

Converts to this type from the input type.

impl From<Error> for AprenderError

fn from(err: Error) -> AprenderError

Converts to this type from the input type.

impl From<ImportError> for AprenderError

fn from(err: ImportError) -> AprenderError

Converts to this type from the input type.

impl From<String> for AprenderError

fn from(msg: String) -> AprenderError

Converts to this type from the input type.

impl PartialEq<&str> for AprenderError

fn eq(&self, other: &&str) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.