debug-everything 1.0.0

Debug-print everything!
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

#![feature(specialization)]

//! Debug-print everything!
//!
//! If you - like me - frequently find yourself deep in a jungle of generic traits with
//! a sudden need to debug-print some data, this crate is for you.
//! The constant struggle of adding `Debug` bounds everywhere only to remove
//! all of them (or at least the ones you can still find) as soon as you're done is over:
//!
//! ```
//! use debug_everything::Debuggable;
//!
//! fn generic<T>(t: T) {
//!     println!("t = {:?}", t.debug());
//! }
//! ```
//!
//! # How it works
//!
//! Sadly, this relies on specialization and thus only works on nightly (as of May 2019).
//! The `Debuggable` trait is implemented for **all** types but *specialized* for types implementing
//! `Debug`:
//!
//! ```
//! use debug_everything::Debuggable;
//! struct Dummy;
//! 
//! assert_eq!("42", format!("{:?}", 42.debug()));
//! assert_eq!("<no Debug impl>", format!("{:?}", Dummy.debug()));
//! ```
//!
//! Simple!

use std::fmt::{Debug, Formatter, Result as FmtResult};

pub trait Debuggable {
    fn debug(&self) -> &dyn Debug;
}

struct NotDebug;
impl Debug for NotDebug {
    fn fmt(&self, fmt: &mut Formatter) -> FmtResult {
        fmt.write_str("<no Debug impl>")
    }
}

impl<T> Debuggable for T {
    default fn debug(&self) -> &dyn Debug { &NotDebug }
}

impl<T: Debug> Debuggable for T {
    fn debug(&self) -> &dyn Debug { self }
}