#proc-macro #trace #tracing #execution #procedural #functions #func

macro func_trace

A procedural macro for tracing the execution of functions

4 stable releases

1.0.3 Mar 15, 2021
1.0.2 Mar 13, 2021

#93 in #execution


Used in tps_minicbor

MIT license

31KB
567 lines

trace Build Status Latest Version Documentation

A procedural macro for tracing the execution of functions.

Adding #[trace] to the top of functions, mods, or impls will insert println! statements at the beginning and the end of the affected functions, notifying you of when that function was entered and exited and printing the argument and return values. Useful for quickly debugging whether functions that are supposed to be called are actually called without manually inserting print statements.

See the examples directory and the documentation for more detail on how to use and configure this library.

Installation

Add it as a dependency in your Cargo.toml file:

[dependencies]
func_trace = "^1.0.3"

Example

use func_trace::trace;

func_trace::init_depth_var!();

fn main() {
    foo(1, 2);
}

#[trace]
fn foo(a: i32, b: i32) {
    println!("I'm in foo!");
    bar((a, b));
}

#[trace(prefix_enter="[ENTER]", prefix_exit="[EXIT]")]
fn bar((a, b): (i32, i32)) -> i32 {
    if a == 1 {
        2
    } else {
        b
    }
}

Output:

[+] Entering foo(a = 1, b = 2)
  [ENTER] Entering bar(a = 1, b = 2)
  [EXIT] Exiting bar = 2
[-] Exiting foo = ()

Dependencies

~1.5MB
~35K SLoC