zlsrs 0.1.0

/// # zerror 错误处理
///
/// 错误处理模块，提供了一些便捷的错误处理工具函数。
///
/// ## 特点
///
/// - 提供通用的错误捕获函数
/// - 支持 panic 和 Error 的统一处理
/// - 简化错误处理流程
///
/// ## 示例
///
/// ```rust
/// use zlsrs::zerror::try_catch;
///
/// fn main() {
///     // 捕获可能发生的错误
///     let result = try_catch(|| {
///         // 这里是可能产生错误的代码
///         if true {
///             Ok(())
///         } else {
///             Err("发生错误".into())
///         }
///     });
///     
///     match result {
///         Ok(_) => println!("执行成功"),
///         Err(e) => println!("捕获到错误: {}", e),
///     }
/// }
/// ```
use std::error::Error;
use std::panic::{self, UnwindSafe};

/// 通用错误捕获函数，可以同时处理 panic 和 Result 类型的错误。
///
/// # 功能
///
/// - 捕获函数执行过程中的 panic
/// - 处理 Result 类型的错误
/// - 将所有错误统一转换为 String 类型
///
/// # 参数
///
/// * `f` - 需要执行的闭包函数，该函数返回 Result 类型
///
/// # 返回值
///
/// 返回 `Result<(), String>` 类型：
/// - `Ok(())` 表示执行成功
/// - `Err(String)` 包含错误信息的字符串
///
/// # 示例
///
/// ```rust
/// use zlsrs::zerror::try_catch;
///
/// // 处理正常的 Result 错误
/// let result = try_catch(|| {
///     Err("测试错误".into())
/// });
/// assert!(result.is_err());
///
/// // 处理 panic
/// let result = try_catch(|| {
///     panic!("发生 panic");
///     #[allow(unreachable_code)]
///     Ok(())
/// });
/// assert!(result.is_err());
/// ```
pub fn try_catch<F>(f: F) -> Result<(), String>
where
    F: FnOnce() -> Result<(), Box<dyn Error + Send + Sync>> + UnwindSafe,
{
    match panic::catch_unwind(f) {
        Ok(result) => match result {
            Ok(_) => Ok(()),
            Err(e) => Err(e.to_string()),
        },
        Err(panic) => {
            let panic_msg = if let Some(s) = panic.downcast_ref::<&str>() {
                (*s).to_string()
            } else if let Some(s) = panic.downcast_ref::<String>() {
                s.clone()
            } else if let Some(s) = panic.downcast_ref::<&String>() {
                (*s).to_string()
            } else {
                format!("{:?}", panic)
            };
            Err(panic_msg)
        }
    }
}