btparse-stable

Crates.iobtparse-stable
lib.rsbtparse-stable
version0.1.2
sourcesrc
created_at2023-12-17 15:11:48.73528
updated_at2023-12-17 15:11:48.73528
descriptionA minimal deserializer for inspecting `std::backtrace::Backtrace`'s Debug format.
homepagehttps://github.com/jondot/btparse
repositoryhttps://github.com/jondot/btparse
max_upload_size
id1072554
size17,646
Dotan J. Nahum (jondot)

documentation

https://docs.rs/btparse

README

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.
Commit count: 11

cargo fmt