bnf 0.6.0

A library for parsing Backus–Naur form context-free grammars
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

#[cfg(feature = "tracing")]
mod defs {
    #[allow(unused_imports)]
    pub(crate) use ::tracing::Level;

    macro_rules! span {
        (Level::$level:ident, $($rest:tt)*) => { ::tracing::span!(::tracing::Level::$level, $($rest)*) };
        ($level:ident, $($rest:tt)*) => { ::tracing::span!(::tracing::Level::$level, $($rest)*) };
        ($($all:tt)*) => { ::tracing::span!($($all)*) };
    }

    macro_rules! event {
        (Level::$level:ident, $($rest:tt)*) => { ::tracing::event!(::tracing::Level::$level, $($rest)*) };
        ($level:ident, $($rest:tt)*) => { ::tracing::event!(::tracing::Level::$level, $($rest)*) };
        ($($all:tt)*) => { ::tracing::event!($($all)*) };
    }

    pub(crate) use event;
    pub(crate) use span;

    #[allow(dead_code)]
    #[cfg_attr(test, mutants::skip)]
    pub fn init_subscriber() {
        tracing_subscriber::fmt()
            .with_env_filter(tracing_subscriber::EnvFilter::from_default_env())
            .with_ansi(false)
            .init();
    }
}

#[cfg(not(feature = "tracing"))]
mod defs {
    /// Stub level when the `tracing` feature is disabled; only used inside macros (arguments are discarded).
    #[allow(dead_code)]
    pub enum Level {
        TRACE,
        DEBUG,
        INFO,
        WARN,
        ERROR,
    }

    pub struct Span {}

    impl Span {
        #[cfg_attr(test, mutants::skip)]
        pub const fn entered(&self) -> Self {
            Self {}
        }
    }

    macro_rules! span {
        (Level::$level:ident, $($rest:tt)*) => {{
            use crate::tracing::Span;
            Span {}
        }};
        ($level:ident, $($rest:tt)*) => {{
            use crate::tracing::Span;
            Span {}
        }};
        ($($any:tt)*) => {{
            use crate::tracing::Span;
            Span {}
        }};
    }

    pub(crate) use span;

    #[allow(dead_code)]
    pub struct Event {}

    macro_rules! event {
        (Level::$level:ident, $($rest:tt)*) => {{}};
        ($level:ident, $($rest:tt)*) => {{}};
        ($($any:tt)*) => {{}};
    }

    pub(crate) use event;

    #[allow(dead_code)]
    #[cfg_attr(test, mutants::skip)]
    pub const fn init_subscriber() {}
}

pub(crate) use defs::*;

#[cfg(test)]
mod tests {
    use super::*;

    #[test]
    fn test_init_subscriber() {
        // Test that init_subscriber can be called without panicking
        // This covers the function even if it's marked as dead_code
        // Note: This may fail if a subscriber is already initialized, but that's okay
        // as it still exercises the code path
        let result = std::panic::catch_unwind(|| {
            init_subscriber();
        });
        // Explicitly drop the result to satisfy clippy
        drop(result);
    }

    #[test]
    fn test_span_macro() {
        // Test that span! macro works
        let _span = span!(Level::DEBUG, "test_span").entered();
    }

    #[test]
    fn test_event_macro() {
        // Test that event! macro works
        event!(Level::DEBUG, "test_event");
    }

    #[test]
    fn test_span_entered() {
        // Test that span.entered() works
        let span = span!(Level::DEBUG, "test");
        let _entered = span.entered();
    }

    #[test]
    fn test_span_macro_bare_level() {
        // Test that span! accepts bare level (no Level:: prefix, no import)
        let _span = span!(DEBUG, "bare_level_span").entered();
    }

    #[test]
    fn test_event_macro_bare_level() {
        // Test that event! accepts bare level (no Level:: prefix, no import)
        event!(INFO, "bare_level_event");
    }
}