debug-ignore

This library contains DebugIgnore, a newtype wrapper that causes a field to be skipped while printing out Debug output.

Examples

```rust use debug_ignore::DebugIgnore;

// Some structs have many fields with large Debug implementations.

struct InnerStructWithLotsOfDebugInfo { field: &'static str, // ... }

pub struct PublicStruct { inner: DebugIgnore, }

impl PublicStruct { pub fn new() -> Self { Self { inner: DebugIgnore(InnerStructWithLotsOfDebugInfo { field: "field", /* ... */ }) } } }

let x = PublicStruct::new(); assert_eq!(format!("{:?}", x), "PublicStruct { inner: ... }");

// Fields within inner can still be accessed through the Deref impl. assert_eq!(x.inner.field, "field"); ```

Some structs have many fields with large Debug implementations. It can be really annoying to go through a ton of usually irrelevant Debug output.

DebugIgnore is a zero-cost, zero-compile-time way to achieve a Debug impl that skips over a field.

serde: serde support with #[serde(transparent)].

The MSRV is Rust 1.34 though this crate likely builds with older versions. This crate is too trivial to require anything more recent.

Optional features may require newer versions of Rust.

Implement Debug by hand.
derivative has greater control over the behavior of Debug impls, at the cost of a compile-time proc-macro dependency.

Pull requests are welcome! Please follow the code of conduct.

This project is available under the terms of either the Apache 2.0 license or the MIT license.