12 releases
0.5.3 | Oct 11, 2024 |
---|---|
0.5.2 | Oct 10, 2022 |
0.5.1 | Aug 21, 2022 |
0.4.3 | Jun 4, 2022 |
0.2.0 | Nov 13, 2020 |
#282 in Rust patterns
172 downloads per month
Used in 3 crates
(2 directly)
42KB
1K
SLoC
expect-exit: display an error message and exit without a panic
Note: This library is deprecated, and it is in maintenance mode.
The anyhow
library may be a better choice for both new and existing programs.
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>