Utilities for reporting fatal errors and exiting with an error code.

The behavior in this crate is different than the one in panic!-based exits, in that the ones here are suited for display to end-users, i.e. no "thread main panicked at", no backtrace mentions, etc.

Usage

For unwrapping Results:

• Use unwrap_message! to provide context.
• Use unwrap_format! to have more control over the message's format.
• Use unwrap / unwrap_fatal to report the error when context is provided/obvious.

For aborting:

• Use error! to report context + error.
• Use fatal! when error!'s prefix is unwelcome.

(Pseudo-)Example:

const DB_CONSTR_VAR: &str = "DB_CONNECTION_STRING";

fn main() {
let constr: String = fatal::unwrap_message!(std::env::var(DB_CONSTR_VAR), "failed to read the `{}` environment variable", DB_CONSTR_VAR);
// when doesn't exist, will print: "Error: failed to read the `DB_CONNECTION_STRING` environment variable (environment variable not found)"
println!("Connecting to database..");
let db: Database = fatal::unwrap(Database::connect(&constr));
println!("Total users: {}", db.query_total_users());
}