woah

一种将可处理的本地错误和不可处理的致命错误分开的 Result。

有时候，你希望能够在不处理某些错误的情况下将错误向上传递，同时方便地在本地级别处理其他类型的错误。你可能试图通过在 Result 上进行手动模式匹配，或者通过构建 Result<Result<T, LocalError>, FatalError> 来实现这一点。相反，你可以使用 woah！

示例

use woah::prelude::*;
use rand::prelude::*;

fn main() {
    match get_data() {
        Success(data) => println!("{}", data),
        LocalErr(e) => eprintln!("error: {:?}", e),
        FatalErr(e) => eprintln!("error: {:?}", e),
    }
}

/// Get data from an HTTP API.
fn get_data() -> Result<String, LocalError, FatalError> {
    match do_http_request()? {
        Ok(data) => Success(data),
        Err(e) => {
            eprintln!("error: {:?}... retrying", e);
            get_data()
        }
    }
}

/// Make an HTTP request.
///
/// This is simulated with randomly returning either a time out
/// or a request failure.
fn do_http_request() -> Result<String, LocalError, FatalError> {
    if random() {
        LocalErr(LocalError::RequestTimedOut)
    } else {
        FatalErr(FatalError::RequestFailed)
    }
}

/// Errors which can be handled.
#[derive(Debug)]
enum LocalError {
    RequestTimedOut,
}

/// Errors which can't be handled.
#[derive(Debug)]
enum FatalError {
    RequestFailed,
}

使用

woah 可以在稳定版 Rust 中使用，但在 nightly 版本中使用最佳。

在 nightly 版本中，启用 nightly 功能后，你可以使用 Try trait，它允许使用 ? 操作符来传播致命错误。在稳定版中，你必须将 std::result::Result 转换为 ? 操作符，这不太方便。

特性

许可证

woah 采用 MIT 或 Apache 2.0 双重许可。