All notable changes to error-stack will be documented in this file.
- Add
OptionExtto supportOption::ok_or_report. (#667) - Support for
defmt. - Better support for serialization and deserialization of
Report.
0.8.0 - 2026-07-03
- Fix a soundness hole in
Report::frames_mut: the returned iterator handed out&mut Frames with independent lifetimes, so a frame and one of its sources (viaFrame::sources_mut) could be borrowed mutably at the same time — undefined behavior triggerable from safe code, up to segfaults.frames_mutnow takes a visitor closure (FnMut(&mut Frame) -> ControlFlow<()>) instead of returning an iterator, and theFramesMuttype has been removed.Report::downcast_mutis unaffected. (#8946)
0.7.1 - 2026-05-27
- Gate
sinkimports behindcfg(nightly)soerror-stackcompiles on stable Rust with theunstablefeature enabled. (#8768)
0.7.0 - 2026-03-26
- Support trailing commans in
bail!macro. (#7772)
- Remove deprecated
Context(#7763) - Remove deprecated
report!(#7763) - Remove deprecated
Report::{attach_lazy, attach_printable, attach_printable_lazy}(#7763) - Depend on
serde_coreinstead ofserde. (#7909)
0.6.0 - 2025-08-30
- Report has been split into
Report<C>andReport<[C]>to distinguish between a group of related errors and a single error. These errors can still be nested. (#5047) - Introduce a new
unstableflag, which is used to enable unstable features, these features are not covered by semver and may be modified or removed at any time. (#5181) - Reintroduce a new
IntoReporttrait, which is used to determine when a type can be converted to aReport. This allows the usage of errors more idiomatically in traits, such astype Error: IntoReport. (#6738)
- Rename
attach[_lazy]toattach_opaque[_with]andattach_printable[_lazy]toattach[_with]. (#7753) - Set the MSRV to 1.83 (#5333)
Extendis no longer implemented byReport<C>, instead it is implemented onReport<[C]>, either useFromorReport::expandto convert betweenReport<C>intoReport<[C]>. (#5047)extend_onehas been renamed topushand is only implemented onReport<[C]>. (#5047)bail!(report,)has been removed, one must now usebail!(report). This is in preparation for the unstablebail!macro that allows to constructReport<[C]>. (#5047)
Context: Usecore::error::Errorinstead (#5533)Result<T, C>: Usecore::result::Result<T, Report<C>>instead (#5533)report!, useIntoReport::into_reportinstead. (#6738)
0.5.0 - 2024-07-12
- Capture
source()errors when convertingErrortoReport(#4678)
Backtraces are not included in thestdfeature anymore. Instead, thebacktracefeature is used which is enabled by default (#4685)- Remove deprecated
IntoReport(#4706)
0.4.1 - 2023-09-04
- Fix deprecation warning typo for
IntoReport(#3088)
0.4.0 - 2023-08-23
- Add
ResultExt::Contextas associated type (#2883)
- Implement
ResultExtforResulteven if theErr-variant is notReport<C>but onlyC: Context(#2883)
IntoReport: UseReportExtorFromviaResult::map_err(Report::from)instead (#2883)
0.3.1 - 2023-02-08
- Fix multiline attachments not being aligned (#2022)
0.3.0 - 2023-02-01
- Add initial serializing support using
serde(#1290) - Support
Debughooks onno-stdplatforms via thehooksfeature (#1556) - Support converting
ReportintoErrorviaReport::as_errorandReport::into_error(#1749) - Support converting
ReportintoBox<dyn Error>via theFromtrait (#1749) - Programmatic selection of color mode and charset used for
Debugoutput (#1800)
0.2.4 - 2022-11-04
- The output of
Locationis no longer hard-coded and can now be adjusted through hooks. (#1237) - The
TypeIdof a value contained in aFramecan now be accessed viaFrame::type_id(#1289) - Deprecate
Frame::locationin favor of an additional attachment on context change/creation (#1311)
0.2.3 - 2022-10-12
- Add Apache 2.0 as an additional license option (#1172)
0.2.2 - 2022-10-07
- Add a space before attachment formatting (#1174)
0.2.0 - 2022-10-03
- Set the MSRV to 1.63 (#944)
- Use
ProviderAPI fromcore::any(#697) - Remove the unused features
hooks,futures, andfutures-core(#695, #1138)
- Support backtraces on non-nightly channels starting with 1.65.0-beta (#1098)
- Add support for
core::error::Erroron nightly (#1038) - Add support for
Error::provide()(#904) - New output for Debug (#794)
- New hook interface for Debug (#794)
- Add support for related errors and multiple error sources (#747)
- Add compatibility for
anyhowandeyreto convert their types intoReport(#763) - Implement
TerminationforReport(#671) Report::set_debug_hookandReport::set_display_hookno longer return an error (#794)
IntoReport::report: UseIntoReport::into_reportinstead (#698)Report::backtrace: UseReport::downcast_ref::<Backtrace>(non-nightly),Report::request_ref::<Backtrace>(nightly) instead (#747)Report::span_trace: UseReport::downcast_ref::<SpanTrace>(non-nightly),Report::request_ref::<SpanTrace>(nightly) instead (#747)Frame::source: UseFrame::sourcesinstead (#747)Frame::source_mut: UseFrame::sources_mutinstead (#747)Report::set_debug_hook: UseReport::install_debug_hookinstead (#794)Report::set_display_hook(#794)
- Greatly reduce the amount of
unsafecode (#774)
0.1.0 - 2022-06-10
- Initial release