#error #try #ergonomic

macro try-catch

A simple proc-macro that enables try-catch for Rust with automatic downcasting of error types

4 releases

0.2.2 Aug 21, 2021
0.2.1 Aug 21, 2021
0.2.0 Aug 21, 2021
0.1.0 Aug 21, 2021

#5 in #ergonomic

Download history 272/week @ 2024-03-12 271/week @ 2024-03-19 661/week @ 2024-03-26 310/week @ 2024-04-02 195/week @ 2024-04-09 305/week @ 2024-04-16 233/week @ 2024-04-23 224/week @ 2024-04-30 222/week @ 2024-05-07 242/week @ 2024-05-14 229/week @ 2024-05-21 229/week @ 2024-05-28 209/week @ 2024-06-04 205/week @ 2024-06-11 353/week @ 2024-06-18 190/week @ 2024-06-25

1,012 downloads per month
Used in 200 crates (3 directly)

Apache-2.0

9KB
140 lines

This crate provides a macro that enables the familiar try-catch syntax of other programming languages. It can be used to easlily group errors and manage them dynamically by type rather than value.

use try_catch::catch;
use std::*;
use serde_json::Value;

catch! {
    try {
        let number: i32 = "10".parse()?;
        let data = fs::read_to_string("data.json")?;
        let json: Value = serde_json::from_str(&data)?;
    }
    catch error: io::Error {
        println!("Failed to open the file: {}", error)
    }
    catch json_err: serde_json::Error {
        println!("Failed to serialize data: {}", json_err)
    }
    catch err {
        println!("Error of unknown type: {}", err)
    }
};

Note, if no wildcard is present then the compiler will warn about unused results. It can alo be used as an expression:

// We can guarantee that all errors are catched
// so the type of this expression is `i32`.
// It can be guarantieed because the final catch
// does not specify an Error type.
let number: i32 = catch! {
    try {
        let number: i32 = "10".parse()?;
        number
    } catch error {
        0
    }
};
// we can't know for sure if all possible errors are
// handled so the type is still Result.
let result: Result<i32, _> = catch! {
    try {
        let number: i32 = "10".parse()?;
        number
    } catch error: io::Error {
        0
    }
};

Dependencies

~1.5MB
~35K SLoC