dball-mail 2.2.9.1

data/lib/mail/attachments_list.rb

@@ -0,0 +1,105 @@
+module Mail
+  class AttachmentsList < Array
+
+    def initialize(parts_list)
+      @parts_list = parts_list
+      @content_disposition_type = 'attachment'
+      parts_list.map { |p|
+        if p.content_type == "message/rfc822"
+          Mail.new(p.body).attachments
+        elsif p.parts.empty?
+          p if p.attachment?
+        else
+          p.attachments
+        end
+      }.flatten.compact.each { |a| self << a }
+      self
+    end
+
+    def inline
+      @content_disposition_type = 'inline'
+      self
+    end
+
+    # Returns the attachment by filename or at index.
+    #
+    # mail.attachments['test.png'] = File.read('test.png')
+    # mail.attachments['test.jpg'] = File.read('test.jpg')
+    #
+    # mail.attachments['test.png'].filename #=> 'test.png'
+    # mail.attachments[1].filename          #=> 'test.jpg'
+    def [](index_value)
+      if index_value.is_a?(Fixnum)
+        self.fetch(index_value)
+      else
+        self.select { |a| a.filename == index_value }.first
+      end
+    end
+
+    def []=(name, value)
+      default_values = { :content_type => "#{set_mime_type(name)}; filename=\"#{name}\"",
+                         :content_transfer_encoding => "#{guess_encoding}",
+                         :content_disposition => "#{@content_disposition_type}; filename=\"#{name}\"" }
+
+      if value.is_a?(Hash)
+
+        default_values[:body] = value.delete(:content) if value[:content]
+
+        default_values[:body] = value.delete(:data) if value[:data]
+
+        encoding = value.delete(:transfer_encoding) || value.delete(:encoding)
+        if encoding
+          if Mail::Encodings.defined? encoding
+            default_values[:content_transfer_encoding] = encoding
+          else
+            raise "Do not know how to handle Content Transfer Encoding #{encoding}, please choose either quoted-printable or base64"
+          end
+        end
+
+        if value[:mime_type]
+          default_values[:content_type] = value.delete(:mime_type)
+          @mime_type = MIME::Types[default_values[:content_type]].first
+          default_values[:content_transfer_encoding] = guess_encoding
+        end
+
+        hash = default_values.merge(value)
+      else
+        default_values[:body] = value
+        hash = default_values
+      end
+
+      if hash[:body].respond_to? :force_encoding and hash[:body].respond_to? :valid_encoding?
+        if not hash[:body].valid_encoding? and default_values[:content_transfer_encoding].downcase == "binary"
+          hash[:body].force_encoding("BINARY")
+        end
+      end
+      
+      attachment = Part.new(hash)
+      attachment.add_content_id(hash[:content_id])
+
+      @parts_list << attachment
+    end
+
+    # Uses the mime type to try and guess the encoding, if it is a binary type, or unknown, then we
+    # set it to binary, otherwise as set to plain text
+    def guess_encoding
+      if @mime_type && !@mime_type.binary?
+        "7bit"
+      else
+        "binary"
+      end
+    end
+
+    def set_mime_type(filename)
+      # Have to do this because MIME::Types is not Ruby 1.9 safe yet
+      if RUBY_VERSION >= '1.9'
+        new_file = String.new(filename).force_encoding(Encoding::BINARY)
+        ext = new_file.split('.'.force_encoding(Encoding::BINARY)).last
+        filename = "file.#{ext}".force_encoding('US-ASCII')
+      end
+      @mime_type = MIME::Types.type_for(filename).first
+    end
+
+  end
+end
+

data/lib/mail/body.rb

@@ -0,0 +1,286 @@
+# encoding: utf-8
+module Mail
+  
+  # = Body
+  # 
+  # The body is where the text of the email is stored.  Mail treats the body
+  # as a single object.  The body itself has no information about boundaries
+  # used in the MIME standard, it just looks at it's content as either a single
+  # block of text, or (if it is a multipart message) as an array of blocks o text.
+  # 
+  # A body has to be told to split itself up into a multipart message by calling
+  # #split with the correct boundary.  This is because the body object has no way
+  # of knowing what the correct boundary is for itself (there could be many
+  # boundaries in a body in the case of a nested MIME text).
+  # 
+  # Once split is called, Mail::Body will slice itself up on this boundary,
+  # assigning anything that appears before the first part to the preamble, and
+  # anything that appears after the closing boundary to the epilogue, then
+  # each part gets initialized into a Mail::Part object.
+  # 
+  # The boundary that is used to split up the Body is also stored in the Body
+  # object for use on encoding itself back out to a string.  You can 
+  # overwrite this if it needs to be changed.
+  # 
+  # On encoding, the body will return the preamble, then each part joined by
+  # the boundary, followed by a closing boundary string and then the epilogue.
+  class Body
+
+    def initialize(string = '')
+      @boundary = nil
+      @preamble = nil
+      @epilogue = nil
+      @charset  = nil
+      @part_sort_order = [ "text/plain", "text/enriched", "text/html" ]
+      @parts = Mail::PartsList.new
+      if string.blank?
+        @raw_source = ''
+      else
+        # Do join first incase we have been given an Array in Ruby 1.9
+        if string.respond_to?(:join)
+          @raw_source = string.join('')
+        elsif string.respond_to?(:to_s)
+          @raw_source = string.to_s
+        else
+          raise "You can only assign a string or an object that responds_to? :join or :to_s to a body."
+        end
+      end
+      @encoding = (only_us_ascii? ? '7bit' : '8bit')
+      set_charset
+    end
+    
+    # Matches this body with another body.  Also matches the decoded value of this
+    # body with a string.
+    # 
+    # Examples:
+    # 
+    #   body = Mail::Body.new('The body')
+    #   body == body #=> true
+    #   
+    #   body = Mail::Body.new('The body')
+    #   body == 'The body' #=> true
+    #   
+    #   body = Mail::Body.new("VGhlIGJvZHk=\n")
+    #   body.encoding = 'base64'
+    #   body == "The body" #=> true
+    def ==(other)
+      if other.class == String
+        self.decoded == other
+      else
+        super
+      end
+    end
+    
+    # Accepts a string and performs a regular expression against the decoded text
+    # 
+    # Examples:
+    # 
+    #   body = Mail::Body.new('The body')
+    #   body =~ /The/ #=> 0
+    #   
+    #   body = Mail::Body.new("VGhlIGJvZHk=\n")
+    #   body.encoding = 'base64'
+    #   body =~ /The/ #=> 0
+    def =~(regexp)
+      self.decoded =~ regexp
+    end
+    
+    # Accepts a string and performs a regular expression against the decoded text
+    # 
+    # Examples:
+    # 
+    #   body = Mail::Body.new('The body')
+    #   body.match(/The/) #=> #<MatchData "The">
+    #   
+    #   body = Mail::Body.new("VGhlIGJvZHk=\n")
+    #   body.encoding = 'base64'
+    #   body.match(/The/) #=> #<MatchData "The">
+    def match(regexp)
+      self.decoded.match(regexp)
+    end
+
+    # Accepts anything that responds to #to_s and checks if it's a substring of the decoded text
+    #
+    # Examples:
+    #
+    #   body = Mail::Body.new('The body')
+    #   body.include?('The') #=> true
+    #
+    #   body = Mail::Body.new("VGhlIGJvZHk=\n")
+    #   body.encoding = 'base64'
+    #   body.include?('The') #=> true
+    def include?(other)
+      self.decoded.include?(other.to_s)
+    end
+
+    # Allows you to set the sort order of the parts, overriding the default sort order.
+    # Defaults to 'text/plain', then 'text/enriched', then 'text/html' with any other content
+    # type coming after.
+    def set_sort_order(order)
+      @part_sort_order = order
+    end
+    
+    # Allows you to sort the parts according to the default sort order, or the sort order you
+    # set with :set_sort_order.
+    #
+    # sort_parts! is also called from :encode, so there is no need for you to call this explicitly
+    def sort_parts!
+      @parts.each do |p|
+        p.body.set_sort_order(@part_sort_order)
+        @parts.sort!(@part_sort_order)
+        p.body.sort_parts!
+      end
+    end
+    
+    # Returns the raw source that the body was initialized with, without
+    # any tampering
+    def raw_source
+      @raw_source
+    end
+   
+    def get_best_encoding(target)
+      target_encoding = Mail::Encodings.get_encoding(target)
+      target_encoding.get_best_compatible(encoding, raw_source)
+    end
+ 
+    # Returns a body encoded using transfer_encoding.  Multipart always uses an
+    # identiy encoding (i.e. no encoding).
+    # Calling this directly is not a good idea, but supported for compatibility
+    # TODO: Validate that preamble and epilogue are valid for requested encoding
+    def encoded(transfer_encoding = '8bit')
+      if multipart?
+        self.sort_parts!
+        encoded_parts = parts.map { |p| p.encoded }
+        ([preamble] + encoded_parts).join(crlf_boundary) + end_boundary + epilogue.to_s
+      else
+        be = get_best_encoding(transfer_encoding)
+        dec = Mail::Encodings::get_encoding(encoding)
+        enc = Mail::Encodings::get_encoding(be)
+        if transfer_encoding == encoding and dec.nil?
+            # Cannot decode, so skip normalization
+            raw_source
+        else
+            # Decode then encode to normalize and allow transforming 
+            # from base64 to Q-P and vice versa
+            enc.encode(dec.decode(raw_source))
+        end
+      end
+    end
+    
+    def decoded
+      if !Encodings.defined?(encoding)
+        raise UnknownEncodingType, "Don't know how to decode #{encoding}, please call #encoded and decode it yourself."
+      else
+        Encodings.get_encoding(encoding).decode(raw_source)
+      end
+    end
+    
+    def to_s
+      decoded
+    end
+    
+    def charset
+      @charset
+    end
+    
+    def charset=( val )
+      @charset = val
+    end
+
+    def encoding(val = nil)
+      if val
+        self.encoding = val
+      else
+        @encoding
+      end
+    end
+    
+    def encoding=( val )
+      if val == "text" || val.blank? then
+        val = "8bit"
+      end
+      @encoding = (val == "text") ? "8bit" : val
+    end
+
+    # Returns the preamble (any text that is before the first MIME boundary)
+    def preamble
+      @preamble
+    end
+
+    # Sets the preamble to a string (adds text before the first MIME boundary)
+    def preamble=( val )
+      @preamble = val
+    end
+    
+    # Returns the epilogue (any text that is after the last MIME boundary)
+    def epilogue
+      @epilogue
+    end
+    
+    # Sets the epilogue to a string (adds text after the last MIME boundary)
+    def epilogue=( val )
+      @epilogue = val
+    end
+    
+    # Returns true if there are parts defined in the body
+    def multipart?
+      true unless parts.empty?
+    end
+    
+    # Returns the boundary used by the body
+    def boundary
+      @boundary
+    end
+    
+    # Allows you to change the boundary of this Body object
+    def boundary=( val )
+      @boundary = val
+    end
+
+    def parts
+      @parts
+    end
+    
+    def <<( val )
+      if @parts
+        @parts << val
+      else
+        @parts = Mail::PartsList.new[val]
+      end
+    end
+    
+    def split!(boundary)
+      self.boundary = boundary
+      parts = raw_source.split("--#{boundary}")
+      # Make the preamble equal to the preamble (if any)
+      self.preamble = parts[0].to_s.strip
+      # Make the epilogue equal to the epilogue (if any)
+      self.epilogue = parts[-1].to_s.sub('--', '').strip
+      parts[1...-1].to_a.each { |part| @parts << Mail::Part.new(part) }
+      self
+    end
+    
+    def only_us_ascii?
+      raw_source.each_byte {|b| return false if (b == 0 || b > 127)}
+      true
+    end
+    
+    def empty?
+      !!raw_source.to_s.empty?
+    end
+    
+    private
+    
+    def crlf_boundary
+      "\r\n\r\n--#{boundary}\r\n"
+    end
+    
+    def end_boundary
+      "\r\n\r\n--#{boundary}--\r\n"
+    end
+    
+    def set_charset
+      only_us_ascii? ? @charset = 'US-ASCII' : @charset = nil
+    end
+  end
+end

data/lib/mail/configuration.rb

@@ -0,0 +1,71 @@
+# encoding: utf-8
+#
+# Thanks to Nicolas Fouché for this wrapper
+#
+require 'singleton'
+
+module Mail
+  
+  # The Configuration class is a Singleton used to hold the default
+  # configuration for all Mail objects.
+  # 
+  # Each new mail object gets a copy of these values at initialization
+  # which can be overwritten on a per mail object basis.
+  class Configuration
+    include Singleton
+
+    def initialize
+      @delivery_method  = nil
+      @retriever_method = nil
+      super
+    end
+
+    def delivery_method(method = nil, settings = {})
+      return @delivery_method if @delivery_method && method.nil?
+      @delivery_method = lookup_delivery_method(method).new(settings)
+    end
+
+    def lookup_delivery_method(method)
+      case method
+      when nil
+        Mail::SMTP
+      when :smtp
+        Mail::SMTP
+      when :sendmail
+        Mail::Sendmail
+      when :file
+        Mail::FileDelivery
+      when :test
+        Mail::TestMailer
+      else
+        method
+      end
+    end
+
+    def retriever_method(method = nil, settings = {})
+      return @retriever_method if @retriever_method && method.nil?
+      @retriever_method = lookup_retriever_method(method).new(settings)
+    end
+    
+    def lookup_retriever_method(method)
+      case method
+      when nil
+        Mail::POP3
+      when :pop3
+        Mail::POP3
+      when :imap
+        Mail::IMAP
+      when :test
+        Mail::TestRetriever
+      else
+        method
+      end
+    end
+
+    def param_encode_language(value = nil)
+      value ? @encode_language = value : @encode_language ||= 'en'
+    end
+
+  end
+
+end

data/lib/mail/core_extensions/nil.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+
+class NilClass #:nodoc:
+  def to_crlf
+    ''
+  end
+
+  def to_lf
+    ''
+  end
+end

data/lib/mail/core_extensions/string.rb

@@ -0,0 +1,27 @@
+# encoding: utf-8
+class String #:nodoc:
+  def to_crlf
+    gsub(/\n|\r\n|\r/) { "\r\n" }
+  end
+
+  def to_lf
+    gsub(/\n|\r\n|\r/) { "\n" }
+  end
+
+  unless method_defined?(:ascii_only?)
+    # Provides all strings with the Ruby 1.9 method of .ascii_only? and
+    # returns true or false
+    US_ASCII_REGEXP = %Q{\x00-\x7f}
+    def ascii_only?
+      !(self =~ /[^#{US_ASCII_REGEXP}]/)
+    end
+  end
+  
+  def not_ascii_only?
+    !ascii_only?
+  end
+
+  unless method_defined?(:bytesize)
+    alias :bytesize :length
+  end
+end