Crate dbg_pls

Syntax aware debug printing.

Makes use of syn and prettyplease in order to provide the most canonincal rust debug lines as possible, quickly.

Example usage

use dbg_pls::{pretty, DebugPls};

#[derive(DebugPls, Copy, Clone)]
pub struct Demo {
    foo: i32,
    bar: &'static str,
}

let mut val = [Demo { foo: 5, bar: "hello" }; 10];
val[6].bar = "Hello, world! I am a very long string";

let output = format!("{}", pretty(&val));
let expected = r#"[
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
    Demo {
        foo: 5,
        bar: "Hello, world! I am a very long string",
    },
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
    Demo { foo: 5, bar: "hello" },
]"#;

assert_eq!(output, expected);

Example with highlighting

use dbg_pls::{color, DebugPls};

#[derive(DebugPls, Copy, Clone)]
pub struct Demo {
    foo: i32,
    bar: &'static str,
}

let mut val = [Demo { foo: 5, bar: "hello" }; 10];
val[6].bar = "Hello, world! I am a very long string";

println!("{}", color(&val));

Outputs:

How it works

All DebugPls implementations are forced to output only valid syn::Expr values. These are then formatted using prettyplease::unparse. Finally,

Macros

colorcolors

Prints and returns the value of a given expression for quick and dirty debugging. Same as std::dbg

prettypretty

Prints and returns the value of a given expression for quick and dirty debugging. Same as std::dbg

Structs

DebugList

A helper designed to assist with creation of DebugPls implementations for list-like structures.

DebugMap

A helper designed to assist with creation of DebugPls implementations for maps.

DebugSet

A helper designed to assist with creation of DebugPls implementations for sets.

DebugStruct

A helper designed to assist with creation of DebugPls implementations for structs.

DebugTuple

A helper designed to assist with creation of DebugPls implementations for tuples.

DebugTupleStruct

A helper designed to assist with creation of DebugPls implementations for tuple structs.

Formatter

Tool for formatting, used within DebugPls implementations

Traits

DebugPls

Syntax aware pretty-printed debug formatting.

Functions

colorcolors

Wraps a Debug type into a std::fmt::Debug type for use in regular format!

prettypretty

Wraps a Debug type into a std::fmt::Debug type for use in regular format!

Derive Macros

DebugPlsderive

Derives the standard DebugPls implementation.