pi_result 0.2.0

Thin, typed, and observable Result aliases and error interoperability utilities
Documentation
//! `pi_result` 预导入模块。
//!
//! 该模块聚合 `pi_result` 最常用的类型别名、trait 与依赖 re-export,
//! 方便调用方使用:
//!
//! ```rust
//! use pi_result::prelude::*;
//!
//! let report = Err::<(), std::io::Error>(std::io::Error::from(std::io::ErrorKind::NotFound))
//!     .attach(Operation("load_config"))
//!     .into_error(ErrorKind::NotFound)
//!     .expect_err("expected public report");
//!
//! assert_eq!(report.current_kind(), &ErrorKind::NotFound);
//! ```

pub use crate::attachment::*;
pub use crate::boundary::{IntoErrorExt, IntoTypedContextExt};
pub use crate::fmt::{debug_message, user_message, verbose_message};
pub use crate::inspect::ErrorInspectExt;
#[cfg(nightly)]
pub use crate::inspect::{
    NightlyErrorInspectExt, RequestRef, RequestValue, request_refs, request_values,
};
pub use crate::interop::{
    ClassifyErrorKind, ExternalError, InteropResultExt, classify_io_error, source_type_name_of,
};
pub use crate::kind::ErrorKind;
pub use crate::result::{Error, ErrorReport, RawResult, Result, TypedResult};
pub use crate::{bail, ensure};
pub use error_stack;
pub use error_stack::{Report, ResultExt};
pub use crate::thiserror;
pub use crate::thiserror::Error as ThisError;

#[cfg(test)]
mod tests {
    use super::*;

    fn assert_send_sync<T: Send + Sync>() {}

    #[test]
    fn test_prelude_reexports_core_types() {
        let _kind = ErrorKind::Internal;
        let _result: Result<()> = Err(Report::new(ErrorKind::Internal));
        let _raw: RawResult<(), ()> = Ok(());
        let _typed: TypedResult<(), ErrorKind> = Err(Report::new(ErrorKind::Dependency));
    }

    #[test]
    fn test_prelude_reexports_result_ext_and_custom_traits() {
        let report = Err::<(), std::io::Error>(std::io::Error::from(std::io::ErrorKind::NotFound))
            .attach(Operation("load_file"))
            .into_error(ErrorKind::NotFound)
            .expect_err("expected report");

        assert_eq!(report.current_kind(), &ErrorKind::NotFound);
        assert_send_sync::<Report<ErrorKind>>();
    }
}