mail 1.0.0

data/lib/mail/version_specific/multibyte/exceptions.rb

@@ -0,0 +1,8 @@
+# encoding: utf-8
+
+module Mail #:nodoc:
+  module Multibyte #:nodoc:
+    # Raised when a problem with the encoding was found.
+    class EncodingError < StandardError; end
+  end
+end

data/lib/mail/version_specific/multibyte/unicode_database.rb

@@ -0,0 +1,71 @@
+# encoding: utf-8
+
+module Mail #:nodoc:
+  module Multibyte #:nodoc:
+    # Holds data about a codepoint in the Unicode database
+    class Codepoint
+      attr_accessor :code, :combining_class, :decomp_type, :decomp_mapping, :uppercase_mapping, :lowercase_mapping
+    end
+
+    # Holds static data from the Unicode database
+    class UnicodeDatabase
+      ATTRIBUTES = :codepoints, :composition_exclusion, :composition_map, :boundary, :cp1252
+
+      attr_writer(*ATTRIBUTES)
+
+      def initialize
+        @codepoints = Hash.new(Codepoint.new)
+        @composition_exclusion = []
+        @composition_map = {}
+        @boundary = {}
+        @cp1252 = {}
+      end
+
+      # Lazy load the Unicode database so it's only loaded when it's actually used
+      ATTRIBUTES.each do |attr_name|
+        class_eval(<<-EOS, __FILE__, __LINE__)
+          def #{attr_name}  # def codepoints
+            load            #   load
+            @#{attr_name}   #   @codepoints
+          end               # end
+        EOS
+      end
+
+      # Loads the Unicode database and returns all the internal objects of UnicodeDatabase.
+      def load
+        begin
+          @codepoints, @composition_exclusion, @composition_map, @boundary, @cp1252 = File.open(self.class.filename, 'rb') { |f| Marshal.load f.read }
+        rescue Exception => e
+            raise IOError.new("Couldn't load the Unicode tables for UTF8Handler (#{e.message}), ActiveSupport::Multibyte is unusable")
+        end
+
+        # Redefine the === method so we can write shorter rules for grapheme cluster breaks
+        @boundary.each do |k,_|
+          @boundary[k].instance_eval do
+            def ===(other)
+              detect { |i| i === other } ? true : false
+            end
+          end if @boundary[k].kind_of?(Array)
+        end
+
+        # define attr_reader methods for the instance variables
+        class << self
+          attr_reader(*ATTRIBUTES)
+        end
+      end
+
+      # Returns the directory in which the data files are stored
+      def self.dirname
+        File.dirname(__FILE__) + '/../values/'
+      end
+
+      # Returns the filename for the data file for this version
+      def self.filename
+        File.expand_path File.join(dirname, "unicode_tables.dat")
+      end
+    end
+
+    # UniCode Database
+    UCD = UnicodeDatabase.new
+  end
+end

data/lib/mail/version_specific/ruby_1_8.rb

@@ -0,0 +1,61 @@
+# encoding: utf-8
+module Mail
+  class Ruby18
+    require 'base64'
+
+    # Escapes any parenthesis in a string that are unescaped. This can't
+    # use the Ruby 1.9.1 regexp feature of negative look behind so we have
+    # to do two replacement, first unescape everything, then re-escape it
+    def Ruby18.escape_paren( str )
+      re = /\\\)/
+      str = str.gsub(re) { |s| ')'}
+      re = /\\\(/
+      str = str.gsub(re) { |s| '('}
+      re = /([\(\)])/          # Only match unescaped parens
+      str.gsub(re) { |s| '\\' + s }
+    end
+    
+    def Ruby18.paren( str )
+      str = $1 if str =~ /^\((.*)?\)$/
+      str = escape_paren( str )
+      '(' + str + ')'
+    end
+    
+    def Ruby18.decode_base64(str)
+      Base64.decode64(str)
+    end
+    
+    def Ruby18.encode_base64(str)
+      Base64.encode64(str)
+    end
+    
+    def Ruby18.has_constant?(klass, string)
+      klass.constants.include?( string )
+    end
+    
+    def Ruby18.get_constant(klass, string)
+      klass.const_get( string )
+    end
+
+    def Ruby18.b_encode(str, encoding)
+      # Ruby 1.8 requires an encoding to work
+      raise ArgumentError, "Must supply an encoding" if encoding.nil?
+      return str if str.ascii_only?
+      encoding = encoding.to_s.upcase.gsub('_', '-')
+      string = Encodings::Base64.encode(str)
+      "=?#{encoding}?B?#{string.chomp}?="
+    end
+
+    def Ruby18.q_encode(str, encoding)
+      # Ruby 1.8 requires an encoding to work
+      raise ArgumentError, "Must supply an encoding" if encoding.nil?
+      return str if str.ascii_only?
+      encoding = encoding.to_s.upcase.gsub('_', '-')
+      string = Encodings::QuotedPrintable.encode(str)
+      "=?#{encoding}?Q?#{string.chomp}?="
+    end
+
+  end
+  
+  
+end

data/lib/mail/version_specific/ruby_1_8_string.rb

@@ -0,0 +1,88 @@
+# encoding: utf-8
+# :nodoc:
+# OK... serious code smell in here... I just took the whole multibyte_chars code out of 
+# ActiveSupport.... hacked it to fit... like a mallet bashing a square peg... the thing
+# fits in the hole... really!
+#
+# Bah... I'll get the first gem out and we'll fix this up.
+require File.join(File.dirname(__FILE__), 'multibyte')
+
+module Mail
+  
+  # Taken from Rails::Mail::Multibyte
+  module Multibyte
+    
+    unless '1.9'.respond_to?(:force_encoding)
+      # == Multibyte proxy
+      #
+      # +mb_chars+ is a multibyte safe proxy for string methods.
+      #
+      # In Ruby 1.8 and older it creates and returns an instance of the Mail::Multibyte::Chars class which
+      # encapsulates the original string. A Unicode safe version of all the String methods are defined on this proxy
+      # class. If the proxy class doesn't respond to a certain method, it's forwarded to the encapsuled string.
+      #
+      #   name = 'Claus Müller'
+      #   name.reverse  #=> "rell??M sualC"
+      #   name.length   #=> 13
+      #
+      #   name.mb_chars.reverse.to_s   #=> "rellüM sualC"
+      #   name.mb_chars.length         #=> 12
+      #
+      # In Ruby 1.9 and newer +mb_chars+ returns +self+ because String is (mostly) encoding aware. This means that
+      # it becomes easy to run one version of your code on multiple Ruby versions.
+      #
+      # == Method chaining
+      #
+      # All the methods on the Chars proxy which normally return a string will return a Chars object. This allows
+      # method chaining on the result of any of these methods.
+      #
+      #   name.mb_chars.reverse.length #=> 12
+      #
+      # == Interoperability and configuration
+      #
+      # The Chars object tries to be as interchangeable with String objects as possible: sorting and comparing between
+      # String and Char work like expected. The bang! methods change the internal string representation in the Chars
+      # object. Interoperability problems can be resolved easily with a +to_s+ call.
+      #
+      # For more information about the methods defined on the Chars proxy see Mail::Multibyte::Chars. For
+      # information about how to change the default Multibyte behaviour see Mail::Multibyte.
+      def mb_chars
+        if Mail::Multibyte.proxy_class.wants?(self)
+          Mail::Multibyte.proxy_class.new(self)
+        else
+          self
+        end
+      end
+      
+      # Returns true if the string has UTF-8 semantics (a String used for purely byte resources is unlikely to have
+      # them), returns false otherwise.
+      def is_utf8?
+        Mail::Multibyte::Chars.consumes?(self)
+      end
+
+      unless '1.8.7 and later'.respond_to?(:chars)
+        def chars
+          Mail::Deprecation.warn('String#chars has been deprecated in favor of String#mb_chars.', caller)
+          mb_chars
+        end
+      end
+      
+    else
+      def mb_chars #:nodoc
+        self
+      end
+      
+      def is_utf8? #:nodoc
+        case encoding
+        when Encoding::UTF_8
+          valid_encoding?
+        when Encoding::ASCII_8BIT, Encoding::US_ASCII
+          dup.force_encoding(Encoding::UTF_8).valid_encoding?
+        else
+          false
+        end
+      end
+    end
+  end
+
+end

data/lib/mail/version_specific/ruby_1_9.rb

@@ -0,0 +1,49 @@
+# encoding: utf-8
+module Mail
+  class Ruby19
+
+    # Escapes any parenthesis in a string that are unescaped this uses
+    # a Ruby 1.9.1 regexp feature of negative look behind
+    def Ruby19.escape_paren( str )
+      re = /(?<!\\)([\(\)])/          # Only match unescaped parens
+      str.gsub(re) { |s| '\\' + s }
+    end
+
+    def Ruby19.paren( str )
+      str = $1 if str =~ /^\((.*)?\)$/
+      str = escape_paren( str )
+      '(' + str + ')'
+    end
+    
+    def Ruby19.decode_base64(str)
+      str.unpack( 'm' ).first.force_encoding(Encoding::BINARY)
+    end
+    
+    def Ruby19.encode_base64(str)
+      [str].pack( 'm' )
+    end
+    
+    def Ruby19.has_constant?(klass, string)
+      klass.constants.include?( string.to_sym )
+    end
+    
+    def Ruby19.get_constant(klass, string)
+      klass.const_get( string.to_sym )
+    end
+    
+    def Ruby19.b_encode(str, encoding = nil)
+      return str if str.ascii_only?
+      encoding = str.encoding.to_s
+      string = Encodings::Base64.encode(str)
+      "=?#{encoding}?B?#{string.chomp}?="
+    end
+    
+    def Ruby19.q_encode(str, encoding = nil)
+      return str if str.ascii_only?
+      encoding = str.encoding.to_s
+      string = Encodings::QuotedPrintable.encode(str)
+      "=?#{encoding}?Q?#{string.chomp}?="
+    end
+
+  end
+end

metadata

@@ -0,0 +1,192 @@
+--- !ruby/object:Gem::Specification 
+name: mail
+version: !ruby/object:Gem::Version 
+  version: 1.0.0
+platform: ruby
+authors: 
+- Mikel Lindsaar
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-25 00:00:00 +11:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: treetop
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.4"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: mime-types
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: "1.0"
+    version: 
+- !ruby/object:Gem::Dependency 
+  name: rspec
+  type: :development
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.9
+    version: 
+description: A really Ruby Mail handler.
+email: raasdnil@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+files: 
+- ./.gitignore
+- ./Manifest.txt
+- ./README.rdoc
+- ./Rakefile
+- ./lib/mail.rb
+- ./lib/mail/attachment.rb
+- ./lib/mail/body.rb
+- ./lib/mail/configuration.rb
+- ./lib/mail/core_extensions/blank.rb
+- ./lib/mail/core_extensions/nil.rb
+- ./lib/mail/core_extensions/string.rb
+- ./lib/mail/core_extensions.rb
+- ./lib/mail/elements/address.rb
+- ./lib/mail/elements/address_list.rb
+- ./lib/mail/elements/content_disposition_element.rb
+- ./lib/mail/elements/content_transfer_encoding_element.rb
+- ./lib/mail/elements/content_type_element.rb
+- ./lib/mail/elements/date_time_element.rb
+- ./lib/mail/elements/envelope_from_element.rb
+- ./lib/mail/elements/message_ids_element.rb
+- ./lib/mail/elements/mime_version_element.rb
+- ./lib/mail/elements/phrase_list.rb
+- ./lib/mail/elements/received_element.rb
+- ./lib/mail/encodings/base64.rb
+- ./lib/mail/encodings/encodings.rb
+- ./lib/mail/encodings/quoted_printable.rb
+- ./lib/mail/envelope.rb
+- ./lib/mail/field.rb
+- ./lib/mail/field_list.rb
+- ./lib/mail/fields/bcc_field.rb
+- ./lib/mail/fields/cc_field.rb
+- ./lib/mail/fields/comments_field.rb
+- ./lib/mail/fields/common/common_address.rb
+- ./lib/mail/fields/common/common_date.rb
+- ./lib/mail/fields/common/common_field.rb
+- ./lib/mail/fields/common/common_message_id.rb
+- ./lib/mail/fields/content_description_field.rb
+- ./lib/mail/fields/content_disposition_field.rb
+- ./lib/mail/fields/content_id_field.rb
+- ./lib/mail/fields/content_transfer_encoding_field.rb
+- ./lib/mail/fields/content_type_field.rb
+- ./lib/mail/fields/date_field.rb
+- ./lib/mail/fields/from_field.rb
+- ./lib/mail/fields/in_reply_to_field.rb
+- ./lib/mail/fields/keywords_field.rb
+- ./lib/mail/fields/message_id_field.rb
+- ./lib/mail/fields/mime_version_field.rb
+- ./lib/mail/fields/optional_field.rb
+- ./lib/mail/fields/received_field.rb
+- ./lib/mail/fields/references_field.rb
+- ./lib/mail/fields/reply_to_field.rb
+- ./lib/mail/fields/resent_bcc_field.rb
+- ./lib/mail/fields/resent_cc_field.rb
+- ./lib/mail/fields/resent_date_field.rb
+- ./lib/mail/fields/resent_from_field.rb
+- ./lib/mail/fields/resent_message_id_field.rb
+- ./lib/mail/fields/resent_sender_field.rb
+- ./lib/mail/fields/resent_to_field.rb
+- ./lib/mail/fields/return_path_field.rb
+- ./lib/mail/fields/sender_field.rb
+- ./lib/mail/fields/structured_field.rb
+- ./lib/mail/fields/subject_field.rb
+- ./lib/mail/fields/to_field.rb
+- ./lib/mail/fields/unstructured_field.rb
+- ./lib/mail/header.rb
+- ./lib/mail/mail.rb
+- ./lib/mail/message.rb
+- ./lib/mail/network/deliverable.rb
+- ./lib/mail/network/retrievable.rb
+- ./lib/mail/parsers/address_lists.rb
+- ./lib/mail/parsers/address_lists.treetop
+- ./lib/mail/parsers/content_disposition.rb
+- ./lib/mail/parsers/content_disposition.treetop
+- ./lib/mail/parsers/content_transfer_encoding.rb
+- ./lib/mail/parsers/content_transfer_encoding.treetop
+- ./lib/mail/parsers/content_type.rb
+- ./lib/mail/parsers/content_type.treetop
+- ./lib/mail/parsers/date_time.rb
+- ./lib/mail/parsers/date_time.treetop
+- ./lib/mail/parsers/envelope_from.rb
+- ./lib/mail/parsers/envelope_from.treetop
+- ./lib/mail/parsers/message_ids.rb
+- ./lib/mail/parsers/message_ids.treetop
+- ./lib/mail/parsers/mime_version.rb
+- ./lib/mail/parsers/mime_version.treetop
+- ./lib/mail/parsers/phrase_lists.rb
+- ./lib/mail/parsers/phrase_lists.treetop
+- ./lib/mail/parsers/received.rb
+- ./lib/mail/parsers/received.treetop
+- ./lib/mail/parsers/rfc2045.rb
+- ./lib/mail/parsers/rfc2045.treetop
+- ./lib/mail/parsers/rfc2822.rb
+- ./lib/mail/parsers/rfc2822.treetop
+- ./lib/mail/parsers/rfc2822_obsolete.rb
+- ./lib/mail/parsers/rfc2822_obsolete.treetop
+- ./lib/mail/part.rb
+- ./lib/mail/patterns.rb
+- ./lib/mail/utilities.rb
+- ./lib/mail/version.rb
+- ./lib/mail/version_specific/ruby_1_8.rb
+- ./lib/mail/version_specific/ruby_1_8_string.rb
+- ./lib/mail/version_specific/ruby_1_9.rb
+- ./lib/mail/version_specific/multibyte.rb
+- ./lib/mail/version_specific/multibyte/chars.rb
+- ./lib/mail/version_specific/multibyte/exceptions.rb
+- ./lib/mail/version_specific/multibyte/unicode_database.rb
+- README.rdoc
+has_rdoc: true
+homepage: http://github.com/mikel/mail
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: 1.2.0
+  version: 
+requirements: 
+- treetop, Treetop is a Ruby-based DSL for text parsing and interpretation
+- mime/types, A list of a lot of Mime Types
+- tlsmail, Used for encrypted SMTP, only if you are on RUBY_VERSION <= 1.8.6
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Mail provides a nice Ruby DSL for making, sending and reading emails.
+test_files: []
+