fmty 0.1.1

Composable `core::fmt` utilities.
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

/// Like [`format_args!`](crate::format_args!) or [`fmt_with()`](crate::fmt_with())
/// depending on usage.
///
/// This macro accepts either a formatting arguments or a closure. It is similar
/// to [`format::lazy_format!`](https://docs.rs/format/0.2.*/format/macro.lazy_format.html)
/// with the added benefit of being a declarative macro rather than a procedural
/// macro.
///
/// This always returns
/// <code>[FmtWith]<impl [Fn]\(&mut [Formatter]\) -> [Result]></code>.
///
/// [FmtWith]: crate::types::FmtWith
/// [Formatter]: core::fmt::Formatter
/// [Result]: core::fmt::Result
///
/// # Examples
///
/// ```
/// let a = fmty::fmt!("hola");
/// let b = fmty::fmt!("{}", "hola");
/// let c = fmty::fmt!(|f| f.write_str("hola"));
///
/// assert_eq!(a.to_string(), b.to_string());
/// assert_eq!(a.to_string(), c.to_string());
/// ```
#[macro_export]
macro_rules! fmt {
    ($fmt:literal $($rest:tt)*) => {
        $crate::format_args!($fmt $($rest)*)
    };
    ($fn:expr) => {
        $crate::fmt_with($fn)
    };
}