iprint-rs is a Rust utility library for indented printing and logging, designed to help you easily trace the execution of your code. The library provides a suite of macros for indented formatting (iformat), simplified indented printing (iprintln), and logging with varying levels (itrace, idebug, iinfo, iwarn, ierror). All features are geared to improve debugging and code tracing by automatically adjusting indentation based on the function call depth.
This library may not function correctly when compiled in release mode due to function inlining. It is recommended to use it in debug mode for accurate results.
println!, adding automatic indentation.iformat macro allows for custom indented formatting.call_depth macro provides the current depth of the function call stack, useful for custom logging or tracing solutions.itrace, idebug, iinfo, iwarn, ierror) that are feature-gated by the log feature.To include iprint-rs in your project, add the following to your Cargo.toml:
toml
[dependencies]
iprint-rs = "0.1.0" # Use the latest version
To enable logging functionalities, update your Cargo.toml like so:
toml
[dependencies]
iprint-rs = { version = "0.1.0", features = ["log"] }
```rust use iprint::iprintln;
fn myfunction() { iprintln!("This is like println! but with automatic indentation."); anotherfunction(); iprintln!("This will be indented like the first iprintln!"); }
fn another_function() { indent!("This message will be more indented."); } ```
```rust use iprint::iformat;
fn my_function() { let msg = iformat!("This will be indented based on call depth."); println!("{}", msg); } ```
```rust use iprint::call_depth;
fn customlogging() { let depth = calldepth!(); println!("Current call depth: {}", depth); } ```
To use logging functions, make sure you have the log feature enabled.
```rust use iprint::iinfo;
fn yetanotherfunction() { iinfo!("This is an informational message with automatic indentation."); } ```
This project is licensed under the MIT License. See the LICENSE.md file for details.