custom_debug_derive is a procedural macro. It will run at compile time and transform your program's source code.

Adding `custom_debug_derive` macro(s) as a dependency

Run this command in a terminal, in your project's directory:

cargo add custom_debug_derive

To add it manually, edit your project's Cargo.toml file and add to the [dependencies] section:

custom_debug_derive = "0.6.2"

You may need to import the macro(s) with use custom_debug_derive::*.

Read the custom_debug_derive documentation.

Back to the crate overview.

Readme

custom_debug

Derive Debug with a custom format per field.

Example usage

Here is a showcase of custom_debugs features:

    use custom_debug::Debug;
    use std::fmt;

    #[derive(Debug)]
    struct Foo {
        #[debug(format = "{} things")]
        x: i32,
        #[debug(skip)]
        y: i32,
        #[debug(with = hex_fmt)]
        z: i32,
        #[debug(skip_if = Option::is_none)]
        label: Option<String>,
    }

    fn hex_fmt<T: fmt::Debug>(n: &T, f: &mut fmt::Formatter) -> fmt::Result {
        write!(f, "0x{:02X?}", n)
    }

The resulting debug output would look something like this:

Foo {
    x: 42 things,
    z: 0xAB
}

Field attributes reference

Attributes within a section below are considered mutually exclusive.

Skip attributes


`skip`	Unconditionally skips a field.
`skip_if = path::to::function`	Skips a field if `path::to::function(&field)` returns `true`.

Format attributes


`format = "format string {}"`	Formats a field using a format string. Must contain a placeholder (`{}`) with modifiers of your choice.
`with = path::to::formatter`	Formats a field using `path::to::formatter`. The required signature is `fn(&T, &mut std::fmt::Formatter) -> std::fmt::Result` where `T` is a type compatible with the field's type (i.e. the function can be generic and coercions apply).

Adding custom_debug_derive macro(s) as a dependency

Adding `custom_debug_derive` macro(s) as a dependency