kbaum-mail 2.1.2.1

data/lib/mail/fields/content_location_field.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class ContentLocationField < StructuredField
+    
+    FIELD_NAME = 'content-location'
+    CAPITALIZED_FIELD = 'Content-Location'
+    
+    def initialize(*args)
+      super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, args.last))
+      self.parse
+      self
+
+    end
+    
+    def parse(val = value)
+      unless val.blank?
+        @element = Mail::ContentLocationElement.new(val)
+      end
+    end
+    
+    def element
+      @element ||= Mail::ContentLocationElement.new(value)
+    end
+
+    def location
+      element.location
+    end
+
+    # TODO: Fix this up
+    def encoded
+      "#{CAPITALIZED_FIELD}: #{value}\r\n"
+    end
+    
+    def decoded
+      value
+    end
+
+  end
+end

data/lib/mail/fields/content_transfer_encoding_field.rb

@@ -0,0 +1,45 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class ContentTransferEncodingField < StructuredField
+    
+    FIELD_NAME = 'content-transfer-encoding'
+    CAPITALIZED_FIELD = 'Content-Transfer-Encoding'
+    
+    def initialize(*args)
+      super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, args.last.to_s.downcase))
+    end
+    
+    def parse(val = value)
+      unless val.blank?
+        @element = Mail::ContentTransferEncodingElement.new(val)
+        @tree = @element.tree
+      end
+    end
+    
+    def tree
+      @element ||= Mail::ContentTransferEncodingElement.new(value)
+      @tree ||= @element.tree
+    end
+    
+    def element
+      @element ||= Mail::ContentTransferEncodingElement.new(value)
+    end
+    
+    def encoding
+      element.encoding
+    end
+    
+    # TODO: Fix this up
+    def encoded
+      "#{CAPITALIZED_FIELD}: #{value}\r\n"
+    end
+    
+    def decoded
+      value
+    end
+    
+  end
+end

data/lib/mail/fields/content_type_field.rb

@@ -0,0 +1,175 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class ContentTypeField < StructuredField
+    
+    FIELD_NAME = 'content-type'
+    CAPITALIZED_FIELD = 'Content-Type'
+    
+    def initialize(*args)
+      if args.last.class == Array
+        @main_type = args.last[0]
+        @sub_type = args.last[1]
+        @parameters = ParameterHash.new.merge!(args.last.last)
+        super(CAPITALIZED_FIELD, args.last)
+      else
+        @main_type = nil
+        @sub_type = nil
+        @parameters = nil
+        super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, args.last))
+      end
+      self.parse
+      self
+    end
+    
+    def parse(val = value)
+      unless val.blank?
+        self.value = val 
+        @element = nil
+        element
+      end
+    end
+    
+    def element
+      begin
+        @element ||= Mail::ContentTypeElement.new(value)
+      rescue
+        attempt_to_clean
+      end
+    end
+    
+    def attempt_to_clean
+      # Sanitize the value, handle special cases
+      @element ||= Mail::ContentTypeElement.new(sanatize(value))
+    rescue
+      # All else fails, just get the mime type
+      @element ||= Mail::ContentTypeElement.new(get_mime_type(value))
+    end
+    
+    def main_type
+      @main_type ||= element.main_type
+    end
+
+    def sub_type
+      @sub_type ||= element.sub_type
+    end
+    
+    def string
+      "#{main_type}/#{sub_type}"
+    end
+    
+    def default
+      decoded
+    end
+    
+    alias :content_type :string
+    
+    def parameters
+      unless @parameters
+        @parameters = ParameterHash.new
+        element.parameters.each { |p| @parameters.merge!(p) }
+      end
+      @parameters
+    end
+
+    def ContentTypeField.with_boundary(type)
+      new("#{type}; boundary=#{generate_boundary}")
+    end
+    
+    def ContentTypeField.generate_boundary
+      "--==_mimepart_#{Mail.random_tag}"
+    end
+
+    def value
+      if @value.class == Array
+        "#{@main_type}/#{@sub_type}; #{stringify(parameters)}"
+      else
+        @value
+      end
+    end
+    
+    def stringify(params)
+      params.map { |k,v| "#{k}=#{Encodings.param_encode(v)}" }.join("; ")
+    end
+
+    def filename
+      case
+      when parameters['filename']
+        @filename = parameters['filename']
+      when parameters['name']
+        @filename = parameters['name']
+      else 
+        @filename = nil
+      end
+      @filename
+    end
+    
+    # TODO: Fix this up
+    def encoded
+      "#{CAPITALIZED_FIELD}: #{content_type};\r\n\t#{parameters.encoded};\r\n"
+    end
+    
+    def decoded
+      value
+    end
+
+    private
+    
+    def method_missing(name, *args, &block)
+      if name.to_s =~ /([\w_]+)=/
+        self.parameters[$1] = args.first
+        @value = "#{content_type}; #{stringify(parameters)}"
+      else
+        super
+      end
+    end
+    
+    # Various special cases from random emails found that I am not going to change
+    # the parser for
+    def sanatize( val )
+      case
+      when val.chomp =~ /^\s*([\w\d\-_]+)\/([\w\d\-_]+)\s*;;+(.*)$/i
+        # Handles 'text/plain;; format="flowed"' (double semi colon)
+        "#{$1}/#{$2}; #{$3}"
+      when val.chomp =~ /^\s*([\w\d\-_]+)\/([\w\d\-_]+)\s*;(ISO[\w\d\-_]+)$/i
+        # Microsoft helper:
+        # Handles 'mime/type;ISO-8559-1'
+        "#{$1}/#{$2}; charset=#{quote_atom($3)}"
+      when val.chomp =~ /^text;?$/i
+        # Handles 'text;' and 'text'
+        "text/plain;"
+      when val.chomp =~ /^(\w+);\s(.*)$/i
+        # Handles 'text; <parameters>'
+        "text/plain; #{$2}"
+      when val =~ /([\w\d\-_]+\/[\w\d\-_]+);\scharset="charset="(\w+)""/i
+        # Handles text/html; charset="charset="GB2312""
+        "#{$1}; charset=#{quote_atom($2)}"
+      when val =~ /([\w\d\-_]+\/[\w\d\-_]+);\s+(.*)/i
+        type = $1
+        # Handles misquoted param values
+        # e.g: application/octet-stream; name=archiveshelp1[1].htm
+        # and: audio/x-midi;\r\n\tname=Part .exe
+        params = $2.to_s.split(/\s+/)
+        params = params.map { |i| i.to_s.chomp.strip }
+        params = params.map { |i| i.split(/\s*\=\s*/) }
+        params = params.map { |i| "#{i[0]}=#{dquote(i[1].to_s)}" }.join('; ')
+        "#{type}; #{params}"
+      when val =~ /^\s*$/
+        'text/plain'
+      else
+        ''
+      end
+    end
+    
+    def get_mime_type( val )
+      case
+      when val =~ /^([\w\d\-_]+)\/([\w\d\-_]+);.+$/i
+        "#{$1}/#{$2}"
+      else 
+        'text/plain'
+      end
+    end
+  end
+end

data/lib/mail/fields/date_field.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+# 
+# = Date Field
+# 
+# The Date field inherits from StructuredField and handles the Date: header
+# field in the email.
+# 
+# Sending date to a mail message will instantiate a Mail::Field object that
+# has a DateField as it's field type.  This includes all Mail::CommonAddress
+# module instance methods.
+# 
+# There must be excatly one Date field in an RFC2822 email.
+# 
+# == Examples:
+# 
+#  mail = Mail.new
+#  mail.date = 'Mon, 24 Nov 1997 14:22:01 -0800'
+#  mail.date       #=> #<DateTime: 211747170121/86400,-1/3,2299161>
+#  mail.date.to_s  #=> 'Mon, 24 Nov 1997 14:22:01 -0800'
+#  mail[:date]     #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
+#  mail['date']    #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
+#  mail['Date']    #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
+# 
+module Mail
+  class DateField < StructuredField
+    
+    include Mail::CommonDate
+    
+    FIELD_NAME = 'date'
+    CAPITALIZED_FIELD = "Date"
+    
+    def initialize(*args)
+      if args.last.blank?
+        self.name = CAPITALIZED_FIELD
+        self.value = Time.now.strftime('%a, %d %b %Y %H:%M:%S %z')
+        self
+      else
+        value = strip_field(FIELD_NAME, args.last)
+        value = ::DateTime.parse(value.to_s).strftime('%a, %d %b %Y %H:%M:%S %z')
+        super(CAPITALIZED_FIELD, value)
+      end
+    end
+    
+    def encoded
+      do_encode(CAPITALIZED_FIELD)
+    end
+    
+    def decoded
+      do_decode
+    end
+    
+  end
+end

data/lib/mail/fields/from_field.rb

@@ -0,0 +1,53 @@
+# encoding: utf-8
+# 
+# = From Field
+# 
+# The From field inherits from StructuredField and handles the From: header
+# field in the email.
+# 
+# Sending from to a mail message will instantiate a Mail::Field object that
+# has a FromField as it's field type.  This includes all Mail::CommonAddress
+# module instance metods.
+# 
+# Only one From field can appear in a header, though it can have multiple
+# addresses and groups of addresses.
+# 
+# == Examples:
+# 
+#  mail = Mail.new
+#  mail.from = 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+#  mail.from    #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
+#  mail[:from]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
+#  mail['from'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
+#  mail['From'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
+# 
+#  mail[:from].encoded   #=> 'from: Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net\r\n'
+#  mail[:from].decoded   #=> 'Mikel Lindsaar <mikel@test.lindsaar.net>, ada@test.lindsaar.net'
+#  mail[:from].addresses #=> ['mikel@test.lindsaar.net', 'ada@test.lindsaar.net']
+#  mail[:from].formatted #=> ['Mikel Lindsaar <mikel@test.lindsaar.net>', 'ada@test.lindsaar.net']
+# 
+module Mail
+  class FromField < StructuredField
+    
+    include Mail::CommonAddress
+    
+    FIELD_NAME = 'from'
+    CAPITALIZED_FIELD = 'From'
+    
+    def initialize(*args)
+      super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, args.last))
+      self.parse
+      self
+
+    end
+    
+    def encoded
+      do_encode(CAPITALIZED_FIELD)
+    end
+    
+    def decoded
+      do_decode
+    end
+
+  end
+end

data/lib/mail/fields/in_reply_to_field.rb

@@ -0,0 +1,52 @@
+# encoding: utf-8
+# 
+# = In-Reply-To Field
+# 
+# The In-Reply-To field inherits from StructuredField and handles the 
+# In-Reply-To: header field in the email.
+# 
+# Sending in_reply_to to a mail message will instantiate a Mail::Field object that
+# has a InReplyToField as it's field type.  This includes all Mail::CommonMessageId
+# module instance metods.
+# 
+# Note that, the #message_ids method will return an array of message IDs without the
+# enclosing angle brackets which per RFC are not syntactically part of the message id.
+# 
+# Only one InReplyTo field can appear in a header, though it can have multiple
+# Message IDs.
+# 
+# == Examples:
+# 
+#  mail = Mail.new
+#  mail.in_reply_to = '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
+#  mail.in_reply_to    #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
+#  mail[:in_reply_to]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
+#  mail['in_reply_to'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
+#  mail['In-Reply-To'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
+# 
+#  mail[:in_reply_to].message_ids #=> ['F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom']
+# 
+module Mail
+  class InReplyToField < StructuredField
+    
+    include Mail::CommonMessageId
+    
+    FIELD_NAME = 'in-reply-to'
+    CAPITALIZED_FIELD = 'In-Reply-To'
+    
+    def initialize(*args)
+      super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, args.last))
+      self.parse
+      self
+    end
+    
+    def encoded
+      do_encode(CAPITALIZED_FIELD)
+    end
+    
+    def decoded
+      do_decode
+    end
+    
+  end
+end

data/lib/mail/fields/keywords_field.rb

@@ -0,0 +1,43 @@
+# encoding: utf-8
+# 
+# keywords        =       "Keywords:" phrase *("," phrase) CRLF
+module Mail
+  class KeywordsField < StructuredField
+    
+    FIELD_NAME = 'keywords'
+    CAPITALIZED_FIELD = 'Keywords'
+    
+    def initialize(*args)
+      super(CAPITALIZED_FIELD, strip_field(FIELD_NAME, args.last))
+      self.parse
+      self
+    end
+
+    def parse(val = value)
+      unless val.blank?
+        @phrase_list ||= PhraseList.new(value)
+      end
+    end
+    
+    def phrase_list
+      @phrase_list ||= PhraseList.new(value)
+    end
+      
+    def keywords
+      phrase_list.phrases
+    end
+    
+    def encoded
+      "#{CAPITALIZED_FIELD}: #{keywords.join(', ')}\r\n"
+    end
+    
+    def decoded
+      keywords.join(', ')
+    end
+
+    def default
+      keywords
+    end
+    
+  end
+end