#try #ok #wrap #catch #throw

no-std tryvial

Small crate for ok-wrapping and try blocks

2 unstable releases

0.2.0 Oct 18, 2022
0.1.2 Oct 11, 2022
0.1.1 Oct 11, 2022
0.1.0 Oct 10, 2022

#1315 in Rust patterns

Download history 162/week @ 2024-01-04 258/week @ 2024-01-11 299/week @ 2024-01-18 433/week @ 2024-01-25 298/week @ 2024-02-01 172/week @ 2024-02-08 349/week @ 2024-02-15 360/week @ 2024-02-22 404/week @ 2024-02-29 589/week @ 2024-03-07 477/week @ 2024-03-14 422/week @ 2024-03-21 93/week @ 2024-03-28 137/week @ 2024-04-04 456/week @ 2024-04-11 282/week @ 2024-04-18

1,043 downloads per month

MIT/Apache

8KB
62 lines

tryvial

A small crate for Ok-wrapping and try blocks. This is compatible with Result, Option, and any type implementing the unstable std::ops::Try trait.

This crate does not require nightly Rust.

Overview

The macro try_fn is used to perform Ok-wrapping on the return value of a function.

Before:

fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("Enter your name: ");
    let mut name = String::new();
    std::io::stdin().read_line(&mut name)?;
    println!("Hello, {name}!");
    Ok(()) // this is ugly
}

After:

#[try_fn]
fn main() -> Result<(), Box<dyn std::error::Error>> {
    println!("Enter your name: ");
    let mut name = String::new();
    std::io::stdin().read_line(&mut name)?;
    println!("Hello, {name}!");
}

The macro try_block is an implementation of "try blocks" from nightly rust.

let result: Result<T, E> = try_block! {
   let a = do_one(x)?;
   let b = do_two(a)?;
   b
};

The macro wrap_ok simply wraps an expression with the "ok" variant for a given Try type.

assert_eq!(Some(42), wrap_ok!(42));

License

MIT or Apache-2.0

Dependencies

~44KB