#panic-message #payload #panic

panic-message

Get a panic message from a panic payload

2 unstable releases

0.3.0 Aug 27, 2021
0.2.0 Aug 26, 2021

#725 in Rust patterns

Download history 14555/week @ 2024-12-21 15111/week @ 2024-12-28 17191/week @ 2025-01-04 16275/week @ 2025-01-11 16120/week @ 2025-01-18 21124/week @ 2025-01-25 19580/week @ 2025-02-01 20535/week @ 2025-02-08 21842/week @ 2025-02-15 28807/week @ 2025-02-22 29292/week @ 2025-03-01 35438/week @ 2025-03-08 35331/week @ 2025-03-15 39527/week @ 2025-03-22 32220/week @ 2025-03-29 30116/week @ 2025-04-05

142,721 downloads per month
Used in 73 crates (17 directly)

MIT/Apache

8KB
65 lines

Get a message from a panic payload

See the docs for more info.

License

This project is licensed under either of Apache License, Version 2.0, (LICENSE-APACHE or MIT license (LICENSE-MIT. Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in this crate by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.


lib.rs:

A simple utility to take panic payloads, primarily obtained from obtained from std::panic::catch_unwind or std::panic::set_hook, and converting them into messages (&str's)

panic_message

panic_message takes a payload from [std::panic::catch_unwind] and returns a &str, doing its best attempt to unpack a &str message from the payload, defaulting to the literal "Box<dyn Any>" in an attempt to recreate what rustc does.

Examples

use std::panic::catch_unwind;

let payload = catch_unwind(|| {
    panic!("gus"); }).unwrap_err();

let msg = panic_message::panic_message(&payload);
assert_eq!("gus", msg);

Non-string payload:

use std::panic::catch_unwind;

let payload = catch_unwind(|| {
    std::panic::panic_any(1);
}).unwrap_err();

let msg = panic_message::panic_message(&payload);
assert_eq!("Box<dyn Any>", msg);

get_panic_message

get_panic_message is similar to panic_message, but returns an Option<&str>, returning None when it can't unpack a message from the payload

Examples

use std::panic::catch_unwind;

let payload = catch_unwind(|| {
    panic!("gus");
}).unwrap_err();

let msg = panic_message::get_panic_message(&payload);
assert_eq!(Some("gus"), msg);

Non-string payload:

use std::panic::catch_unwind;

let payload = catch_unwind(|| {
    std::panic::panic_any(1);
}).unwrap_err();

let msg = panic_message::get_panic_message(&payload);
assert_eq!(None, msg);

PanicInfo

This library also offers apis for getting messages from PanicInfo's as returned by std::panic::set_hook:

Example

std::panic::set_hook(Box::new(|pi| {
    println!("{}", panic_message::panic_info_message(pi));
    println!("{:?}", panic_message::get_panic_info_message(pi));
}));

Note

This library has methods that take values that are returned by standard mechanisms to obtain panic payloads, as opposed to a single generic method that takes &dyn Any. This is to prevent misuse. For example, the reason to take PanicInfo and not the &dyn Any as returned by PanicInfo::payload is because Box<dyn Any> can be coerced into &dyn Any, which would make a method that takes &dyn Any possible to misuse with a payload from std::panic::catch_unwind.

No runtime deps