Crate color_backtrace

Colorful and clean backtraces on panic.

This library aims to make panics a little less painful by nicely colorizing them, skipping over frames of functions called after the panic was already initiated and printing relevant source snippets. Frames of functions in your application are colored in a different color (red) than those of dependencies (green).

Screenshot

Features

• Colorize backtraces to be easier on the eyes
• Show source snippets if source files are found on disk
• Print frames of application code vs dependencies in different color
• Hide all the frames after the panic was already initiated
• Hide language runtime initialization frames

Installing the panic handler

In your main function, just insert the following snippet. That’s it!

color_backtrace::install();

If you want to customize some settings, you can instead do:

use color_backtrace::{default_output_stream, BacktracePrinter};
BacktracePrinter::new().message("Custom message!").install(default_output_stream());

Controlling verbosity

The default verbosity is configured via the RUST_BACKTRACE environment variable. An unset RUST_BACKTRACE corresponds to minimal, RUST_BACKTRACE=1 to medium and RUST_BACKTRACE=full to full verbosity levels.

Re-exports

• pub use termcolor;

Structs

• BacktracePrinter
  Pretty-printer for backtraces and PanicInfo structs.
• ColorScheme
  Color scheme definition.
• Frame

Enums

• Verbosity
  Defines how verbose the backtrace is supposed to be.

Functions

• create_panic_handlerDeprecated
• default_frame_filter
  The default frame filter. Heuristically determines whether a frame is likely to be an uninteresting frame. This filters out post panic frames and runtime init frames and dependency code.
• default_output_stream
  Create the default output stream.
• install
  Install a BacktracePrinter handler with ::default() settings.
• install_with_settingsDeprecated
• print_backtraceDeprecated
• print_panic_infoDeprecated

Type Aliases

• FilterCallback
• SettingsDeprecated