mail-redirector 0.0.1

data/.gitignore

@@ -0,0 +1,4 @@
+*.gem
+.bundle
+Gemfile.lock
+pkg/*

data/Gemfile

@@ -0,0 +1,7 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in mail-redirector.gemspec
+gemspec
+
+gem 'rspec'
+gem 'rake', '0.8.7'

data/README.markdown

@@ -0,0 +1,44 @@
+Mail Redirector
+===============
+
+Installation
+------------
+
+### In Your Gemfile
+
+> gem 'mail-redirector
+
+### In config/initializers/mail-redirector.rb
+
+> MailRedirector.setup_interceptor 'test@example.com'
+
+That's it!
+
+
+What it's doing
+---------------
+
+In all environments other than PRODUCTION or TEST, mail sent through
+ActionMailer will be redirected to test@example.com. No mail will be
+sent to its original destination. Instead, the X-Originally-To mail
+header will be set, allowing you to determine who the mail would have
+gone to had it not been redirected.
+
+Mail in the TEST environment is specifically NOT redirected on the
+assumption that it is more convenient to configure action mailer
+to test delivery mode and still allow the tests to have access to
+the original to field for testing purposes.
+
+
+I want more control!
+--------------------
+
+If you want to change what addresses mail is redirected to in each
+environment, then INSTEAD of calling setup_interceptor, place
+a line of code like this:
+
+> ActionMailer::Base.register_interceptor(MailRedirector.new("test@example.com"))
+
+In each environment file, or wherever makes sense for you.
+
+Happy redirecting!

data/Rakefile

@@ -0,0 +1,10 @@
+require 'bundler'
+require 'rspec/core/rake_task'
+
+Bundler::GemHelper.install_tasks
+task default: :spec
+RSpec::Core::RakeTask.new(:spec) do |t|
+   t.verbose = false
+   t.rspec_opts = "--color"
+end
+

data/lib/mail-redirector.rb

@@ -0,0 +1,15 @@
+class MailRedirector < Struct.new(:destination)
+  def delivering_email(m)
+    m['X-Originally-To'] = m.to.to_s
+    m.to = destination
+  end
+
+  def self.setup_interceptor(email_to_redirect_to)
+    unless Rails.env.production? || Rails.env.test?
+      ActionMailer::Base.register_interceptor(
+        MailRedirector.new(email_to_redirect_to)
+      )
+    end
+  end
+end
+

data/lib/mail-redirector/version.rb

@@ -0,0 +1,2 @@
+require_relative '../mail-redirector'
+MailRedirector::VERSION = "0.0.1"

data/mail-redirector.gemspec

@@ -0,0 +1,26 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+require "mail-redirector/version"
+
+Gem::Specification.new do |s|
+  s.name        = "mail-redirector"
+  s.version     = MailRedirector::VERSION
+  s.platform    = Gem::Platform::RUBY
+  s.authors     = ["David Vollbracht"]
+  s.email       = ["david@finario.com"]
+  s.homepage    = "http://github.com/flipstone/mail-redirector"
+  s.summary     = %q{Simple Rails 3 mail interceptor to redirect action mailer messages to a test address.}
+  s.description = <<-end_desc
+Protect yourself for ever accidentally sendmail emails from an environment other than production. MailRedirector
+lets you specify an email address to redirect all mail send by ActionMailer to.  It also sets the X-Originally-To
+header to the original recipients, ensuring you can inspect to message and verify it would have gone to the correct
+recipients.
+  end_desc
+
+  s.add_dependency 'actionmailer', '>= 3.0.0'
+
+  s.files         = `git ls-files`.split("\n")
+  s.test_files    = `git ls-files -- {test,spec,features}/*`.split("\n")
+  s.executables   = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  s.require_paths = ["lib"]
+end

data/spec/mail_redirector_spec.rb

@@ -0,0 +1,18 @@
+require 'spec_helper'
+
+describe MailRedirector do
+  describe "delivering_email" do
+    it "sets the to" do
+      m = Mail.new to: "bar@example.com"
+
+      MailRedirector.new('test@example.com').delivering_email m
+      m.to.should == ['test@example.com']
+    end
+
+    it "sets a header with the original to" do
+      m = Mail.new to: "bar@example.com"
+      MailRedirector.new.delivering_email m
+      m['X-Originally-To'].to_s.should =~ /bar@example\.com/
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,4 @@
+require 'bundler'
+require 'action_mailer'
+require 'mail'
+require_relative '../lib/mail-redirector'

metadata

@@ -0,0 +1,93 @@
+--- !ruby/object:Gem::Specification 
+name: mail-redirector
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 0
+  - 1
+  version: 0.0.1
+platform: ruby
+authors: 
+- David Vollbracht
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2011-09-02 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: actionmailer
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    none: false
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 3
+        - 0
+        - 0
+        version: 3.0.0
+  type: :runtime
+  version_requirements: *id001
+description: |
+  Protect yourself for ever accidentally sendmail emails from an environment other than production. MailRedirector
+  lets you specify an email address to redirect all mail send by ActionMailer to.  It also sets the X-Originally-To
+  header to the original recipients, ensuring you can inspect to message and verify it would have gone to the correct
+  recipients.
+
+email: 
+- david@finario.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- .gitignore
+- Gemfile
+- README.markdown
+- Rakefile
+- lib/mail-redirector.rb
+- lib/mail-redirector/version.rb
+- mail-redirector.gemspec
+- spec/mail_redirector_spec.rb
+- spec/spec_helper.rb
+has_rdoc: true
+homepage: http://github.com/flipstone/mail-redirector
+licenses: []
+
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  none: false
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.7
+signing_key: 
+specification_version: 3
+summary: Simple Rails 3 mail interceptor to redirect action mailer messages to a test address.
+test_files: 
+- spec/mail_redirector_spec.rb
+- spec/spec_helper.rb