Struct comfy_wgpu::color_backtrace::BacktracePrinter

pub struct BacktracePrinter { /* private fields */ }

Pretty-printer for backtraces and PanicInfo structs.

Implementations

impl BacktracePrinter

Builder functions.

pub fn new() -> BacktracePrinter

Alias for BacktracePrinter::default.

pub fn color_scheme(self, colors: ColorScheme) -> BacktracePrinter

Alter the color scheme.

Defaults to ColorScheme::classic().

pub fn message(self, message: impl Into<String>) -> BacktracePrinter

Controls the “greeting” message of the panic.

Defaults to "The application panicked (crashed)".

pub fn verbosity(self, v: Verbosity) -> BacktracePrinter

Controls the verbosity level used when installed as panic handler.

Defaults to Verbosity::from_env().

pub fn lib_verbosity(self, v: Verbosity) -> BacktracePrinter

Controls the lib verbosity level used when formatting user provided traces.

Defaults to Verbosity::lib_from_env().

pub fn strip_function_hash(self, strip: bool) -> BacktracePrinter

Controls whether the hash part of functions is stripped.

Defaults to false.

pub fn print_addresses(self, val: bool) -> BacktracePrinter

Controls whether addresses (or module offsets if available) should be printed.

Defaults to false.

pub fn add_frame_filter( self, filter: Box<dyn Fn(&mut Vec<&Frame, Global>) + Send + Sync, Global> ) -> BacktracePrinter

Add a custom filter to the set of frame filters

Filters are run in the order they are added.

Example

use color_backtrace::{default_output_stream, BacktracePrinter};

BacktracePrinter::new()
    .add_frame_filter(Box::new(|frames| {
        frames.retain(|x| matches!(&x.name, Some(n) if !n.starts_with("blabla")))
    }))
    .install(default_output_stream());

pub fn clear_frame_filters(self) -> BacktracePrinter

Clears all filters associated with this printer, including the default filter

impl BacktracePrinter

Routines for putting the panic printer to use.

pub fn install(self, out: impl WriteColor + Sync + Send + 'static)

Install the color_backtrace handler with default settings.

Output streams can be created via default_output_stream() or using any other stream that implements termcolor::WriteColor.

pub fn into_panic_handler( self, out: impl WriteColor + Sync + Send + 'static ) -> Box<dyn Fn(&PanicInfo<'_>) + Send + Sync, Global>

Create a color_backtrace panic handler from this panic printer.

This can be used if you want to combine the handler with other handlers.

pub fn print_trace( &self, trace: &Backtrace, out: &mut impl WriteColor ) -> Result<(), Error>

Pretty-prints a backtrace::Backtrace to an output stream.

pub fn format_trace_to_string(&self, trace: &Backtrace) -> Result<String, Error>

Pretty-print a backtrace to a String, using VT100 color codes.

pub fn print_panic_info( &self, pi: &PanicInfo<'_>, out: &mut impl WriteColor ) -> Result<(), Error>

Pretty-prints a PanicInfo struct to an output stream.

Trait Implementations

impl Clone for BacktracePrinter

fn clone(&self) -> BacktracePrinter

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Debug for BacktracePrinter

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

Formats the value using the given formatter.

impl Default for BacktracePrinter

fn default() -> BacktracePrinter

Returns the “default value” for a type.