numrs2 0.3.2

A Rust implementation inspired by NumPy for numerical computing (NumRS2)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

//! NumRS2 Error System
//!
//! This module provides both the new hierarchical error system and backward
//! compatibility with the existing flat error structure.

// Submodules for hierarchical error system
pub mod computation;
pub mod context;
pub mod core;
pub mod io;
pub mod memory;

// Integration modules
mod hierarchical;
mod legacy;

use std::fmt;

// Re-export the hierarchical error system
pub use self::hierarchical::*;

// Keep the original flat structure for backward compatibility
pub use legacy::{NumRs2Error, Result};

// Re-export core types for convenience
pub use computation::ComputationError;
pub use context::{ErrorContext, ErrorLocation, ErrorSeverity, OperationContext};
pub use core::CoreError;
pub use io::IOError;
pub use memory::MemoryError;

// Error category classification for hierarchical system
#[derive(Debug, Clone, Copy, PartialEq, Eq)]
pub enum ErrorCategory {
    /// Core library errors (shape, indexing, operations)
    Core,
    /// Numerical computation errors
    Computation,
    /// Memory management errors
    Memory,
    /// Input/output errors
    IO,
}

impl fmt::Display for ErrorCategory {
    fn fmt(&self, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        match self {
            ErrorCategory::Core => write!(f, "Core"),
            ErrorCategory::Computation => write!(f, "Computation"),
            ErrorCategory::Memory => write!(f, "Memory"),
            ErrorCategory::IO => write!(f, "I/O"),
        }
    }
}

/// Enhanced result type with context
pub type ContextResult<T> = std::result::Result<T, ErrorContext<NumRs2Error>>;

// For new code, recommend using the hierarchical system
pub mod prelude {
    pub use super::{
        ComputationError, ContextResult, CoreError, ErrorCategory, ErrorContext, ErrorLocation,
        ErrorSeverity, IOError, MemoryError, NumRs2Error, OperationContext, Result,
    };
}