- Notifications
You must be signed in to change notification settings - Fork67
Panic messages for humans.
License
Apache-2.0, MIT licenses found
Licenses found
rust-cli/human-panic
Folders and files
| Name | Name | Last commit message | Last commit date | |
|---|---|---|---|---|
Repository files navigation
Panic messages for humans. Handles panics by callingstd::panic::set_hookto make errors nice for humans.
When you're building a CLI, polish is super important. Even though Rust ispretty great at safety, it's not unheard of to access the wrong index in avector or have an assert fail somewhere.
When an error eventually occurs, you probably will want to know about it. Soinstead of just providing an error message on the command line, we can create acall to action for people to submit a report.
This should empower people to engage in communication, lowering the chancespeople might get frustrated. And making it easier to figure out what might becausing bugs.
thread 'main' panicked at 'oops', examples/main.rs:2:3note: Run with `RUST_BACKTRACE=1` for a backtrace.
Well, this is embarrassing.human-panic had a problem and crashed. To help us diagnose the problem you can send us a crash report.We have generated a report file at "/var/folders/zw/bpfvmq390lv2c6gn_6byyv0w0000gn/T/report-8351cad6-d2b5-4fe8-accd-1fcbf4538792.toml". Submit an issue or email with the subject of "human-panic Crash Report" and include the report as an attachment.- Homepage: https://github.com/rust-cli/human-panic- Authors: Yoshua Wuyts <yoshuawuyts@gmail.com>We take privacy seriously, and do not perform any automated error collection. In order to improve the software, we rely on people to submit reports.Thank you kindly!
The error dump file generated byhuman-panic contains the following fields.
name ='single-panic-test'operating_system ='unix:Unknown'crate_version ='0.1.0'explanation ='''Cause: OMG EVERYTHING IS ON FIRE!!!. Panic occurred in file 'tests/single-panic/src/main.rs' at line 8'''method ='Panic'backtrace ='''stack backtrace: 0: 0x55fa0ed4c1b4 - backtrace::backtrace::libunwind::trace::h69e50feca54bfb84 at /home/spacekookie/.cargo/registry/src/github.com-1ecc6299db9ec823/backtrace-0.3.6/src/backtrace/libunwind.rs:53 - backtrace::backtrace::trace::h42967341e0b01ccc at /home/spacekookie/.cargo/registry/src/github.com-1ecc6299db9ec823/backtrace-0.3.6/src/backtrace/mod.rs:42 # ... 8: 0x55fa0ebaac8d - single_panic_test::main::h56a3d326bcecfc36 at tests/single-panic/src/main.rs:8 9: 0x55fa0ebaae91 - std::rt::lang_start::{{closure}}::h09d28d8540038bf8 at /checkout/src/libstd/rt.rs:74 10: 0x55fa0ed732f7 - std::rt::lang_start_internal::{{closure}}::h2e4baf0a27c956a3 at libstd/rt.rs:59 - std::panicking::try::do_call::h73f98ed0647c7274 at libstd/panicking.rs:305 11: 0x55fa0ed8551e - __rust_maybe_catch_panic at libpanic_unwind/lib.rs:101 12: 0x55fa0ed6f7f5 - std::panicking::try::h18fbb145180d4cd9 at libstd/panicking.rs:284 - std::panic::catch_unwind::hc4b6a212a30b4bc5 at libstd/panic.rs:361 - std::rt::lang_start_internal::h8b001b4244930d51 at libstd/rt.rs:58 13: 0x55fa0ebaae71 - std::rt::lang_start::h1b1de624209f414a at /checkout/src/libstd/rt.rs:74 14: 0x55fa0ebaacbd - main 15: 0x7f9946132f29 - __libc_start_main 16: 0x55fa0eba9b79 - _start 17: 0x0 - <unknown>'''
use human_panic::setup_panic;fnmain(){setup_panic!();println!("A normal log message");panic!("OMG EVERYTHING IS ON FIRE!!!")}
It only displays a human-friendly panic message in release mode:
$ cargo run --release
$ cargo add human-panic
Licensed under either of
- Apache License, Version 2.0, (LICENSE-APACHE orhttp://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENSE-MIT orhttp://opensource.org/licenses/MIT)
at your option.
Unless you explicitly state otherwise, any contribution intentionallysubmitted for inclusion in the work by you, as defined in the Apache-2.0license, shall be dual-licensed as above, without any additional terms orconditions.
About
Panic messages for humans.