narust-158 0.3.1

//! 测试用
//! * ❌【2024-06-20 02:02:25】莫尝试「模块封装+自动导出」省`test::`
//!   * ⚠️报警：`private item shadows public glob re-export`

/// 测试用类型，增强[`anyhow::Result`]
#[cfg(test)]
pub type AResult<T = ()> = anyhow::Result<T>;

/// 测试用宏，简化`Ok(())`
#[cfg(test)]
#[macro_export]
macro_rules! ok {
    () => {
        Ok(())
    };
    ($($code:tt)*) => {
        Ok($($code)*)
    };
}

/// 测试用宏，用于简化调试模式断言
#[macro_export]
macro_rules! debug_assert_matches {
    ($value:expr, $pattern:pat $(, $($tail:tt)*)?) => {
        debug_assert!(matches!($value, $pattern) $(, $($tail)*)?)
    };
}

/// 用「上抛`Err`」代替直接panic
/// * 🎯允许调用者「假定失败」并自行处置错误
/// * 🚩【2024-08-12 21:49:05】提取到crate根目录，以便用于测试
///   * 否则会有`mods!`的「绝对路径导出问题」
#[cfg(test)]
#[macro_export]
macro_rules! assert_try {
    ($bool:expr) => {
        if !$bool {
            return Err(anyhow::anyhow!("assertion failed with {}", stringify!($bool)));
        }
    };
    ($bool:expr, $($fmt_params:tt)*) => {
        if !$bool {
            return Err(anyhow::anyhow!($($fmt_params)*));
        }
    };
}

/// 用「上抛`Err`」代替直接panic
/// * 🎯允许调用者「假定失败」并自行处置错误
/// * 🚩【2024-08-12 21:49:05】提取到crate根目录，以便用于测试
///   * 否则会有`mods!`的「绝对路径导出问题」
#[cfg(test)]
#[macro_export]
macro_rules! assert_eq_try {
    ($left:expr, $right:expr $(, $($fmt_params:tt)*)?) => {
        $crate::assert_try!($left == $right $(, $($fmt_params)*)?)
    };
}