bounce_email 0.2.0

data/.gitignore

@@ -0,0 +1,5 @@
+doc
+pkg
+.rvmrc
+.DS_Store
+Gemfile.lock

data/Gemfile

@@ -0,0 +1,4 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in bounce-email2.gemspec
+gemspec

data/HISTORY.md

@@ -0,0 +1,17 @@
+## 0.1.1 2011-09-01
+* extended #bounced? to consider error_status and diagnostic_code as well
+* updated external gems
+
+## 0.1.0 2011-05-27
+
+* make use of bounce parsing in Mail gem
+* renamed method to be compatible with Mail Gem
+* more tests and cleanup
+* forward message call to mail object if method is missing
+* updated doc
+* gemspec cleanup
+
+## 0.0.1 2009-02-15
+
+* 1 major enhancement:
+* Initial release

data/Manifest.txt

@@ -0,0 +1,11 @@
+History.txt
+Manifest.txt
+PostInstall.txt
+README.rdoc
+Rakefile
+lib/bounce_email.rb
+script/console
+script/destroy
+script/generate
+test/test_bounce_email.rb
+test/test_helper.rb

data/PostInstall.txt

@@ -0,0 +1,35 @@
+
+For more information on bounce_email, see http://bounce-email.rubyforge.org
+
+You can easily use this plugin with e.g. Rails application.
+Configure rails, so it send email using postfix and it adds VERP.
+#- in environment.rb file add lines -#
+config.action_mailer.delivery_method = :sendmail
+config.action_mailer.sendmail_settings = {
+  :location       => '/usr/sbin/sendmail',
+  :arguments      => '-XV -f bounces-main@amerimail.lv -i -t'
+}
+#- end -#
+Change amerimail.lv to email server that will handle bounce emails.
+
+Follow this tutorial to handle bounce-emails: http://keakaj.com/wisdom/2007/08/08/verp-on-rails/
+
+You can make Ruby file like this:
+require "rubygems"
+require "mail"
+require "bounce_email"
+
+mail = Mail.new(STDIN.read)
+bounce = BounceEmail::Mail.new(mail)
+
+# Do something with bounce info
+# bounce.isbounce -> true/false
+# bounce.code -> e.g. "5.1.1"
+# bounce.reason -> e.g. "Something about the address specified in the message caused this DSN."
+# bounce.type -> e.g. "Permanent Failure"
+
+# Permanent Failure means that it is hard bounce
+# Persistent Transient Failure means that it is soft bounce
+
+# If reason is "Vacation auto-reply" then email could be vacation email (but it is rearly cought).
+

data/README.md

@@ -0,0 +1,71 @@
+# bounce-email
+
+This Ruby library is for determining the bounce type of an email message. It determines whether the bounce is hard or soft, if is an "out of office mail", etc.
+
+## SYNOPSIS:
+
+Follow this tutorial to handle bounce-emails: [http://keakaj.com/wisdom/2007/08/08/verp-on-rails](http://keakaj.com/wisdom/2007/08/08/verp-on-rails/)
+
+Basic usage:
+
+     require "bounce_email"
+
+     bounce = BounceEmail::Mail.new(STDIN.read)
+
+     # Do something with bounce info
+     bounce.bounced? # true/false
+     bounce.code # e.g. "5.1.1"
+     bounce.reason # e.g. "Something about the address specified in the message caused this DSN."
+     bounce.type  #  "Permanent Failure", "Persistent Transient Failure", "Success" -- BounceEmail::TYPE_HARD_FAIL, TYPE_SOFT_FAIL, TYPE_SUCCESS
+
+
+## REQUIREMENTS:
+
+Ruby 1.9 & Ruby Gem Mail is required. The gem is used for primary bounce handling, which catches about 50% of all bounces.
+For most other bounces, this gem comes in. See discussion here: [https://github.com/mikel/mail/issues/103](https://github.com/mikel/mail/issues/103)
+
+## Other implementations:
+
+  * (PERL) [https://github.com/rjbs/mail-deliverystatus-bounceparser](https://github.com/rjbs/mail-deliverystatus-bounceparser)
+
+
+## TODO:
+
+  * code cleanup!!! Oh yes!
+  * don't hardcode comparison strings, move to external file which can be extended easily
+  * more test: extend for more bounces
+  * is OUT of office type needed? if yes implement as optional part
+  * merge into Mail Gem??
+
+## CONTRIBUTIONS:
+
+Please fork on github & add new conditions under "get_status_from_text" if you discover creative new mailserver responses.
+
+Updated by Pedro Visintin 2010
+Updated by Tobias Bielohlawek 2011
+
+
+## LICENSE:
+
+(The MIT License)
+
+Copyright (c) 2011 Tobias Bielohlawek, Agris Ameriks
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+'Software'), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/Rakefile

@@ -0,0 +1,9 @@
+require 'bundler'
+Bundler::GemHelper.install_tasks
+
+require 'rake/testtask'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib' << 'test' << Rake.original_dir
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = false
+end

data/VERSION

@@ -0,0 +1 @@
+0.2.0

data/bounce_email.gemspec

@@ -0,0 +1,23 @@
+# -*- encoding: utf-8 -*-
+$:.push File.expand_path("../lib", __FILE__)
+
+Gem::Specification.new do |s|
+  s.name          = %q{bounce_email}
+  s.version       = File.read("VERSION").to_s
+  s.platform      = Gem::Platform::RUBY
+  s.authors       = ["Tobias Bielohlawek", "Agris Ameriks", "Pedro Visintin", "Dimitar Dimitrov"]
+  s.email         = %q{tobi@rngtng.com}
+  s.homepage      = %q{http://github.com/mitio/bounce_email}
+  s.summary       = %q{Detect kind of bounced email}
+  s.description   = %q{fork of whatcould/bounce-email incl. patches from wakiki, peterpunk, agowan & rngtng}
+
+  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"]
+
+  ["mail"].each do |gem|
+    s.add_dependency *gem.split(' ')
+  end
+end
+

data/lib/bounce_email.rb

@@ -0,0 +1,218 @@
+# encoding: UTF-8
+require 'mail'
+
+module BounceEmail
+  TYPE_HARD_FAIL = 'Permanent Failure'
+  TYPE_SOFT_FAIL = 'Persistent Transient Failure'
+  TYPE_SUCCESS   = 'Success'
+
+  #qmail
+  # Status codes are defined in rfc3463, http://www.ietf.org/rfc/rfc3463.txt
+  # For code formatting, see http://www.ietf.org/rfc/rfc3463.txt
+  # Some Exchange servers format codes as "[...] #0.0.0>", see http://support.microsoft.com/kb/284204
+
+  # I used quite much from http://www.phpclasses.org/browse/package/2691.html
+  class Mail
+    def self.read(filename)
+      Mail.new( ::Mail.read(filename) )
+    end
+
+    def initialize(mail)
+      @mail = mail.is_a?(String) ? ::Mail.new(mail) : mail
+      begin
+        if mail.bounced? #fall back to bounce handling in Mail gem
+          @bounced = true
+          @diagnostic_code = mail.diagnostic_code
+          @error_status = mail.error_status
+        end
+      rescue
+        @bounced = @diagnostic_code = @error_status = nil
+      end
+    end
+
+
+    def bounced?
+      @bounced ||= check_if_bounce(@mail) || (diagnostic_code != "unknown") || (error_status != "unknown")
+    end
+    alias_method :is_bounce?, :bounced? #to stay backwards compatible
+
+    def diagnostic_code
+      @diagnostic_code ||= get_reason_from_status_code(code)
+    end
+    alias_method :reason, :diagnostic_code #to stay backwards compatible
+
+    def error_status
+      @error_status ||= get_code(@mail)
+    end
+    alias_method :code, :error_status #to stay backwards compatible
+
+=begin  #Streamline with Mail Gem methods - IMPLEMENT ME!
+    def final_recipien?
+    end
+
+    def action
+    end
+
+    def retryable?
+    end
+=end
+
+    def type
+      @type ||= get_type_from_status_code(code)
+    end
+
+    def original_mail
+      @original_mail ||= get_original_mail(@mail)
+    end
+
+    def method_missing(m, *args)
+      @mail.send(m, *args)
+    end
+
+    private
+    def get_code(mail)
+      return '97' if mail.subject.match(/delayed/i)
+      return '98' if mail.subject.encode('utf-8').match(/(unzulässiger|unerlaubter) anhang/i)
+      return '99' if mail.subject.encode('utf-8').match(/auto.*reply|vacation|vocation|(out|away).*office|on holiday|abwesenheits|autorespond|Automatische|eingangsbestätigung/i)
+
+      if mail.parts[1]
+        match_parts = mail.parts[1].body.match(/(Status:.|550 |#)([245]\.[0-9]{1,3}\.[0-9]{1,3})/)
+        code = match_parts[2] if match_parts
+        return code if code
+      end
+
+      # Now try getting it from correct part of tmail
+      code = get_status_from_text(mail.body)
+      return code if code
+
+      # OK getting desperate so try getting code from entire email
+      code = get_status_from_text(mail.to_s)
+      code || 'unknown'
+    end
+
+    def get_status_from_text(email)
+      #=begin
+      # This function is taken from PHP Bounce Handler class (http://www.phpclasses.org/browse/package/2691.html)
+      # Author: Chris Fortune
+      # Big thanks goes to him
+      # I transled them to Ruby and added some my parts
+      #=end
+      return "5.1.1" if email.match(/no such (address|user)|Recipient address rejected|User unknown|does not like recipient|The recipient was unavailable to take delivery of the message|Sorry, no mailbox here by that name|invalid address|unknown user|unknown local part|user not found|invalid recipient|failed after I sent the message|did not reach the following recipient|nicht zugestellt werden/i)
+      return "5.1.2" if email.match(/unrouteable mail domain|Esta casilla ha expirado por falta de uso|I couldn't find any host named/i)
+      if email.match(/mailbox is full|Mailbox quota (usage|disk) exceeded|quota exceeded|Over quota|User mailbox exceeds allowed size|Message rejected\. Not enough storage space|user has exhausted allowed storage space|too many messages on the server|mailbox is over quota|mailbox exceeds allowed size/i) # AA added 4th or
+        return "5.2.2" if email.match(/This is a permanent error/i) # AA added this
+        return "4.2.2"
+      end
+      return "5.1.0" if email.match(/Address rejected/)
+      return "4.1.2" if email.match(/I couldn't find any host by that name/)
+      return "4.2.0" if email.match(/not yet been delivered/i)
+      return "5.2.0" if email.match(/mailbox unavailable|No such mailbox/i)
+      return "5.4.4" if email.match(/Unrouteable address/i)
+      return "4.4.7" if email.match(/retry timeout exceeded/i)
+      return "5.2.0" if email.match(/The account or domain may not exist, they may be blacklisted, or missing the proper dns entries./i)
+      return "5.5.4" if email.match(/554 TRANSACTION FAILED/i)
+      return "4.4.1" if email.match(/Status: 4.4.1|delivery temporarily suspended|wasn't able to establish an SMTP connection/i)
+      return "5.5.0" if email.match(/550 OU\-002|Mail rejected by Windows Live Hotmail for policy reasons/i)
+      return "5.1.2" if email.match(/PERM_FAILURE: DNS Error: Domain name not found/i)
+      return "4.2.0" if email.match(/Delivery attempts will continue to be made for/i)
+      return "5.5.4" if email.match(/554 delivery error:/i)
+      return "5.1.1" if email.match(/550-5.1.1|This Gmail user does not exist/i)
+      return "5.7.1" if email.match(/5.7.1 Your message.*?was blocked by ROTA DNSBL/i) # AA added
+      return "5.3.2" if email.match(/Technical details of permanent failure|Too many bad recipients/i)  && (email.match(/The recipient server did not accept our requests to connect/i) || email.match(/Connection was dropped by remote host/i) || email.match(/Could not initiate SMTP conversation/i)) # AA added
+      return "4.3.2" if email.match(/Technical details of temporary failure/i) && (email.match(/The recipient server did not accept our requests to connect/i) || email.match(/Connection was dropped by remote host/i) || email.match(/Could not initiate SMTP conversation/i)) # AA added
+      return "5.0.0" if email.match(/Delivery to the following recipient failed permanently/i) # AA added
+      return '5.2.3' if email.match(/account closed|account has been disabled or discontinued|mailbox not found|prohibited by administrator|access denied|account does not exist/i)
+    end
+
+    def get_reason_from_status_code(code)
+      return 'unknown' if code.nil? or code == 'unknown'
+      array = {}
+      array['00'] =  "Other undefined status is the only undefined error code. It should be used for all errors for which only the class of the error is known."
+      array['10'] =  "Something about the address specified in the message caused this DSN."
+      array['11'] =  "The mailbox specified in the address does not exist.  For Internet mail names, this means the address portion to the left of the '@' sign is invalid.  This code is only useful for permanent failures."
+      array['12'] =  "The destination system specified in the address does not exist or is incapable of accepting mail.  For Internet mail names, this means the address portion to the right of the @ is invalid for mail.  This codes is only useful for permanent failures."
+      array['13'] =  "The destination address was syntactically invalid.  This can apply to any field in the address.  This code is only useful for permanent failures."
+      array['14'] =  "The mailbox address as specified matches one or more recipients on the destination system.  This may result if a heuristic address mapping algorithm is used to map the specified address to a local mailbox name."
+      array['15'] =  "This mailbox address as specified was valid.  This status code should be used for positive delivery reports."
+      array['16'] =  "The mailbox address provided was at one time valid, but mail is no longer being accepted for that address.  This code is only useful for permanent failures."
+      array['17'] =  "The sender's address was syntactically invalid.  This can apply to any field in the address."
+      array['18'] =  "The sender's system specified in the address does not exist or is incapable of accepting return mail.  For domain names, this means the address portion to the right of the @ is invalid for mail. "
+      array['20'] =  "The mailbox exists, but something about the destination mailbox has caused the sending of this DSN."
+      array['21'] =  "The mailbox exists, but is not accepting messages.  This may be a permanent error if the mailbox will never be re-enabled or a transient error if the mailbox is only temporarily disabled."
+      array['22'] =  "The mailbox is full because the user has exceeded a per-mailbox administrative quota or physical capacity.  The general semantics implies that the recipient can delete messages to make more space available.  This code should be used as a persistent transient failure."
+      array['23'] =  "A per-mailbox administrative message length limit has been exceeded.  This status code should be used when the per-mailbox message length limit is less than the general system limit.  This code should be used as a permanent failure."
+      array['24'] =  "The mailbox is a mailing list address and the mailing list was unable to be expanded.  This code may represent a permanent failure or a persistent transient failure. "
+      array['30'] =  "The destination system exists and normally accepts mail, but something about the system has caused the generation of this DSN."
+      array['31'] =  "Mail system storage has been exceeded.  The general semantics imply that the individual recipient may not be able to delete material to make room for additional messages.  This is useful only as a persistent transient error."
+      array['32'] =  "The host on which the mailbox is resident is not accepting messages.  Examples of such conditions include an immanent shutdown, excessive load, or system maintenance.  This is useful for both permanent and permanent transient errors. "
+      array['33'] =  "Selected features specified for the message are not supported by the destination system.  This can occur in gateways when features from one domain cannot be mapped onto the supported feature in another."
+      array['34'] =  "The message is larger than per-message size limit.  This limit may either be for physical or administrative reasons. This is useful only as a permanent error."
+      array['35'] =  "The system is not configured in a manner which will permit it to accept this message."
+      array['40'] =  "Something went wrong with the networking, but it is not clear what the problem is, or the problem cannot be well expressed with any of the other provided detail codes."
+      array['41'] =  "The outbound connection attempt was not answered, either because the remote system was busy, or otherwise unable to take a call.  This is useful only as a persistent transient error."
+      array['42'] =  "The outbound connection was established, but was otherwise unable to complete the message transaction, either because of time-out, or inadequate connection quality. This is useful only as a persistent transient error."
+      array['43'] =  "The network system was unable to forward the message, because a directory server was unavailable.  This is useful only as a persistent transient error. The inability to connect to an Internet DNS server is one example of the directory server failure error. "
+      array['44'] =  "The mail system was unable to determine the next hop for the message because the necessary routing information was unavailable from the directory server. This is useful for both permanent and persistent transient errors.  A DNS lookup returning only an SOA (Start of Administration) record for a domain name is one example of the unable to route error."
+      array['45'] =  "The mail system was unable to deliver the message because the mail system was congested. This is useful only as a persistent transient error."
+      array['46'] =  "A routing loop caused the message to be forwarded too many times, either because of incorrect routing tables or a user forwarding loop. This is useful only as a persistent transient error."
+      array['47'] =  "The message was considered too old by the rejecting system, either because it remained on that host too long or because the time-to-live value specified by the sender of the message was exceeded. If possible, the code for the actual problem found when delivery was attempted should be returned rather than this code.  This is useful only as a persistent transient error."
+      array['50'] =  "Something was wrong with the protocol necessary to deliver the message to the next hop and the problem cannot be well expressed with any of the other provided detail codes."
+      array['51'] =  "A mail transaction protocol command was issued which was either out of sequence or unsupported.  This is useful only as a permanent error."
+      array['52'] =  "A mail transaction protocol command was issued which could not be interpreted, either because the syntax was wrong or the command is unrecognized. This is useful only as a permanent error."
+      array['53'] =  "More recipients were specified for the message than could have been delivered by the protocol.  This error should normally result in the segmentation of the message into two, the remainder of the recipients to be delivered on a subsequent delivery attempt.  It is included in this list in the event that such segmentation is not possible."
+      array['54'] =  "A valid mail transaction protocol command was issued with invalid arguments, either because the arguments were out of range or represented unrecognized features. This is useful only as a permanent error. "
+      array['55'] =  "A protocol version mis-match existed which could not be automatically resolved by the communicating parties."
+      array['60'] =  "Something about the content of a message caused it to be considered undeliverable and the problem cannot be well expressed with any of the other provided detail codes. "
+      array['61'] =  "The media of the message is not supported by either the delivery protocol or the next system in the forwarding path. This is useful only as a permanent error."
+      array['62'] =  "The content of the message must be converted before it can be delivered and such conversion is not permitted.  Such prohibitions may be the expression of the sender in the message itself or the policy of the sending host."
+      array['63'] =  "The message content must be converted to be forwarded but such conversion is not possible or is not practical by a host in the forwarding path.  This condition may result when an ESMTP gateway supports 8bit transport but is not able to downgrade the message to 7 bit as required for the next hop."
+      array['64'] =  "This is a warning sent to the sender when message delivery was successfully but when the delivery required a conversion in which some data was lost.  This may also be a permanant error if the sender has indicated that conversion with loss is prohibited for the message."
+      array['65'] =  "A conversion was required but was unsuccessful.  This may be useful as a permanent or persistent temporary notification."
+      array['70'] =  "Something related to security caused the message to be returned, and the problem cannot be well expressed with any of the other provided detail codes.  This status code may also be used when the condition cannot be further described because of security policies in force."
+      array['71'] =  "The sender is not authorized to send to the destination. This can be the result of per-host or per-recipient filtering.  This memo does not discuss the merits of any such filtering, but provides a mechanism to report such. This is useful only as a permanent error."
+      array['72'] =  "The sender is not authorized to send a message to the intended mailing list. This is useful only as a permanent error."
+      array['73'] =  "A conversion from one secure messaging protocol to another was required for delivery and such conversion was not possible. This is useful only as a permanent error. "
+      array['74'] =  "A message contained security features such as secure authentication which could not be supported on the delivery protocol. This is useful only as a permanent error."
+      array['75'] =  "A transport system otherwise authorized to validate or decrypt a message in transport was unable to do so because necessary information such as key was not available or such information was invalid."
+      array['76'] =  "A transport system otherwise authorized to validate or decrypt a message was unable to do so because the necessary algorithm was not supported. "
+      array['77'] =  "A transport system otherwise authorized to validate a message was unable to do so because the message was corrupted or altered.  This may be useful as a permanent, transient persistent, or successful delivery code."
+      #custom codes
+      array['97'] =  "Delayed"
+      array['98'] =  "Not allowed Attachment"
+      array['99'] =  "Vacation auto-reply"
+      code = code.gsub(/\./,'')[1..2]
+      array[code] || "unknown"
+    end
+
+    def get_type_from_status_code(code)
+      return TYPE_HARD_FAIL if code.nil? or code == 'unknown'
+      pre_code = code[0].chr.to_i
+      array = {}
+      array[5] = TYPE_HARD_FAIL
+      array[4] = TYPE_SOFT_FAIL
+      array[2] = TYPE_SUCCESS
+      return array[pre_code]
+      "Error"
+    end
+
+    def check_if_bounce(mail)
+      return true if mail.subject.match(/(returned|undelivered) mail|mail delivery( failed)?|(delivery )(status notification|failure)|failure notice|undeliver(able|ed)( mail)?|return(ing message|ed) to sender/i)
+      return true if mail.subject.match(/auto.*reply|vacation|vocation|(out|away).*office|on holiday|abwesenheits|autorespond|Automatische|eingangsbestätigung/i)
+      return true if mail['precedence'].to_s.match(/auto.*(reply|responder|antwort)/i)
+      return true if mail.from.to_s.match(/^(MAILER-DAEMON|POSTMASTER)\@/i)
+      false
+    end
+
+    def get_original_mail(mail) #worked alright for me, for sure this as to be extended
+      parts = mail.body.to_s.split(/--- Below this line is a copy of the message.(\r\n\r\n|\n\n)/)
+      if parts.size > 1
+        ::Mail.new(parts.last)
+      elsif mail.parts
+        ::Mail.new(mail.parts[2].body)
+      end
+    rescue => e
+      nil
+    end
+
+  end
+end

data/script/console

@@ -0,0 +1,10 @@
+#!/usr/bin/env ruby
+# File: script/console
+irb = RUBY_PLATFORM =~ /(:?mswin|mingw)/ ? 'irb.bat' : 'irb'
+
+libs =  " -r irb/completion"
+# Perhaps use a console_lib to store any extra methods I may want available in the cosole
+# libs << " -r #{File.dirname(__FILE__) + '/../lib/console_lib/console_logger.rb'}"
+libs <<  " -r #{File.dirname(__FILE__) + '/../lib/bounce_email.rb'}"
+puts "Loading bounce-email gem"
+exec "#{irb} #{libs} --simple-prompt"

data/script/destroy

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/destroy'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Destroy.new.run(ARGV)

data/script/generate

@@ -0,0 +1,14 @@
+#!/usr/bin/env ruby
+APP_ROOT = File.expand_path(File.join(File.dirname(__FILE__), '..'))
+
+begin
+  require 'rubigen'
+rescue LoadError
+  require 'rubygems'
+  require 'rubigen'
+end
+require 'rubigen/scripts/generate'
+
+ARGV.shift if ['--help', '-h'].include?(ARGV[0])
+RubiGen::Base.use_component_sources! [:rubygems, :newgem, :newgem_theme, :test_unit]
+RubiGen::Scripts::Generate.new.run(ARGV)

data/test/bounce_email_test.rb

@@ -0,0 +1,113 @@
+require File.dirname(__FILE__) + '/test_helper.rb'
+
+class BounceEmailTest < Test::Unit::TestCase
+
+  def test_bounce_type_hard_fail
+    bounce = test_bounce('tt_bounce_01')
+    assert_equal '5.1.2', bounce.code, "Code should return 5.1.2, returns #{bounce.code}"
+    assert_equal BounceEmail::TYPE_HARD_FAIL, bounce.type
+  end
+
+  #  Specific tests
+  def test_unrouteable_mail_domain
+    bounce = test_bounce('tt_bounce_01')
+    assert_equal '5.1.2', bounce.code, "Code should return 5.1.2, returns #{bounce.code}"
+
+    bounce = test_bounce('tt_bounce_02')
+    assert_equal '5.1.2', bounce.code, "Code should return 5.1.2, returns #{bounce.code}"
+  end
+
+  def test_set_5_0_status
+    bounce = test_bounce('tt_bounce_03')
+    assert_equal '5.0.0', bounce.code, "Code should return 5.0.0, returns #{bounce.code}"
+
+    bounce = test_bounce('tt_bounce_04')
+    assert_equal '5.0.0', bounce.code, "Code should return 5.0.0, returns #{bounce.code}"
+
+    bounce = test_bounce('tt_bounce_05')
+    assert_equal '5.0.0', bounce.code, "Code should return 5.0.0, returns #{bounce.code}"
+  end
+
+  def test_rota_dnsbl # TODO make this more general (match DNSBL only?)
+    bounce = test_bounce('tt_bounce_06')
+    assert_equal '5.7.1', bounce.code, "Code should return 5.7.1, returns #{bounce.code}"
+  end
+
+  # this test email suggests the library fails on this email;
+  # mail.part[0] includes a specific status code (5.1.1 User unknown)
+  # but the library tests mail.part[1], which returns the general code (5.0.0)
+  # either the test email is not a good example, or the parsing could be improved
+  def test_user_unknown
+    bounce = test_bounce('tt_bounce_07')
+    assert_equal '5.0.0', bounce.code
+  end
+
+  def test_permanent_failure
+    bounce = test_bounce('tt_bounce_08')
+    assert_equal '5.3.2', bounce.code
+
+    bounce = test_bounce('tt_bounce_09')
+    assert_equal '5.3.2', bounce.code
+  end
+
+  def test_bounce_type_soft_fail
+    bounce = test_bounce('tt_bounce_10')
+    assert_equal '4.0.0', bounce.code, "Code should return 4.0.0, returns #{bounce.code}"
+    assert_equal BounceEmail::TYPE_SOFT_FAIL, bounce.type
+  end
+
+  # Added because kept getting errors with malformed bounce messages
+  def test_malformed_bounce
+    bounce = test_bounce('malformed_bounce_01')
+    assert_equal '5.1.1', bounce.code
+  end
+
+  # Added because kept getting errors with unknown code messages
+  def test_unknown_code
+    bounce = test_bounce('unknown_code_bounce_01')
+    assert bounce.bounced?
+    assert_equal 'unknown', bounce.code
+    assert_equal BounceEmail::TYPE_HARD_FAIL, bounce.type
+    assert_equal 'unknown', bounce.reason
+  end
+
+  # test all other files
+  def test_all_bounces
+    path = File.join(File.dirname(__FILE__), 'bounces')
+    Dir[path + "/*.txt"].map do |file|
+      bounce = BounceEmail::Mail.new Mail.read(file)
+      assert bounce.bounced?, "#{file} failed"
+    end
+  end
+
+  def test_all_non_bounces
+    path = File.join(File.dirname(__FILE__), 'non_bounces')
+    Dir[path + "/*.txt"].map do |file|
+      non_bounce = BounceEmail::Mail.new Mail.read(file)
+      assert !non_bounce.bounced?, "#{file} failed"
+    end
+  end
+
+
+  def test_mail_methods_fallback
+    bounce = test_bounce('tt_bounce_10')
+    assert bounce.body
+    assert bounce.date
+  end
+  
+  #Test mutlipart message from exchange
+  def test_multipart
+    bounce = test_bounce('tt_bounce_24')
+    assert bounce.bounced?
+    assert_equal BounceEmail::TYPE_HARD_FAIL, bounce.type
+    assert_not_nil bounce.original_mail
+  end
+  
+  #Test regexp in when parsing the original email
+  def test_multipart
+   bounce = test_bounce('tt_bounce_25')
+    assert bounce.bounced?
+    assert_not_nil bounce.original_mail
+  end
+  
+end

data/test/bounces/malformed_bounce_01.txt

@@ -0,0 +1,75 @@
+Return-Path: <>
+Received: by 10.216.28.198 with SMTP id g48cs228780wea; Wed, 16 Dec 2009 02:45:14 +0000
+Received: ; Wed, 16 Dec 2009 02:41:20 +0000
+Date: Wed, 16 Dec 2009 02:41:20 +0000
+From: bounce@rediffmail.com
+To: support@myswom.com
+Message-Id: <4b2849b9.a813f30a.6c53.6801SMTPIN_ADDED@mx.google.com>
+Subject: failure notice
+Mime-Version: 1.0
+Content-Type: multipart/mixed; boundary=mimepart_4b2849cc52ad8_16153fb6b5e769bc586b3
+Authentication-Results: mx.google.com; spf=pass (google.com: domain of rediffmail.com designates 119.252.147.126 as permitted sender) smtp.mail=
+Delivered-To: support@myswom.com
+Received-Spf: pass (google.com: domain of rediffmail.com designates 119.252.147.126 as permitted sender) client-ip=119.252.147.126;
+
+
+--mimepart_4b2849cc52ad8_16153fb6b5e769bc586b3
+
+Hi. This is the qmail-send program at rediffmail.com.
+I'm afraid I wasn't able to deliver your message to the following addresses.
+This is a permanent error; I've given up. Sorry it didn't work out.
+
+<mithlesh_pm@rediffmail.com>:
+- Sorry, no mailbox here by that name. (#5.1.1)Z
+
+--- Enclosed is a copy of the message.
+
+
+--mimepart_4b2849cc52ad8_16153fb6b5e769bc586b3
+Content-Type: message/rfc822
+
+Return-Path: <support@myswom.com>
+Received: (qmail 43430 invoked from network); 16 Dec 2009 02:41:20 -0000
+X-CNFS-Analysis: score=0 v=1.0 c=1 a=UP0woeyT68oA:10 a=8sBYAydLBaTw9O9PPbvJRQ==:17 a=nOXXgcrqAAAA:8 a=hpnyz_ZHDEhns6bXdMYA:9 a=lOoBsn5VqPa6SSdm1A8A:7 a=n6XhW81lUO9q5u5E7SHj76VjDTMA:4 a=abhB7gKK_5kA:10 a=4phKvQ69a4IA:10
+X-REDIFF-SENDER-VERIFY: D=-2, P=D 
+Received: from mail.swom.com (HELO xenon.swom.com) (188.40.35.30)
+  by 0 with SMTP; 16 Dec 2009 02:41:20 -0000
+Received: from myswom.com (xenon.swom.com [188.40.35.28])
+	(Authenticated sender: support@myswom.com)
+	by xenon.swom.com (Postfix) with ESMTPSA id 64B392C60B
+	for <mithlesh_pm@rediffmail.com>; Wed, 16 Dec 2009 02:43:55 +0000 (GMT)
+Date: Wed, 16 Dec 2009 02:43:55 +0000
+From: Cash Culture <support@myswom.com>
+To: mithlesh_pm@rediffmail.com
+Message-Id: <4b28496b5a963_3adb3fc543c451b0910ee@xenon.swom.com.tmail>
+Subject: Cash Culture added you as a friend on Swom...
+Mime-Version: 1.0
+Content-Type: text/plain; charset=utf-8
+X-Swom-Uuid: 5c18dfcdfee13aa969f4c0c805e5ed0402b8f49b
+
+Cash has joined Swom.com and indicated you are a Friend:
+
+I'd like to add you to my wealth network on Swom.
+
+We know each other from CashCulture a while ago.
+
+- CashCulture
+
+To accept or view this invitation from Cash Culture:
+http://swom.com/c/7113/p/cdf64ba2/r/34007
+
+
+What is Swom.com?
+-------------------
+
+Swom.com is the new social networking site for professionals and business owners. 
+
+It helps you make more money by rapidly expanding your wealth network and increasing your income.
+
+It's free to join and it's growing fast. 
+
+
+The Swom.com Team
+
+
+--mimepart_4b2849cc52ad8_16153fb6b5e769bc586b3--