0.0
No commit activity in last 3 years
No release in over 3 years
The gem catches exceptions and creates and sends emails with backtrace and other informations.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Runtime

 Project Readme

MeExceptional ¶ ↑

The Gem notifies you of application exceptions by email and adds some useful information about the request and the client issuing the request. It is heavily inspired by the exceptional gem and takes some of it design for the HTML email.

Installation¶ ↑

Install the gem in your Rails 3 App as usual:

gem install me_exceptional

After you have installed MeExceptional and added it to your Gemfile, run the generator.

rails generate me_exceptional:install

The generator will create an initializer which you MUST take a look at and configure.

NOTE: Support for Rails 2.x is not provided so far.

Getting Started¶ ↑

Being an engine MeExceptional has mailer and views already set up for you to get started; if your app raises an exception production mode you will get notified by email (note: doesn’t work for routing errors so far because of a bug in rails). You may, however change view and mailer to suit you better.

Configuring views¶ ↑

If you want to change the email, you just need to invoke the generator that copies it over to your application:

rails generate me_exceptional:views

This copies the mailer views to “/app/views/me_exceptional”.

Configuring mailer¶ ↑

In case you also want to customize the mailer, invoke the mailer generator:

rails generate me_exceptional:mailer

This creates the directory “/app/mailers/me_exceptional” with the mailer contained.

Usage outside of ActionController¶ ↑

To use MeExceptional outside ActionController, i.e. in delayed jobs, you must include the BasicExtension and specifiy the methods you want to catch exceptions from in the class definition.

class Dummy
   include MeExceptional::BasicExtension

   def some_error
     raise "some error"
   end

   def another_error
     raise "some error"
   end

    rescue_mail_from_methods :some_error, :another_error
 end

Remember to put the call to rescue_mail_from_methods after the method definitions because the methods will be aliased.

Outlook¶ ↑

  • more gem side configuration options

  • asynchronous mailing options

  • routing errors and other errors