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

//! # Error Handling Macros
//!
//! This module provides macros for efficient error handling, particularly
//! for lazy evaluation of error contexts.

/// Creates a lazy error context that is only evaluated when an error occurs.
///
/// This macro avoids the runtime cost of formatting context strings when
/// the operation is successful. It returns a `LazyContext` that implements
/// `IntoErrorContext`.
///
/// # Examples
///
/// ```rust
/// use rustica::context;
/// use rustica::error::{with_context_result, ComposableResult};
///
/// fn might_fail(id: i32) -> Result<i32, &'static str> {
///     Ok(id)
/// }
///
/// let id = 42;
/// // The format! is not executed because the result is Ok
/// let result = with_context_result(
///     might_fail(id),
///     context!("Failed to process item {}", id)
/// );
/// ```
#[macro_export]
macro_rules! context {
    ($($arg:tt)*) => {
        $crate::error::types::LazyContext::new(move || format!($($arg)*))
    };
}