tracing_log_error 0.1.3

A set of helpers to capture rich error context in tracing logs
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

# Debugging 

Developing complex `macro_rules!`, such as `log_error!`, can be challenging. 
To help with debugging, consider using these tools:

- The `-Z macro-backtrace` and `-Z trace-macros` unstable compiler flags.
  In particular, `trace-macros` provides a step-by-step expansion of a `macro_rules!` invocation.
  If you're investigating the test invocations, go for:
  ```bash
  RUSTFLAGS="-Z macro-backtrace -Z trace-macros" cargo +nightly test
  ```
  If you're investigating the doc tests, go for:
  ```bash
  RUSTDOCFLAGS="-Z macro-backtrace -Z trace-macros" cargo +nightly test --doc
  ```
  The above is particularly useful if you're trying to understand a macro that's expanding
  to code that doesn't compile or if it fails due to exceeding the compiler recursion limit.
- A [railroad visualization](https://lukaslueg.github.io/macro_railroad_wasm_demo/) of the macro 
  matching rules.