Better Errors
Better Errors replaces the standard Rails error page with a much better and more useful error page. It is also usable outside of Rails.
Features
- Full stack trace
- Source code inspection for all stack frames (with highlighting)
- Local and instance variable inspection
- Ruby console on every stack frame
Installation
Add this line to your application's Gemfile (under the development group):
gem 'better_errors'
And then execute:
$ bundle
Or install it yourself as:
$ gem install better_errors
If you would like to use Better Errors' advanced features, you need to install the binding_of_caller
gem:
$ gem install binding_of_caller
This is an optional dependency however, and Better Errors will work without it.
Usage
If you're using Rails, there's nothing else you need to do.
If you're not using Rails, you need to insert BetterErrors::Middleware
into your middleware stack, and optionally set BetterErrors.application_root
if you'd like Better Errors to abbreviate filenames within your application.
Here's an example using Sinatra:
require "sinatra"
require "better_errors"
use BetterErrors::Middleware
BetterErrors.application_root = File.("..", __FILE__)
get "/" do
raise "oops"
end
Contributing
- Fork it
- Create your feature branch (
git checkout -b my-new-feature
) - Commit your changes (
git commit -am 'Add some feature'
) - Push to the branch (
git push origin my-new-feature
) - Create new Pull Request