An issue I have to tackle on almost every project I encounter is developing, QA'ing, and troubleshooting email generated from my app. Rails provides a couple of options to help during the development and test phases (setting action_mailer.delivery_method = :test), but there aren't any great mechanisms for performing QA with a client or troubleshooting production email issues (formatting, content, etc).
Not long ago I stumbled upon Peter Boling's plugin implementation of sanitize_email. I've since forked it, turned it into a gem, and continued to apply maintenance commits to it as rails has marched forward through versions 2.2 and 2.3.
The primary value sanitize_email provides is that it allows you to reroute all email without having to alter any application code. It's environment-specific and doesn't introduce any production/deployment dependencies.
Installation
To install, simply execute:
``
$> sudo gem install sanitize_email
Use Cases
There are three primary use cases for sanitize_email.
Working Locally with Production Data
Scenario: you have a mechanism for recreating your production environment in your development environment (capistrano-extensions provides this capability for MySQL databases). You want to pull down the production data to troubleshoot a live email issue. Using sanitize_email, we can set up our dev environment to override all email envelopes so that email actually goes to an inbox of your choice.
Re-routing Email on a Staging or QA Server
During initial development of a new email feature, it's imperative that the client/stakeholder be able to review all emails being generated. sanitize_email makes it dead simple to specify that your staging environment route all email generated to a specific email address without having to change any application code.
Testing Email from a Hot Production Server
You can install sanitize_email on your production server, and then utilize it from the console to give you more freedom when poking and prodding your application. You can trigger any email you need to without fear that it will go to a real live email address.
Sample Usage of sanitize_email
sanitize_email uses ActionMailer::Base.local_environments to specify in which environments to override the SMTP envelope. Note that a set of defaults can be configured in an initializer file, and then overridden in specific environment files for further control.
# Settings for sanitize_email gem. These can be overridden in individual config/%env%/environment.rb files.
require 'sanitize_email'
ActionMailer::Base.sanitized_recipients = "[email protected]"
ActionMailer::Base.sanitized_bcc = nil
ActionMailer::Base.sanitized_cc = nil
# These are the environments whose outgoing email BCC, CC and recipients fields will be overridden!
# All environments not listed will be treated as normal.
ActionMailer::Base.local_environments = %w( development test staging )
Closing Notes
The functionality provided by sanitize_email is truly very basic, and admittedly a little static. You can only set a single override for any given environment, which doesn't lend itself to a QA/review team that consists of more than a single person. I have been working on rails-caddy which is a tool for bringing a lot of QA goodness to the browser. One feature it provides is an integration with sanitize_email, allowing these overridden email addresses to be set on a per session basis, which in turn allows several individuals to work on a staging server at the same time and each receive the email that their own actions triggered. It's still in its early stages (pre 0.1.0 release), but it's something we're using on several apps already.
