#exit #expect #panic #terminate

bin+lib expect-exit

Result.expected(): display an error message and exit without a panic

11 releases

0.5.2 Oct 10, 2022
0.4.3 Jun 4, 2022
0.4.1 Sep 1, 2021
0.4.0 Jun 22, 2021
0.2.0 Nov 13, 2020

#356 in Rust patterns

Download history 7/week @ 2023-07-28 7/week @ 2023-08-04 9/week @ 2023-08-11 21/week @ 2023-08-18 17/week @ 2023-08-25 19/week @ 2023-09-01 23/week @ 2023-09-08 17/week @ 2023-09-15 9/week @ 2023-09-22 11/week @ 2023-09-29 15/week @ 2023-10-06 27/week @ 2023-10-13 66/week @ 2023-10-20 98/week @ 2023-10-27 42/week @ 2023-11-03 143/week @ 2023-11-10

357 downloads per month
Used in git-select-branch

BSD-2-Clause

49KB
1K SLoC

expect-exit: display an error message and exit without a panic

The expect-exit library defines the Expected, ExpectedWithError, and ExpectedResult traits and implements them for the standard Result and Option types as appropriate. This allows a program to display an error message and exit with a non-zero exit code without invoking a Rust panic, yet optionally unwinding the stack so that various objects may perform some clean-up actions.

The methods with an _e suffix append an appropriate error message to the supplied one. The methods with a _ suffix allow the caller to specify an already-constructed message instead of a function that returns it.

Example

use expect_exit::{Expected, ExpectedResult};

{
    env::var(name).or_exit(|| format!("{} not specified in the environment", name))

    fs::read_to_string(path).or_exit_e(|| format!("Could not read {:?}", path))

    tx.send(result).await.or_exit_e_("Could not tell the main thread");

    let config = parse().expect_result_("Could not parse the config")?;
    Ok(config.value + 1)
}

For the crate's change history, see the NEWS.md file in the source distribution.

Author: Peter Pentchev <roam@ringlet.net>

No runtime deps