fmt_ext 0.1.2

A simple interface for extending external types with custom implementations of `Debug` and `Display` traits.
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
55
56
57
58
59

## `fmt_ext`

[![Crates.io](https://img.shields.io/crates/v/fmt_ext)](https://crates.io/crates/fmt_ext)
[![docs.rs](https://img.shields.io/docsrs/fmt_ext)](https://docs.rs/fmt_ext)

A simple interface for extending external types with custom implementations of [Debug] and
[Display] traits.

The example below shows how implement custom debug formatting for slices that additionally print
their length.

```rust
use std::{fmt, marker::PhantomData};

use fmt_ext::{debug::*, DebugExt};

// Create a type that will implement custom debug...
struct SliceWithLenDebug<T>(PhantomData<T>);

// Implement custom debug...
impl<T> CustomDebug for SliceWithLenDebug<T>
where
    T: fmt::Debug,
{
    type Target = [T];

    fn fmt_target(target: &Self::Target, f: &mut fmt::Formatter<'_>) -> fmt::Result {
        write!(f, "Slice {{ len: {}, items: {:?} }}", target.len(), target)
    }
}

// Attach custom debug implementation to the target type...
impl<T> AttachDebug<SliceWithLenDebug<T>> for [T] {}

// Look! Now we have just call `debug` method on the target type...
fn main() {
    let numbers = [0, 1, 2, 3];
    println!("{:?}", numbers.debug());

    let strings = vec!["I", "am", "a", "custom", "debug"];
    println!("{:?}", strings.debug());
}
```

All examples are in [this directory].

### Support of `#![no_std]`

`fmt_ext` supports `#![no_std]` mode by default.

### License

`fmt_ext` is distributed under the terms of the MIT license.

[Debug]: https://doc.rust-lang.org/stable/std/fmt/trait.Display.html

[Display]: https://doc.rust-lang.org/stable/std/fmt/trait.Debug.html

[this directory]: https://github.com/ilyavenner/fmt-ext/tree/master/examples