#development #debugging #macros #here

no-std here

A simple rust macro to print the current file and line number

3 stable releases

1.1.1 Jul 14, 2021
1.1.0 Jun 23, 2021
1.0.0 Jun 19, 2021

#32 in #development

43 downloads per month
Used in 2 crates (via segsource-derive)

MIT license

10KB
108 lines

here

One of the oldest and still most commonly used debugging techniques looks something like this:

// Do something
println!("here");
// Do something else

Or if you're feeling real fancy:

// Do something
println!("here 1");
// Do something else
println!("here 2");
// Do yet another thing

It's rather crude, but it's effective... as long as you can find where you put the print statements.

Well, [here] is here to help! Usage is simple:

here!(); // prints "filename:lineno" to stdout

What's that? You want to print to stderr instead of stdout? Then just use [ehere]. It's the same great taste as [here], but with stderr!

Oh? So you've decided to use the wonderful log crate? Don't worry, we've got you covered there, too. With the optional log feature enabled, you get five new macros! One for each log level!

here_trace!(); // log a trace message of "filename:lineno"
here_debug!(); // log a debug message of "filename:lineno"
here_info!(); // log a info message of "filename:lineno"
here_warn!(); // log a warn message of "filename:lineno"
here_error!(); // log a error message of "filename:lineno"

Huh? You want add more information? Don't worry we've got you covered. Each here macro can accept a format string and arguments just like the format! macro!

here!("A message."); // prints "(filename:lineno): A message."
here!("Something: 0x{:02x}", 16);  // prints "(filename:lineno): Something: 0x0f"

License: MIT

Dependencies

~22KB