btparse 0.1.1

A minimal deserializer for inspecting `std::backtrace::Backtrace`'s Debug format.
Documentation

btparse

A minimal deserializer for inspecting std::backtrace::Backtrace's Debug format.

Overview

For the time being, the rust standard library is exporting the smallest API surface for std::backtrace::Backtrace that it possibly can, and only allows inspection via the Debug and Display traits. However, in order to provide custom formatting for backtraces, libraries like color-backtrace need to be able to iterate over the frames of a backtrace and access its various members like the filename and line number.

This library provides a stop-gap solution. Until std eventually exports a stable iterator interface to backtrace frames this library will attempt to provide best effort parsing of backtrace's unstable Debug output. This will allow libraries like color-backtrace to provide unstable support for std::backtrace::Backtrace until it eventually stabilizes.

Once std eventually stabilizes this library will update the internals to depend upon the provided iterator API instead of potentially fragile parsing.

Usage

cargo add btparse
let bt = std::backtrace::Backtrace::capture();
let bt_parsed = btparse::deserialize(&bt);

License