BetterErrors/better_errors
Better Errors
Better Errors is a Rack middleware exception handler and interactive application state inspector for Ruby web applications. It intercepts unhandled exceptions to render developer-friendly error pages that provide detailed stack traces and variable inspection.
The tool provides a debugging interface that allows for live code evaluation at every stack frame of an exception. It maps stack trace entries to local filesystem paths for direct navigation to source code in an editor and restricts interface access via IP-based validation.
The project covers error response formatting for API and AJAX calls through plain text support. It also handles the interception of application crashes to provide real-time inspection of local variables and execution environments.
Features
- Application Debugging - Intercepts unhandled exceptions in Rack applications to provide detailed stack traces and application state inspection.
- Crash Diagnostics - Maps application crashes to specific source code lines and restricts debugging interface access to trusted IPs.
- Variable Inspection Tools - Allows real-time inspection of variables and evaluation of live code at specific stack frames to diagnose failures.
- Stack Frame Inspectors - Binds the execution environment of the interactive shell to specific stack frames for precise variable inspection.
- Runtime Context Evaluators - Provides an interactive shell to execute arbitrary Ruby code within the context of a crashed stack frame.
- Live Code Evaluation - Enables developers to evaluate Ruby expressions and inspect application state using an interactive shell during a crash.
- Process Exception Interception - Captures unhandled exceptions at the process level and replaces standard error pages with a debugging interface.
- Handler Middlewares - Acts as a middleware interceptor that wraps request handlers to render developer-friendly error pages.
- Application State Inspection - Provides a browser-based interface for inspecting application state and local variables when a Rack app fails.
- Rack-Based Middleware Pipelines - Implements a Rack middleware pipeline to intercept unhandled exceptions and replace default error responses.
- Web Application Debugging - Provides a specialized debugging interface for Ruby web applications with live code evaluation at each stack frame.
- API Error Handling - Provides plain text error details for AJAX calls and API responses by detecting non-HTML requests.
- Editor-Integrated Debugging - Links exception details directly to the specific file and line number in a local text editor.
- Error Page Diagnostics - Renders detailed error pages containing stack traces and variable states to diagnose the causes of application failures.
- Source Path Mapping - Maps stack trace entries to local filesystem paths for direct navigation to source code in an editor.
- Administrative Access Restrictions - Limits access to the administrative debugging interface by whitelisting specific requester IP addresses.
- IP Access Restrictions - Restricts access to the debugging interface by validating requester IP addresses against allowed blocks.
- Custom Error Pages - Renders an interactive error page for Rack applications featuring detailed stack traces and variable inspection.
