rustica 0.12.0

Rustica is a functional programming library for the Rust language.
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

//! # Unified Error Handling System
//!
//! This module provides a category theory-inspired error handling system that maintains
//! functional purity while leveraging Rust's strengths. It extends the existing `WithError`
//! trait with composable error structures and functional error handling patterns.
//!
//! ## Design Philosophy
//!
//! The error system follows category theory principles:
//! - **Functoriality**: Error transformations preserve structure
//! - **Composability**: Error handlers can be composed like functions  
//! - **Purity**: No hidden state or side effects in error handling
//!
//! ## Module Structure
//!
//! - `core`: Extended WithError trait and ErrorCategory
//! - `types`: ComposableError and error context structures
//! - `convert`: Type conversion utilities between error types
//! - `context`: Error context management, accumulation, and functional pipelines
//! - `macros`: Error handling macros for lazy context evaluation

pub mod context; // Error context management and accumulation
pub mod convert; // Error type conversions
pub mod core; // Extended WithError trait and ErrorCategory
pub mod macros; // Error handling macros
pub mod types; // ComposableError and error context structures

// Re-export commonly used items
pub use context::{
    ErrorPipeline, accumulate_context, context_accumulator, context_fn, error_pipeline,
    extract_context, format_error_chain, with_context, with_context_result,
};
pub use convert::{
    collect_errors, composable_to_core, core_to_composable, either_to_result, either_to_validated,
    flatten_composable_result, result_to_either, result_to_validated, split_validated_errors,
    validated_to_either, validated_to_result, wrap_in_composable_result,
    wrap_in_composable_result_boxed,
};
pub use core::{ErrorCategory, ErrorOps};
pub use types::{
    BoxedComposableError, BoxedComposableResult, ComposableError, ComposableResult, ErrorContext,
    IntoErrorContext, LazyContext,
};

// Re-export error utility traits directly from the unified error module.
pub use core::{ResultExt, WithError, sequence, sequence_with_error, traverse, traverse_validated};