peace_fmt 0.0.15

//! Presentation and formatting support for the peace automation framework.
//!
//! See [Output Presentation].
//!
//! [Output Presentation]: https://peace.mk/book/technical_concepts/output/presentation.html

// Re-exports
pub use async_trait::async_trait;

pub use crate::{
    either::Either, presentable::Presentable, presentable_ext::PresentableExt, presenter::Presenter,
};

pub mod presentable;

mod either;
mod presentable_ext;
mod presenter;

/// Ergonomically present multiple [`Presentable`]s.
///
/// # Examples
///
/// ```rust,ignore
/// use peace_fmt::{present, Presentable};
///
/// present!(output, "a str", item, "\n");
/// ```
#[macro_export]
macro_rules! present {
    ($output:ident, [$($p:expr),+]) => {
        $($output.present($p).await?;)+
    };
}

/// Ergonomically present multiple [`Presentable`]s.
///
/// # Examples
///
/// ```rust,ignore
/// use peace_fmt::{present, Presentable};
///
/// presentln!(output, "a str", item, "\n");
/// ```
#[macro_export]
macro_rules! presentln {
    ($output:ident, [$($p:expr),+]) => {
        $($output.present($p).await?;)+
        $output.present("\n").await?;
    };
}