vacro-report 0.1.3

Diagnostic reporting enhancements for Rust procedural macros, improving error messages.
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

use rust_format::{Formatter, PrettyPlease};

pub use quote::{quote, quote_spanned};
pub use vacro_report_macro::parse_quote;
pub use vacro_report_macro::parse_quote_spanned;

#[track_caller]
pub fn parse_quote_traced<T: syn::parse::Parse>(
    tokens: proc_macro2::TokenStream,
    spanned: bool,
) -> T {
    let actual = PrettyPlease::default()
        .format_tokens(tokens.clone())
        .unwrap_or(tokens.to_string());
    match std::panic::catch_unwind(|| syn::parse2(tokens)) {
        Ok(Ok(v)) => v,
        Ok(Err(e)) => {
            let loc = std::panic::Location::caller();
            panic!(
                "`{}` failed at {}:{}:{}\n\
                Tokens:\n\
                ```\n\
                {}\n\
                ```\n\
                Error message: \"{}\"",
                if spanned {
                    "parse_quote_spanned"
                } else {
                    "parse_quote"
                },
                loc.file(),
                loc.line(),
                loc.column(),
                actual,
                e,
            );
        }
        Err(panic) => {
            let loc = std::panic::Location::caller();
            panic!(
                "`{}` panicked at {}:{}:{}\n\
                Tokens:\n\
                ```\n\
                {}\n\
                ```\n\
                Error message: \"{:?}\"",
                if spanned {
                    "parse_quote_spanned"
                } else {
                    "parse_quote"
                },
                loc.file(),
                loc.line(),
                loc.column(),
                actual,
                panic,
            );
        }
    }
}