A base library for Airbrake error reporting.
Toadhopper can be used to report plain old Ruby exceptions, or to build a framework-specific gem such as toadhopper-sinatra.
begin
raise "Kaboom!"
rescue => e
require 'toadhopper'
Toadhopper("YOURAPIKEY").post!(e)
end
You can install it via rubygems:
gem install toadhopper
Deploy tracking
You can use Toadhopper to notify Airbrake of deployments:
Toadhopper('YOURAPIKEY').deploy!
The method accepts options to set the environment, SCM revision, etc.
There is Capistrano support for deploy tracking. Simply require toadhopper/capistrano in your deploy config and set the variable airbrake_api_key:
require 'toadhopper/capistrano'
set :airbrake_api_key, 'YOURAPIKEY'
Development
Install Bundler 0.9.x, then:
% git clone git://github.com/toolmantim/toadhopper.git
% cd toadhopper
% bundle install
% bundle exec rake test
If you set a AIRBRAKE_API_KEY environment variable it'll test actually posting to the Airbrake API. For example:
% bundle exec rake test AIRBRAKE_API_KEY=abc123
To generate the docs:
% bundle exec yardoc
To build the gem:
% bundle exec rake build