macrofied-toolbox 0.4.2

This library provides an ergonomic experience of adding debugging messages to rust's Result<T,E> and Option<T> patterns
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
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158

#[cfg(feature = "trace")]
use std::fmt::{self, Display, Formatter};

use proc_macro2::TokenStream;
#[cfg(feature = "trace")]
use quote::ToTokens;
use syn::{Expr, Lit};

pub struct Message {
    pub args: Option<Vec<Expr>>,
    pub captured: Option<Capture>,
    pub fmt: Lit,
}

#[cfg(feature = "trace")]
impl Display for Message {
    fn fmt(&self, fmt: &mut Formatter<'_>) -> fmt::Result {
        let args = if let Some(args) = &self.args {
            format!(
                "{:?}",
                args.iter().map(|v| format!("{}", v.to_token_stream())).collect::<Vec<String>>()
            )
        } else {
            "None".to_string()
        };
        let captured = if let Some(captured) = &self.captured {
            format!("{}", captured)
        } else {
            "None".to_string()
        };

        write!(
            fmt, "{{ args: {}, captured: {}, fmt: {} }}",
            args, captured, self.fmt.to_token_stream()
        )
    }
}

impl Message {
    pub fn build_message(&self) -> TokenStream {
        let mut tokens = TokenStream::new();

        let fmt = &self.fmt;

        tokens.extend(quote! { #fmt });

        if let Some(args) = &self.args {
            for arg in args {
                tokens.extend(quote! { , #arg });
            }
        }

        tokens
    }
}

#[derive(Clone)]
pub struct Capture {
    pub identifier: String,
    pub mutable: bool,
    pub reference: bool,
}

impl<T: Into<String>> From<T> for Capture {
    fn from(identifier: T) -> Self {
        Self {
            identifier: identifier.into(),
            mutable: false,
            reference: false
        }
    }
}

#[cfg(feature = "trace")]
impl Display for Capture {
    fn fmt(&self, fmt: &mut Formatter<'_>) -> fmt::Result {
        write!(
            fmt, "{{ identifier: {:?}, mutable: {}, reference: {} }}",
            self.identifier, self.mutable, self.reference
        )
    }
}

pub struct OnExpr {
    pub captured: Option<Capture>,
    pub expr: Expr,
}

#[cfg(feature = "trace")]
impl Display for OnExpr {
    fn fmt(&self, fmt: &mut Formatter<'_>) -> fmt::Result {
        let captured = if let Some(captured) = &self.captured {
            format!("{}", captured)
        } else {
            "None".to_string()
        };

        write!(
            fmt, "{{ captured: {}, expr: \"{}\" }}", captured, self.expr.to_token_stream()
        )
    }
}

pub struct OnFail {
    pub expr: Option<OnExpr>,
    pub message: Option<Message>,
}

#[cfg(feature = "trace")]
impl Display for OnFail {
    fn fmt(&self, fmt: &mut Formatter<'_>) -> fmt::Result {
        let expr = if let Some(expr) = &self.expr {
            format!("{}", expr)
        } else {
            "None".to_string()
        };
        let message = if let Some(message) = &self.message {
            format!("{}", message)
        } else {
            "None".to_string()
        };

        write!(fmt, "{{ expr: {}, message: {} }}", expr, message)
    }
}

pub enum OnSuccess {
    Expr(OnExpr),
    Message(Message),
}

#[cfg(feature = "trace")]
impl Display for OnSuccess {
    fn fmt(&self, fmt: &mut Formatter<'_>) -> fmt::Result {
        match self {
            Self::Expr(expr) =>
                write!(fmt, "{}", expr),
            Self::Message(message) =>
                write!(fmt, "{}", message)
        }
    }
}

pub struct WhenExpr {
    pub expr: Expr,
    pub tried: bool,
    pub ok_when: bool
}

#[cfg(feature = "trace")]
impl Display for WhenExpr {
    fn fmt(&self, fmt: &mut Formatter<'_>) -> fmt::Result {
        write!(
            fmt, "{{ expr: \"{}\", ok_when: {}, tried: {} }}",
            self.expr.to_token_stream(), self.ok_when, self.tried
        )
    }
}