mail 1.0.0

data/lib/mail/fields/content_id_field.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class ContentIdField < StructuredField
+    
+    FIELD_NAME = 'content-id'
+    
+    def initialize(*args)
+      @uniq = 1
+      if args.last.blank?
+        self.name = FIELD_NAME
+        self.value = generate_content_id
+        self
+      else
+        super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+      end
+    end
+    
+    def tree
+      @element ||= Mail::MessageIdsElement.new(value)
+      @tree ||= @element.tree
+    end
+    
+    def element
+      @element ||= Mail::MessageIdsElement.new(value)
+    end
+    
+    def name
+      'Content-ID'
+    end
+    
+    def content_id
+      element.message_id
+    end
+    
+    def to_s
+      "<#{content_id}>"
+    end
+    
+    private
+    
+    def generate_content_id
+      fqdn = ::Socket.gethostname
+      "<#{Mail.random_tag}@#{fqdn}.mail>"
+    end
+    
+  end
+end

data/lib/mail/fields/content_transfer_encoding_field.rb

@@ -0,0 +1,28 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class ContentTransferEncodingField < StructuredField
+    
+    FIELD_NAME = 'content-transfer-encoding'
+
+    def initialize(*args)
+      super(FIELD_NAME, strip_field(FIELD_NAME, args.last.to_s.downcase))
+    end
+    
+    def tree
+      @element ||= ContentTransferEncodingElement.new(value)
+      @tree ||= @element.tree
+    end
+    
+    def element
+      @element ||= ContentTransferEncodingElement.new(value)
+    end
+    
+    def encoding
+      element.encoding
+    end
+    
+  end
+end

data/lib/mail/fields/content_type_field.rb

@@ -0,0 +1,50 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class ContentTypeField < StructuredField
+    
+    FIELD_NAME = 'content-type'
+
+    def initialize(*args)
+      super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+    end
+    
+    def tree
+      @element ||= Mail::ContentTypeElement.new(value)
+      @tree ||= @element.tree
+    end
+    
+    def element
+      @element ||= Mail::ContentTypeElement.new(value)
+    end
+    
+    def main_type
+      element.main_type
+    end
+
+    def sub_type
+      element.sub_type
+    end
+    
+    def content_type
+      "#{main_type}/#{sub_type}"
+    end
+    
+    def parameters
+      @parameters = Hash.new
+      element.parameters.each { |p| @parameters.merge!(p) }
+      @parameters
+    end
+
+    def ContentTypeField.with_boundary(type)
+      new("#{type}; boundary=#{generate_boundary}")
+    end
+    
+    def ContentTypeField.generate_boundary
+      "--==_mimepart_#{Mail.random_tag}"
+    end
+
+  end
+end

data/lib/mail/fields/date_field.rb

@@ -0,0 +1,44 @@
+# 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    #=> '#<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
+#  mail['Date'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::DateField:0x180e1c4
+# 
+#  mail.date.to_s  #=> 'Mon, 24 Nov 1997 14:22:01 -0800'
+#  mail.date.date_time #=> #<DateTime: 211747170121/86400,-1/3,2299161>
+# 
+module Mail
+  class DateField < StructuredField
+    
+    include Mail::CommonDate
+    
+    FIELD_NAME = 'date'
+    
+    def initialize(*args)
+      if args.last.blank?
+        self.name = FIELD_NAME
+        self.value = Time.now.strftime('%a, %d %b %Y %H:%M:%S %z')
+        self
+      else
+        super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+      end
+    end
+    
+  end
+end

data/lib/mail/fields/from_field.rb

@@ -0,0 +1,40 @@
+# 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    #=> '#<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'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::FromField:0x180e1c4
+# 
+#  mail.from.to_s  #=> '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'
+    
+    def initialize(*args)
+      super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+    end
+    
+  end
+end

data/lib/mail/fields/in_reply_to_field.rb

@@ -0,0 +1,42 @@
+# 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    #=> '#<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'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::InReplyToField:0x180e1c4
+# 
+#  mail.in_reply_to.to_s  #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
+#  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'
+    
+    def initialize(*args)
+      super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+    end
+    
+  end
+end

data/lib/mail/fields/keywords_field.rb

@@ -0,0 +1,22 @@
+# encoding: utf-8
+# 
+# keywords        =       "Keywords:" phrase *("," phrase) CRLF
+module Mail
+  class KeywordsField < StructuredField
+    
+    FIELD_NAME = 'keywords'
+    
+    def initialize(*args)
+      super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+    end
+    
+    def phrase_list
+      @phrase_list ||= PhraseList.new(value)
+    end
+      
+    def keywords
+      phrase_list.phrases
+    end
+    
+  end
+end

data/lib/mail/fields/message_id_field.rb

@@ -0,0 +1,70 @@
+# encoding: utf-8
+# 
+# = Message-ID Field
+# 
+# The Message-ID field inherits from StructuredField and handles the 
+# Message-ID: header field in the email.
+# 
+# Sending message_id to a mail message will instantiate a Mail::Field object that
+# has a MessageIdField as it's field type.  This includes all Mail::CommonMessageId
+# module instance metods.
+# 
+# Only one MessageId field can appear in a header, and syntactically it can only have
+# one Message ID.  The message_ids method call has been left in however as it will only
+# return the one message id, ie, an array of length 1.
+# 
+# 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.
+# 
+# == Examples:
+# 
+#  mail = Mail.new
+#  mail.message_id = '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
+#  mail.message_id    #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
+#  mail[:message_id]  #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
+#  mail['message_id'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
+#  mail['Message-ID'] #=> '#<Mail::Field:0x180e5e8 @field=#<Mail::MessageIdField:0x180e1c4
+# 
+#  mail.message_id.to_s         #=> '<F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom>'
+#  mail.message_id.message_id   #=> 'F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom'
+#  mail.message_id.message_ids  #=> ['F6E2D0B4-CC35-4A91-BA4C-C7C712B10C13@test.me.dom']
+# 
+module Mail
+  class MessageIdField < StructuredField
+    
+    include Mail::CommonMessageId
+    
+    FIELD_NAME = 'message-id'
+    
+    def initialize(*args)
+      @uniq = 1
+      if args.last.blank?
+        self.name = FIELD_NAME
+        self.value = generate_message_id
+        self
+      else
+        super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+      end
+    end
+    
+    def name
+      'Message-ID'
+    end
+    
+    def message_ids
+      [message_id]
+    end
+    
+    def to_s
+      "<#{message_id}>"
+    end
+    
+    private
+    
+    def generate_message_id
+      fqdn = ::Socket.gethostname
+      "<#{Mail.random_tag}@#{fqdn}.mail>"
+    end
+    
+  end
+end

data/lib/mail/fields/mime_version_field.rb

@@ -0,0 +1,42 @@
+# encoding: utf-8
+# 
+# 
+# 
+module Mail
+  class MimeVersionField < StructuredField
+    
+    FIELD_NAME = 'mime-version'
+
+    def initialize(*args)
+      if args.last.blank?
+        self.name = FIELD_NAME
+        self.value = '1.0'
+        self
+      else
+        super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+      end
+    end
+    
+    def tree
+      @element ||= MimeVersionElement.new(value)
+      @tree ||= @element.tree
+    end
+    
+    def element
+      @element ||= MimeVersionElement.new(value)
+    end
+    
+    def version
+      "#{element.major}.#{element.minor}"
+    end
+
+    def major
+      element.major.to_i
+    end
+
+    def minor
+      element.minor.to_i
+    end
+    
+  end
+end

data/lib/mail/fields/optional_field.rb

@@ -0,0 +1,11 @@
+# encoding: utf-8
+# 
+#    The field names of any optional-field MUST NOT be identical to any
+#    field name specified elsewhere in this standard.
+# 
+# optional-field  =       field-name ":" unstructured CRLF
+module Mail
+  class OptionalField < UnstructuredField
+    
+  end
+end

data/lib/mail/fields/received_field.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+# 
+# trace           =       [return]
+#                         1*received
+# 
+# return          =       "Return-Path:" path CRLF
+# 
+# path            =       ([CFWS] "<" ([CFWS] / addr-spec) ">" [CFWS]) /
+#                         obs-path
+# 
+# received        =       "Received:" name-val-list ";" date-time CRLF
+# 
+# name-val-list   =       [CFWS] [name-val-pair *(CFWS name-val-pair)]
+# 
+# name-val-pair   =       item-name CFWS item-value
+# 
+# item-name       =       ALPHA *(["-"] (ALPHA / DIGIT))
+# 
+# item-value      =       1*angle-addr / addr-spec /
+#                          atom / domain / msg-id
+# 
+module Mail
+  class ReceivedField < StructuredField
+    
+    FIELD_NAME = 'received'
+    
+    def initialize(*args)
+      super(FIELD_NAME, strip_field(FIELD_NAME, args.last))
+    end
+    
+    def tree
+      @element ||= ReceivedElement.new(value)
+      @tree ||= @element.tree
+    end
+    
+    def element
+      @element ||= ReceivedElement.new(value)
+    end
+    
+    def date_time
+      ::DateTime.parse("#{element.date_time}")
+    end
+
+    def info
+      element.info
+    end
+    
+  end
+end