Skip to content
/ btparse Public

A minimal deserialization library for std::backtrace::Backtrace's debug format

Notifications You must be signed in to change notification settings

yaahc/btparse

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

14 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

Licensed under either of Apache License, Version 2.0 or MIT license at your option.
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.

About

A minimal deserialization library for std::backtrace::Backtrace's debug format

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages