dtolnay/thiserror

Features

• Error Handling Libraries - Provides a comprehensive framework for defining custom error types in Rust using derive macros.
• Macro-Driven Transformations - Uses Rust procedural macros to generate the standard Display and Error trait implementations at compile time.
• Error Source Tracing - Implements source methods to return the original low-level error that caused the current failure.
• Automated - Automatically implements the Display and Error traits for custom Rust types to eliminate boilerplate.
• Automatic Trait Conversions - Automatically generates From trait implementations to convert lower-level errors into custom high-level variants.
• Procedural Macros - Uses procedural macros to generate trait implementations for error types at compile time.
• Rust Error Handling Tooling - Provides a comprehensive solution for defining custom error types in Rust with minimal boilerplate via trait automation.
• Compile-Time Code Generation - Eliminates manual boilerplate by generating trait implementations at compile time using declarative macros.
• Automatic Error Conversions - Automates the transformation of low-level errors into custom variants using attribute-driven conversion logic.
• Error Mapping Generators - Provides a mechanism to map low-level errors to high-level variants while preserving original cause and backtrace information.
• Error Propagation Systems - Manages the hierarchy of failure causes by wrapping low-level errors into high-level custom variants.
• Custom Error Type Definitions - Facilitates the definition of custom error enums and structs with minimal boilerplate using derive macros.
• Error Wrapping - Wraps lower-level errors within custom types to maintain the error chain while providing a unified interface.
• Error Source Resolution - Implements the source method by automatically resolving and forwarding the underlying causal error from designated fields.
• Causal - Provides the ability to identify and return the underlying cause of an error via the source method.
• Stack Trace Capture - Captures stack trace data within error types by detecting backtrace fields or forwarding source errors.
• Template String Interpolation - Provides a mechanism to interpolate fields into error messages using template strings defined in attributes.
• Rust Application Debugging - Supports diagnosing Rust application failures through the integration of source methods and backtraces.
• Declarative Error Formatting - Creates user-friendly error messages in Rust using templates that automatically include data from error fields.
• Error Detail Proxying - Allows errors to proxy their display and source methods to an underlying error, hiding internal implementation details.
• Error Template Interpolation - Enables the creation of user-facing error messages using templates that interpolate data from error fields.
• Display-Based Error Messages - Generates human-readable error strings by implementing the Display trait with interpolated field values.
• Runtime Failure Backtrace Capturers - Integrates stack backtrace capture and propagation across nested error layers for debugging.
• Developer Utilities - Library for defining custom error types in Rust.

Star history