rsaeb 0.10.1

A no_std + alloc interpreter for A=B ordered rewrite programs.
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
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111

use core::error::Error;

use crate::allocation::AllocationError;
use crate::bytes::TraceSnapshotByteCount;
use crate::limits::TraceSnapshotByteLimit;

use super::RunError;

/// Error returned by fallible borrowed tracing APIs.
///
/// Borrowed tracing itself does not materialize snapshots, so the only domains
/// are runtime execution and the user-provided trace sink. If retained event
/// bytes are needed, use the snapshot API so snapshot materialization failures
/// are represented explicitly.
#[derive(Debug, PartialEq, Eq)]
pub enum TracedRunError<E> {
    /// Runtime execution failed.
    Run(RunError),
    /// The user-provided trace sink failed.
    Trace(E),
}

impl<E> Error for TracedRunError<E>
where
    E: Error + 'static,
{
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        match self {
            Self::Run(error) => Some(error),
            Self::Trace(error) => Some(error),
        }
    }
}

impl<E> From<RunError> for TracedRunError<E> {
    fn from(value: RunError) -> Self {
        Self::Run(value)
    }
}

/// Error while materializing an owned trace snapshot from a borrowed trace event.
///
/// Snapshot limits are evaluated per event. A failing event is not silently
/// truncated.
#[derive(Debug, Clone, PartialEq, Eq)]
pub enum TraceSnapshotError {
    /// Snapshot bytes exceeded the caller-provided snapshot byte limit.
    Limit {
        /// Configured maximum trace snapshot byte length.
        limit: TraceSnapshotByteLimit,
        /// Snapshot length that would have been allocated.
        attempted_len: TraceSnapshotByteCount,
    },
    /// Snapshot byte materialization failed.
    Allocation(AllocationError),
}

impl Error for TraceSnapshotError {
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        match self {
            Self::Limit { .. } => None,
            Self::Allocation(error) => Some(error),
        }
    }
}

impl From<AllocationError> for TraceSnapshotError {
    fn from(value: AllocationError) -> Self {
        Self::Allocation(value)
    }
}

/// Error returned by trace-snapshot APIs.
///
/// Runtime execution, snapshot materialization, and caller callback failures
/// remain separate domains. Snapshot errors happen before the user callback is
/// called for the offending event.
#[derive(Debug, PartialEq, Eq)]
pub enum TraceSnapshotRunError<E> {
    /// Runtime execution failed.
    Run(RunError),
    /// Trace snapshot materialization failed.
    Snapshot(TraceSnapshotError),
    /// The user-provided trace sink failed.
    Trace(E),
}

impl<E> Error for TraceSnapshotRunError<E>
where
    E: Error + 'static,
{
    fn source(&self) -> Option<&(dyn Error + 'static)> {
        match self {
            Self::Run(error) => Some(error),
            Self::Snapshot(error) => Some(error),
            Self::Trace(error) => Some(error),
        }
    }
}

impl<E> From<RunError> for TraceSnapshotRunError<E> {
    fn from(value: RunError) -> Self {
        Self::Run(value)
    }
}

impl<E> From<TraceSnapshotError> for TraceSnapshotRunError<E> {
    fn from(value: TraceSnapshotError) -> Self {
        Self::Snapshot(value)
    }
}