nolog 1.0.19

Pretty (by default) and easy to use logger. Compile-time level filtering, zero deps.
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
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201

// Copyright (c) 2022-present Vadim Glinka
//
// Licensed under the Apache License, Version 2.0 <LICENSE-APACHE or
// http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your
// option.

#[macro_export] macro_rules!
level_helper { 
    // On:  [#], [x], [v], [+], [true], [bool_var], [on]
    // Off: [ ], [_], [-], [false], [bool_var], [off]
    //
    //
    //        +----------+                                      +------------------------+    
    //        | one line |                                      | lines separated by `;` |
    //        +----------+                                      +------------------------+  
    //          v      v                                                v        v
    // +----------+  +----------------------+     +------------------------+  +------------------------------------+ 
    // | one line |  | one line (key-value) |     | lines separated by `;` |  | lines (key-value) separated by `;` |
    // +----------+  +----------------------+     +------------------------+  +------------------------------------+ 
    //     |  |  |           |   |    |                       |  |    |                      |  |    |
    //     v  |  v           v   |    v                       v  |    v                      v  |    v
    // +----+ | +-----+   +----+ | +-----+                +----+ | +-----+               +----+ | +-----+
    // | On | | | Off |   | On | | | Off |                | On | | | Off |               | On | | | Off |
    // +----+ | +-----+   +----+ | +-----+                +----+ | +-----+               +----+ | +-----+
    //        v                  v                               v                              V
    // +------------+      +------------+                  +------------+                 +------------+
    // | var (bool) |      | var (bool) |                  | var (bool) |                 | var (bool) |
    // +------------+      +------------+                  +------------+                 +------------+
    //
    //
    //
    //
    // Off, one line
    ( [$level:tt] [ ];   $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {};
    ( [$level:tt] [_];   $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {};
    ( [$level:tt] [-];   $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {};
    ( [$level:tt] [off]; $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {};
    // On, one line
    ( [$level:tt] [#];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*);
    };
    ( [$level:tt] [x];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*);
    };
    ( [$level:tt] [v];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*);
    };
    ( [$level:tt] [+];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*);
    };
    ( [$level:tt] [on]; $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*);
    };
    //
    // Off, one line (key-value)
    ( [$level:tt] [ ];   $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => {};
    ( [$level:tt] [_];   $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => {};
    ( [$level:tt] [-];   $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => {};
    ( [$level:tt] [off]; $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => {};
    // On, one line (key-value)
    ( [$level:tt] [#];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*);
    };
    ( [$level:tt] [x];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*);
    };
    ( [$level:tt] [v];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*);
    };
    ( [$level:tt] [+];  $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*);
    };
    ( [$level:tt] [on]; $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*);
    };
    //
    //
    // Off, lines separated by `;`
    ( [$level:tt] [ ];   $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {};
    ( [$level:tt] [_];   $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {};
    ( [$level:tt] [-];   $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {};
    ( [$level:tt] [off]; $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {};
    // On, lines separated by `;`
    ( [$level:tt] [#];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )*
    };
    ( [$level:tt] [x];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )*
    };
    ( [$level:tt] [v];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )*
    };
    ( [$level:tt] [+];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )*
    };
    ( [$level:tt] [on]; $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )*
    };
    //
    // Off, lines (key-value) separated by `;`
    ( [$level:tt] [ ];   $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {};
    ( [$level:tt] [_];   $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {};
    ( [$level:tt] [-];   $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {};
    ( [$level:tt] [off]; $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {};
    // On, lines (key-value) separated by `;`
    ( [$level:tt] [#];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )*
    };
    ( [$level:tt] [x];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )*
    };
    ( [$level:tt] [v];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )*
    };
    ( [$level:tt] [+];  $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )*
    };
    ( [$level:tt] [on]; $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )*
    };
    //
    // var (bool), one line
    ( [$level:tt] [$var:tt]; $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        //  debug!([(is_log_enabled_fn())]; "msg");
        //          ^                   ^
        // fn doesn't work without parentheses
        #[allow(unused_parens)]
        // `($var)` doesn't help
        if $var { level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); }
    };
    //
    // var (bool), one line (key-value)
    ( [$level:tt] [$var:tt]; $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        #[allow(unused_parens)]
        if $var { level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); }
    };
    //
    // var (bool), lines separated by `;`
    ( [$level:tt] [$var:tt]; $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        #[allow(unused_parens)]
        if $var { $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )* }
    };
    //
    // var (bool), lines (key-value) separated by `;`
    ( [$level:tt] [$var:tt]; $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        #[allow(unused_parens)]
        if $var { $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )* }
    };
    //
    //
    // lines separated by `;` (without on/off)
    ( [$level:tt] $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),*;)* ) => {
        // `one line` invocation for each line
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($msg),*); )*
    };
    // lines (key-value) separated by `;` (without on/off)
    ( [$level:tt] $($(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),*;)* ) => {
        // `one line (key-value)` invocation for each line
        $( level_helper!([$level] $(->[$indent $(,$linebefore $(,$lineafter)?)?])? $($key),* => $(->[$indent_v])? $($value),*); )*
    };
    //
    //
    // one line
    ( [$level:tt] $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($msg:expr),* ) => {
        $($(newline!($linebefore);)?)?
        msg_render!($level, indent!($($indent)?), $($msg),*);
        $($($(newline!($lineafter);)?)?)?
    };
    // one line (key-value)
    ( [$level:tt] $(->[$indent:tt $(,$linebefore:tt $(,$lineafter:tt)?)?])? $($key:expr),* => $(->[$indent_v:tt])? $($value:expr),* ) => { 
        $($(newline!($linebefore);)?)?
        msg_render!($level, indent_kv!($($indent)?), $($key),* => indent!($($indent_v)?), $($value),*);
        $($($(newline!($lineafter);)?)?)?
    };
}

#[macro_export]
#[cfg(feature = "trace")] macro_rules!
trace_inner { ( $($a:tt)* ) => { level_helper!([[trace]] $($a)*); } }

#[macro_export]
#[cfg(feature = "debug")] macro_rules!
debug_inner { ( $($a:tt)* ) => { level_helper!([[debug]] $($a)*); } }

#[macro_export]
#[cfg(feature = "info")] macro_rules!
info_inner { ( $($a:tt)* )  => { level_helper!([[info]] $($a)*); } }

#[macro_export]
#[cfg(feature = "warn")] macro_rules!
warn_inner { ( $($a:tt)* )  => { level_helper!([[warn]] $($a)*); } }

#[macro_export]
#[cfg(feature = "error")] macro_rules!
error_inner { ( $($a:tt)* ) => { level_helper!([[error]] $($a)*); } }

#[macro_export]
#[cfg(feature = "crit")] macro_rules!
crit_inner { ( $($a:tt)* )  => { level_helper!([[crit]] $($a)*); } }