dtolnay/thiserror
Thiserror
thiserror هي مكتبة معالجة أخطاء Rust وماكرو إجرائي مصمم لتحديد أنواع أخطاء مخصصة. تعمل كمؤتمت لتنفيذ السمات (trait) الذي يولد الكود اللازم لسمات خطأ المكتبة القياسية في وقت التجميع.
تركز المكتبة على القضاء على الكود المتكرر (boilerplate) باستخدام ماكرو derive لتنفيذ طرق العرض والمصدر تلقائياً. تسمح بإنشاء هياكل أخطاء مخصصة وتعدادات يمكنها تعيين أخطاء منخفضة المستوى إلى متغيرات عالية المستوى مع الحفاظ على السبب الأصلي ومعلومات التتبع (backtrace).
تغطي قدراتها تنسيق الأخطاء المخصص من خلال استيفاء القالب، وإدارة انتشار الخطأ، ودمج تتبعات المكدس لتصحيح الأخطاء. كما توفر آليات لأتمتة تحويل الخطأ وتتبع أصول الخطأ عبر حقول مخصصة.
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.
