restd 0.3.0

/// Create [`Arguments`](crate::fmt::args::Arguments).
///
/// Should not be used directly; rather, use through macros like [`write`] and [`format`].
///
/// See [`restd::fmt`](crate::fmt) for details on the syntax.
#[macro_export]
macro_rules! format_args {
    () => {
        $crate::fmt::args::Arguments(&[])
    };

    ($(
        $(  $el_id:ident $( . $el_id_field:tt )* )?
        $(  $el_li:literal )?
        $({ $el_ex:expr   })?
        $( as $style:expr )?
    ),+ ,) => {
        $crate::format_args!($(
            $( $el_id $($el_id_field)* )?
            $( $el_li )?
            $( { $el_ex } )?
            $( as $style )?
        ),+)
    };

    ($(
        $(  $el_id:ident $( . $el_id_field:tt )* )?
        $(  $el_li:literal )?
        $({ $el_ex:expr   })?
        $( as $style:expr )?
    ),+) => {
        $crate::fmt::args::Arguments(&[$(
            $crate::fmt::args::Var::new(
                $(&$el_id $(.$el_id_field)*,)?
                $(&$el_li,)?
                $(&$el_ex,)?

                $crate::_if_else!(
                    [$( &$style )?]
                    else
                    [&$crate::fmt::Display]
                )
            ),
        )*])
    };
}

/// Create [`Arguments`](crate::fmt::args::Arguments) with a following newline.
///
/// Should not be used directly; rather, use through macros like [`writeln`] and [`println`].
///
/// See [`restd::fmt`](crate::fmt) for details on the syntax.
#[macro_export]
macro_rules! format_args_nl {
    () => {
        $crate::fmt::args::Arguments(&[])
    };

    ($(
        $(  $el_id:ident $( . $el_id_field:tt )* )?
        $(  $el_li:literal )?
        $({ $el_ex:expr   })?
        $( as $style:expr )?
    ),+ ,) => {
        $crate::format_args_nl!($(
            $( $el_id $($el_id_field)* )?
            $( $el_li )?
            $( { $el_ex } )?
            $( as $style )?
        ),+)
    };

    ($(
        $(  $el_id:ident $( . $el_id_field:tt )* )?
        $(  $el_li:literal )?
        $({ $el_ex:expr   })?
        $( as $style:expr )?
    ),+) => {
        $crate::fmt::args::Arguments(&[$(
            $crate::fmt::args::Var::new(
                $(&$el_id $(.$el_id_field)*,)?
                $(&$el_li,)?
                $(&$el_ex,)?

                $crate::_if_else!(
                    [$( &$style )?]
                    else
                    [&$crate::fmt::Display]
                )
            ),
        )*
            $crate::fmt::args::Var::new(&'\n', &$crate::fmt::Display),
        ])
    };
}

/// Write formatted data into a [`Write`](crate::fmt::Write)r.
///
/// See [`restd::fmt`](crate::fmt) for details on the syntax.
#[macro_export]
macro_rules! write {
    ($dst:expr, $($t:tt)*) => {
        $dst.write_args($crate::format_args!($($t)*))
    };
}

/// Write formatted data into a [`Write`](crate::fmt::Write)r with a following newline.
///
/// See [`restd::fmt`](crate::fmt) for details on the syntax.
#[macro_export]
macro_rules! writeln {
    ($dst:expr $(,)?) => {
        $crate::write!($dst, '\n')
    };

    ($dst:expr, $($t:tt)*) => {
        $dst.write_args($crate::format_args_nl!($($t)*))
    };
}

#[cfg(any(feature = "std", test))]
mod with_std {
    /// Create a string with formatted data.
    ///
    /// See [`restd::fmt`](crate::fmt) for details on the syntax.
    #[macro_export]
    macro_rules! format {
        ($($t:tt)*) => {
            $crate::fmt::_format($crate::format_args!($($t)*))
        };
    }

    /// Print formatted data to stdout.
    ///
    /// See [`restd::fmt`](crate::fmt) for details on the syntax.
    #[macro_export]
    macro_rules! print {
        ($($t:tt)*) => {
            $crate::fmt::_print($crate::format_args!($($t)*))
        };
    }

    /// Print formatted data to stdout with a following newline.
    ///
    /// See [`restd::fmt`](crate::fmt) for details on the syntax.
    #[macro_export]
    macro_rules! println {
        ($($t:tt)*) => {
            $crate::fmt::_print($crate::format_args_nl!($($t)*))
        };
    }

    /// Print formatted data to stderr.
    ///
    /// See [`restd::fmt`](crate::fmt) for details on the syntax.
    #[macro_export]
    macro_rules! eprint {
        ($($t:tt)*) => {
            $crate::fmt::_eprint($crate::format_args!($($t)*))
        };
    }

    /// Print formatted data to stderr with a following newline.
    ///
    /// See [`restd::fmt`](crate::fmt) for details on the syntax.
    #[macro_export]
    macro_rules! eprintln {
        ($($t:tt)*) => {
            $crate::fmt::_eprint($crate::format_args_nl!($($t)*))
        };
    }

    /// Prints and returns the value of an expression for quick and dirty debugging.
    #[macro_export]
    macro_rules! dbg {
        ($($x:expr),+ $(,)?) => {($(
            match $x {
                x => {
                    $crate::eprintln!(
                        "[",
                        { ::core::file!() },
                        ":",
                        { ::core::line!() },
                        ":",
                        { ::core::column!() },
                        "] ",
                        { ::core::stringify!($x) },
                        " = ",
                        x as $crate::fmt::Pretty(0)
                    );
                    x
                }
            }
        ),+)};
    }
}

#[doc(hidden)]
#[macro_export]
macro_rules! _if_else {
    ( [] else [$($t:tt)*] ) => { $($t)* };
    ( [$($t:tt)*] else [$($_:tt)*] ) => { $($t)* };
}