3 releases (breaking)

Uses old Rust 2015

0.5.0 Mar 7, 2024
0.4.0 Jan 10, 2023
0.3.3 Jan 16, 2021

#408 in Command line utilities

Download history 6/week @ 2024-02-14 32/week @ 2024-02-21 6/week @ 2024-02-28 152/week @ 2024-03-06 14/week @ 2024-03-13

209 downloads per month
Used in 2 crates

MIT license

16KB
164 lines

die-exit

GitHub GitHub Workflow Status Latest Version Documentation

die-exit is a simple Rust library to make it easy to handle errors and exit in command line programs. It is forked from the die library, but includes an additional test feature which will replace exit behaviour with a call to panic! in order to facilitate testing.

Cargo.toml

[dependencies]
die-exit = "0.5"

[dev-dependencies.die-exit]
version = "0.5"
features = ["test", "red"]

Example usage

use die_exit::*;
// Result:
Ok(1).die("no number"); // unwraps to 1 successfully
Err("failure").die("strange error"); // prints `strange error` to stderr then exits with code 1

// Option:
Some(1).die("no number"); // unwraps to 1 successfully
None.die("none option"); // prints `none option` to stderr then exits with code 1

// custom error codes:
Err("failure").die_code("strange error", 4); // prints `strange error` to stderr then exits with code 4
None.die_code("none option", 5); // prints `none option` to stderr then exits with code 5

// with function (Result only):
Err("failure").die_with(|error| format!("strange error: {}", error)); // prints `strange error: failure` to stderr then exits with code 1
Err("failure").die_with(|error| (format!("strange error: {}", error), 6)); // prints `strange error: failure` to stderr then exits with code 6

// die! macro:
die!("argument to -e must be numeric"); // prints message to stderr then exits with code 1
die!(2; "argument to -e must be numeric"); // prints message to stderr then exits with code 2
die!("argument to -e must be numeric"; 3); // prints message to stderr then exits with code 3
die!("argument {} must be {}", "-e", 1; 4); // prints `argument -e must be 1` to stderr then exits with code 4
die!("argument {} must be {}", "-e", 1); // prints `argument -e must be 1` to stderr then exits with code 1
die!(2); // prints nothing, only exits with code 3
die!(); // prints nothing, only exits with code 1

Example testing

Ensure that the test feature is turned on.

#[cfg(test)]
mod tests {
    use super::*;
    use die_exit::*;

    #[test]
    #[should_panic]
    fn die_test() {
        die!("Die works in tests!"; exit_codes::COMPILER_ERROR);
    }
}

cargo Features

  • test: Turn this on if you want to run tests where die might be used. This will change the behaviour of die and its variants to call panic!() instead of process::exit().
  • red: Red and bold output.

License

This project is licensed under the MIT license (LICENSE-MIT http://opensource.org/licenses/MIT)

No runtime deps

Features