anyhow-std

此包封装了某些 [std] 功能以生成提供更好错误上下文的 anyhow::Result。

示例：期望一个有效的 UTF8 路径扩展

假设我们正在处理用户提供的路径，并 期望 它具有一个有效的 UTF8 扩展

use std::path::Path;
use anyhow_std::{PathAnyhow, OsStrAnyhow};

fn process_user_path(path: &Path) -> anyhow::Result<()> {
    let extos = path.extension_anyhow()?;
    let ext = extos.to_str_anyhow()?;
    process_user_path_with_extension(path, ext)?;
    Ok(())
}

fn process_user_path_with_extension(path: &Path, extension: &str) -> anyhow::Result<()> {
    todo!("implement path processing of {path:?} for the extension {extension:?}")
}

/*
Now if the user provides a path without an extension, they'll get an
error message with more helpful context:
*/

let res = process_user_path(Path::new("/tmp/no-extension"));
assert!(res.is_err());

let error_message = format!("{:#}", res.err().unwrap());
assert_eq!(
    error_message,
    r#"while processing path "/tmp/no-extension": missing expected extension"#
);

/*
Unix systems can have non-UTF8 paths:
*/

#[cfg(target_family = "unix")]
fn demonstrate_non_utf8_extension() {
    use std::ffi::OsStr;
    use std::os::unix::ffi::OsStrExt;

    let res = process_user_path(Path::new(OsStr::from_bytes(b"/tmp/non-unicode-extension.wacky-\xf3-extension")));
    assert!(res.is_err());

    let error_message = format!("{:#}", res.err().unwrap());
    assert_eq!(
        error_message,
        r#"while processing os string "wacky-�-extension": not valid utf8"#,
    );
}

#[cfg(target_family = "unix")]
demonstrate_non_utf8_extension();

扩展特质

使用一种常见的模式来扩展 [std] 类型

• 提供了一个名为 <std type>Anyhow 的扩展特质，例如：[OsStrAnyhow]
• 提供了针对目标类型的 impl，例如 impl OsStrAnyhow for OsStr { … }
• 为目标类型的某些方法提供了扩展特质方法，方法名为 <method name>_anyhow。这些方法始终返回 anyhow::Result 类型，例如：OsStrAnyhow::to_str_anyhow。
• 此外，还提供了一些 …_anyhow 方法来封装在目标类型上找不到的功能。例如，Path::read_to_string 不存在，但可以作为一个简单的包装器，因此这个包提供了 PathAnyhow::read_to_string_anyhow