error-forge 0.9.7

A comprehensive Rust error management framework with async support, error recovery patterns, and resilience features for building robust, fault-tolerant applications with rich error handling, formatting, and tracing capabilities.
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
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86

#[cfg(feature = "async")]
use async_trait::async_trait;
use std::error::Error as StdError;

use crate::async_error::AsyncForgeError;
use crate::error::AppError;

/// Provides async implementations for the AppError type.
#[cfg(feature = "async")]
#[async_trait]
impl AsyncForgeError for AppError {
    fn kind(&self) -> &'static str {
        <Self as crate::error::ForgeError>::kind(self)
    }

    fn caption(&self) -> &'static str {
        <Self as crate::error::ForgeError>::caption(self)
    }

    fn is_retryable(&self) -> bool {
        <Self as crate::error::ForgeError>::is_retryable(self)
    }

    fn is_fatal(&self) -> bool {
        <Self as crate::error::ForgeError>::is_fatal(self)
    }

    fn status_code(&self) -> u16 {
        <Self as crate::error::ForgeError>::status_code(self)
    }

    fn exit_code(&self) -> i32 {
        <Self as crate::error::ForgeError>::exit_code(self)
    }

    fn user_message(&self) -> String {
        <Self as crate::error::ForgeError>::user_message(self)
    }

    fn dev_message(&self) -> String {
        <Self as crate::error::ForgeError>::dev_message(self)
    }

    async fn async_handle(&self) -> Result<(), Box<dyn StdError + Send + Sync>> {
        // Default async handling for AppError
        match self {
            AppError::Network { .. } => {
                // In a real implementation, this might attempt reconnection or other async recovery
                Ok(())
            }
            _ => {
                // For other error types, default to regular error handling
                Ok(())
            }
        }
    }
}

#[cfg(feature = "async")]
impl AppError {
    /// Create a new error from an async operation result
    pub async fn from_async_result<T, E>(result: Result<T, E>) -> Result<T, Self>
    where
        E: StdError + Send + Sync + 'static,
    {
        match result {
            Ok(value) => Ok(value),
            Err(e) => Err(Self::other(e.to_string())
                .with_fatal(false)
                .with_retryable(true)),
        }
    }

    /// Handle this error asynchronously using the AsyncForgeError trait
    pub async fn handle_async(&self) -> Result<(), Box<dyn StdError + Send + Sync>> {
        <Self as AsyncForgeError>::async_handle(self).await
    }

    /// Wrap this error with async context
    pub fn with_async_context<C: std::fmt::Display + std::fmt::Debug + Send + Sync + 'static>(
        self,
        context_generator: impl FnOnce() -> C + Send + 'static,
    ) -> crate::context::ContextError<Self, C> {
        crate::context::ContextError::new(self, context_generator())
    }
}