Struct PanicInfo 

#[non_exhaustive]
pub struct PanicInfo {
    pub thread: Txt,
    pub message: Txt,
    pub file: Txt,
    pub line: u32,
    pub column: u32,
    pub widget_path: Txt,
    pub backtrace: Txt,
}

Panic parsed from a stderr dump.

Compatibility

The parser can seek only the latest Rust stable panic format, to ensure compatibility call PanicInfo::set_hook on the child process is possible.

Fields (Non-exhaustive)

Non-exhaustive structs could have additional fields added in future. Therefore, non-exhaustive structs cannot be constructed in external crates using the traditional Struct { .. } syntax; cannot be matched against without a wildcard ..; and struct update syntax will not work.

thread: Txt

Name of thread that panicked.

message: Txt

Panic message.

file: Txt

Path to file that defines the panic.

line: u32

Line of code that defines the panic.

column: u32

Column in the line of code that defines the panic.

widget_path: Txt

Widget where the panic happened.

Only available in processes that use PanicInfo::set_hook.

backtrace: Txt

Stack backtrace.

Implementations

impl PanicInfo

pub fn display_no_backtrace(&self) -> impl Display

Returns an object that implements fmt::Display to write only the thread name, location, message and widget path.

impl PanicInfo

pub fn contains(stderr: &str) -> bool

Gets if stderr contains a panic that can be parsed by find.

pub fn contains_widget(stderr: &str) -> bool

Gets if stderr contains a panic that can be parsed by find and traced a widget/window path.

pub fn find(stderr: &str) -> Option<Self>

Try parse stderr for the last panic printout.

Only reliably works if the panic fully printed correctly and was formatted by PanicInfo::set_hook.

pub fn backtrace_frames(&self) -> impl Iterator<Item = BacktraceFrame> + '_

Iterate over frames parsed from the backtrace.

impl PanicInfo

pub fn set_hook(widget_trace_path: impl Fn() -> Txt + Send + Sync + 'static)

Set a panic hook that will print panics to stderr in a format compatible with PanicInfo parsing.

The widget_trace_path should be a closure that return WIDGET.trace_path() if the process can run an APP, otherwise it must be Txt::default.

The panic hook calls simply eprint_panic.

pub fn eprint_panic(info: &PanicHookInfo<'_>, widget_trace_path: &str)

Print panic to stderr in a format compatible with PanicInfo parsing.

This function is called by the hook set by set_hook.

Trait Implementations

impl Clone for PanicInfo

fn clone(&self) -> PanicInfo

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for PanicInfo

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PanicInfo

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Display for PanicInfo

Alternate mode {:#} writes raw backtrace without cleanup and code snippets.

See also PanicInfo::display_no_backtrace

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Eq for PanicInfo

impl Hash for PanicInfo

fn hash<__H: Hasher>(&self, state: &mut __H)

Feeds this value into the given Hasher.

fn hash_slice<H>(data: &[Self], state: &mut H)

where H: Hasher, Self: Sized,

Feeds a slice of this type into the given Hasher.

impl PartialEq for PanicInfo

fn eq(&self, other: &PanicInfo) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for PanicInfo

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for PanicInfo