Written by thoughtbot

Airbrake gem available

Today we are releasing the first generally available version of the airbrake gem, as part of the name change.

We changed the namespace from HoptoadNotifier to Airbrake, so this is a major version bump that breaks backwards compatibility. Updating is simple:

  1. In your Gemfile, replace hoptoad_notifier with airbrake.
  2. In your configuration, use Airbrake.configure instead of HoptoadNotifier.configure. Change the file name to config/initializers/airbrake.rb while you’re at it.
  3. If you are calling HoptoadNotifier.notify directly, replace that with Airbrake.notify.
  4. If you are calling notify_hoptoad directly, replace that with notify_airbrake.
  5. If you are javascript notifier user, replace <%= hoptoad_javascript_notifier %> with <%= airbrake_javascript_notifier %> in your layouts.
  6. If you’re using capistrano for deploy tracking, change the require from hoptoad_notifier/capistrano to airbrake/capistrano.
  7. Rake tasks are also namespaced to airbrake now, so use rake airbrake:deploy and rake airbrake:test instead of their hoptoad equivalents.

That’s all there is to it! A text editor with global find and replace capability should make this a breeze. If you are a vim user, I recommend the Greplace plugin.

Finally, I would like to clarify that your app will not suddenly stop working any time soon if you don’t switch immediately. We will continue to receive error reports on the old domain for a little while, but it’s safer to upgrade to the new gem. The airbrake gem is where all development will continue going forward in its new home on github, and is therefore where you will get improvements and fixes to the library.

To the brakes!