mail 2.6.4 → 2.8.0

data/CONTRIBUTING.md

@@ -1,60 +0,0 @@
-Contributing to Mail
-====================
-
-Hi there, I welcome pull requests!  Here are some thoughts on how to get your
-pull request merged quickly:
-
-1. Check the Reference RFCs, they are in the References directory, so no excuses.
-2. Check for a ticket on GitHub, maybe someone else has the problem too
-3. Make a fork of my GitHub repository
-4. Run the specs. We only take pull requests with passing tests, and it's great
-   to know that you have a clean slate: `bundle && bundle exec rake`
-5. Add a spec for your change. Only refactoring and documentation changes
-   require no new specs. If you are adding functionality or fixing a bug, we need
-   a spec!
-6. Test the spec _at_ _least_ against MRI-1.9.3 and MRI-1.8.7
-7. Update the README if needed to reflect your change / addition
-8. Update the CHANGELOG and give yourself credit
-9. With all specs passing push your changes back to your fork
-10. Send me a pull request.
-  - If it needs any changes, please push or force push to the same branch you made the pull request from.  GitHub will just update the pull request with your changes.
-
-Note, specs that break MRI 1.8.7 or 1.9.3 will not be accepted.
-
-At this point you're waiting on us. We like to at least comment on, if not
-accept, pull requests within three business days (and, typically, one business
-day). We may suggest some changes or improvements or alternatives.
-
-Some things that will increase the chance that your pull request is accepted,
-taken straight from the Ruby on Rails guide:
-
-* Tell me you have tested it against more than one version of Ruby, RVM is great for
-  this. I test against 7 rubies before I push into master.
-* Use good, idiomatic, structured and modular code
-* Include tests that fail without your code, and pass with it
-* Update the documentation, the surrounding one, examples elsewhere, guides,
-  whatever is affected by your contribution
-
-Syntax:
-
-* Two spaces, no tabs.
-* No trailing whitespace. Blank lines should not have any space.
-* Prefer &&/|| over and/or.
-* MyClass.my_method(my_arg) not my_method( my_arg ) or my_method my_arg.
-* a = b and not a=b.
-* Follow the conventions you see used in the source already.
-
-And in case we didn't emphasize it enough: we love specs!
-
-### Testing against mime-types versions:
-
-Use [appraisal](https://github.com/thoughtbot/appraisal) to run against all supported versions of mime-types.
-
-1. Run `(bundle check || bundle) && appraisal` so that all the 'appraised' gemfiles are bundled.
-2. Run either `appraisal rake` or `rake appraisal` to run all the tests.
-
-To run only one 'appraised' gemfile, run. e.g. `BUNDLE_GEMFILE=gemfiles/mime_types_edge.gemfile (bundle check || bundle) && rake`
-
-To change the appraisals, modify the `Appraisals` file, run `appraisal`, commit the generated gemfiles, and modify the .travis.yml matrix.
-
-To run on all rubies / gemfiles, just like TravisCI, see [WWTD](https://github.com/grosser/wwtd).

data/Dependencies.txt

@@ -1,2 +0,0 @@
-tlsmail: if ruby < 1.8.6... we could make it optional, or embed it in Mail
-mime/types: I think we embed a simplified version, or help maintain it, it is old (2006)

data/Gemfile

@@ -1,11 +0,0 @@
-source "https://rubygems.org"
-
-gemspec
-
-gem "tlsmail", "~> 0.0.1" if RUBY_VERSION <= "1.8.6"
-gem "jruby-openssl", :platforms => :jruby
-
-# For gems not required to run tests
-group :local_development, :test do
-  gem "appraisal", "~> 1.0" unless RUBY_VERSION <= "1.8.7"
-end

data/Rakefile

@@ -1,29 +0,0 @@
-if !ENV["APPRAISAL_INITIALIZED"] && !ENV["TRAVIS"]
-  ENV['BUNDLE_GEMFILE'] ||= File.expand_path('../Gemfile', __FILE__)
-end
-require 'rubygems'
-require 'bundler/setup'
-
-require 'rake/testtask'
-require 'rspec/core/rake_task'
-
-desc "Build a gem file"
-task :build do
-  system "gem build mail.gemspec"
-end
-
-task :default => :spec
-
-RSpec::Core::RakeTask.new(:spec) do |t|
-  t.ruby_opts = '-w'
-  t.rspec_opts = %w(--backtrace --color)
-end
-
-begin
-  require "appraisal"
-rescue LoadError, SyntaxError
-  warn "Appraisal is only available in test/development on Ruby 1.9+"
-end
-
-# load custom rake tasks
-Dir["#{File.dirname(__FILE__)}/tasks/**/*.rake"].sort.each { |ext| load ext }

data/TODO.rdoc

@@ -1,9 +0,0 @@
-== Not really in any order:
-
-* Add multibyte handling to fields, if they get a multibyte string, try encoding it into 
-  UTF-8 B first, if this fails, throw an error.
-
-* Cleanup the treetop parsers......... do I _really_ need that many entrance files?
-
-* Simplify the relationship of Headers and Fields.  Doing too much of the Field work
-  in the Header class on instantiating fields.  Header should just say "Field, do it!"

data/lib/mail/core_extensions/smtp.rb

@@ -1,25 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-module Net
-  class SMTP
-    # This is a backport of r30294 from ruby trunk because of a bug in net/smtp.
-    # http://svn.ruby-lang.org/cgi-bin/viewvc.cgi?view=rev&revision=30294
-    #
-    # Fixed in what will be Ruby 1.9.3 - tlsconnect also does not exist in some early versions of ruby
-    begin
-      alias_method :original_tlsconnect, :tlsconnect
-
-      def tlsconnect(s)
-        verified = false
-        begin
-          original_tlsconnect(s).tap { verified = true }
-        ensure
-          unless verified
-            s.close rescue nil
-          end
-        end
-      end
-    rescue NameError
-    end
-  end
-end

data/lib/mail/core_extensions/string/access.rb

@@ -1,146 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-
-# This is not loaded if ActiveSupport is already loaded
-
-# This is an almost cut and paste from ActiveSupport v3.0.6, copied in here so that Mail
-# itself does not depend on ActiveSupport to avoid versioning conflicts
-
-class String
-  unless '1.9'.respond_to?(:force_encoding)
-    # Returns the character at the +position+ treating the string as an array (where 0 is the first character).
-    #
-    # Examples:
-    #   "hello".at(0)  # => "h"
-    #   "hello".at(4)  # => "o"
-    #   "hello".at(10) # => ERROR if < 1.9, nil in 1.9
-    def at(position)
-      mb_chars[position, 1].to_s
-    end
-
-    # Returns the remaining of the string from the +position+ treating the string as an array (where 0 is the first character).
-    #
-    # Examples:
-    #   "hello".from(0)  # => "hello"
-    #   "hello".from(2)  # => "llo"
-    #   "hello".from(10) # => "" if < 1.9, nil in 1.9
-    def from(position)
-      mb_chars[position..-1].to_s
-    end
-
-    # Returns the beginning of the string up to the +position+ treating the string as an array (where 0 is the first character).
-    #
-    # Examples:
-    #   "hello".to(0)  # => "h"
-    #   "hello".to(2)  # => "hel"
-    #   "hello".to(10) # => "hello"
-    def to(position)
-      mb_chars[0..position].to_s
-    end
-
-    # Returns the first character of the string or the first +limit+ characters.
-    #
-    # Examples:
-    #   "hello".first     # => "h"
-    #   "hello".first(2)  # => "he"
-    #   "hello".first(10) # => "hello"
-    def first(limit = 1)
-      if limit == 0
-        ''
-      elsif limit >= size
-        self
-      else
-        mb_chars[0...limit].to_s
-      end
-    end
-
-    # Returns the last character of the string or the last +limit+ characters.
-    #
-    # Examples:
-    #   "hello".last     # => "o"
-    #   "hello".last(2)  # => "lo"
-    #   "hello".last(10) # => "hello"
-    def last(limit = 1)
-      if limit == 0
-        ''
-      elsif limit >= size
-        self
-      else
-        mb_chars[(-limit)..-1].to_s
-      end
-    end
-  else
-    def at(position)
-      self[position]
-    end
-
-    def from(position)
-      self[position..-1]
-    end
-
-    def to(position)
-      self[0..position]
-    end
-
-    def first(limit = 1)
-      if limit == 0
-        ''
-      elsif limit >= size
-        self
-      else
-        to(limit - 1)
-      end
-    end
-
-    def last(limit = 1)
-      if limit == 0
-        ''
-      elsif limit >= size
-        self
-      else
-        from(-limit)
-      end
-    end
-  end
-
-  if Module.method(:const_get).arity == 1
-    # Tries to find a constant with the name specified in the argument string:
-    #
-    #   "Module".constantize     # => Module
-    #   "Test::Unit".constantize # => Test::Unit
-    #
-    # The name is assumed to be the one of a top-level constant, no matter whether
-    # it starts with "::" or not. No lexical context is taken into account:
-    #
-    #   C = 'outside'
-    #   module M
-    #     C = 'inside'
-    #     C               # => 'inside'
-    #     "C".constantize # => 'outside', same as ::C
-    #   end
-    #
-    # NameError is raised when the name is not in CamelCase or the constant is
-    # unknown.
-    def constantize
-      names = self.split('::')
-      names.shift if names.empty? || names.first.empty?
-
-      constant = Object
-      names.each do |name|
-        constant = constant.const_defined?(name) ? constant.const_get(name) : constant.const_missing(name)
-      end
-      constant
-    end
-  else
-    def constantize #:nodoc:
-      names = self.split('::')
-      names.shift if names.empty? || names.first.empty?
-
-      constant = Object
-      names.each do |name|
-        constant = constant.const_defined?(name, false) ? constant.const_get(name) : constant.const_missing(name)
-      end
-      constant
-    end
-  end
-end

data/lib/mail/core_extensions/string/multibyte.rb

@@ -1,79 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-
-# This is not loaded if ActiveSupport is already loaded
-
-# This is an almost cut and paste from ActiveSupport v3.0.6, copied in here so that Mail
-# itself does not depend on ActiveSupport to avoid versioning conflicts
-
-require 'mail/multibyte'
-
-class String
-  if RUBY_VERSION >= "1.9"
-    # == 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.consumes?(self)
-        Mail::Multibyte.proxy_class.new(self)
-      else
-        self
-      end
-    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
-  else
-    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
-  end
-end

data/lib/mail/core_extensions/string.rb

@@ -1,21 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-class String #:nodoc:
-
-  unless method_defined?(:ascii_only?)
-    # Backport from Ruby 1.9 checks for non-us-ascii characters.
-    def ascii_only?
-      self !~ MATCH_NON_US_ASCII
-    end
-
-    MATCH_NON_US_ASCII = /[^\x00-\x7f]/
-  end
-
-  def not_ascii_only?
-    !ascii_only?
-  end
-
-  unless method_defined?(:bytesize)
-    alias :bytesize :length
-  end
-end

data/lib/mail/fields/common/address_container.rb

@@ -1,17 +0,0 @@
-# frozen_string_literal: true
-module Mail
-  
-  class AddressContainer < Array
-    
-    def initialize(field, list = [])
-      @field = field
-      super(list)
-    end
-
-    def << (address)
-      @field << address
-    end
-
-  end
-  
-end

data/lib/mail/fields/common/common_address.rb

@@ -1,136 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-require 'mail/fields/common/address_container'
-
-module Mail
-  module CommonAddress # :nodoc:
-      
-    def parse(val = value)
-      unless Utilities.blank?(val)
-        @address_list = AddressList.new(encode_if_needed(val))
-      else
-        nil
-      end
-    end
-    
-    def charset
-      @charset
-    end
-    
-    def encode_if_needed(val)
-      Encodings.address_encode(val, charset)
-    end
-    
-    # Allows you to iterate through each address object in the address_list
-    def each
-      address_list.addresses.each do |address|
-        yield(address)
-      end
-    end
-
-    # Returns the address string of all the addresses in the address list
-    def addresses
-      list = address_list.addresses.map { |a| a.address }
-      Mail::AddressContainer.new(self, list)
-    end
-
-    # Returns the formatted string of all the addresses in the address list
-    def formatted
-      list = address_list.addresses.map { |a| a.format }
-      Mail::AddressContainer.new(self, list)
-    end
-  
-    # Returns the display name of all the addresses in the address list
-    def display_names
-      list = address_list.addresses.map { |a| a.display_name }
-      Mail::AddressContainer.new(self, list)
-    end
-  
-    # Returns the actual address objects in the address list
-    def addrs
-      list = address_list.addresses
-      Mail::AddressContainer.new(self, list)
-    end
-  
-    # Returns a hash of group name => address strings for the address list
-    def groups
-      address_list.addresses_grouped_by_group
-    end
-  
-    # Returns the addresses that are part of groups
-    def group_addresses
-      decoded_group_addresses
-    end
-
-    # Returns a list of decoded group addresses
-    def decoded_group_addresses
-      groups.map { |k,v| v.map { |a| a.decoded } }.flatten
-    end
-
-    # Returns a list of encoded group addresses
-    def encoded_group_addresses
-      groups.map { |k,v| v.map { |a| a.encoded } }.flatten
-    end
-
-    # Returns the name of all the groups in a string
-    def group_names # :nodoc:
-      address_list.group_names
-    end
-  
-    def default
-      addresses
-    end
-
-    def <<(val)
-      case
-      when val.nil?
-        raise ArgumentError, "Need to pass an address to <<"
-      when Utilities.blank?(val)
-        parse(encoded)
-      else
-        self.value = [self.value, val].reject {|a| Utilities.blank?(a) }.join(", ")
-      end
-    end
-
-    def value=(val)
-      super
-      parse(self.value)
-    end
-  
-    private
-  
-    def do_encode(field_name)
-      return '' if Utilities.blank?(value)
-      address_array = address_list.addresses.reject { |a| encoded_group_addresses.include?(a.encoded) }.compact.map { |a| a.encoded }
-      address_text  = address_array.join(", \r\n\s")
-      group_array = groups.map { |k,v| "#{k}: #{v.map { |a| a.encoded }.join(", \r\n\s")};" }
-      group_text  = group_array.join(" \r\n\s")
-      return_array = [address_text, group_text].reject { |a| Utilities.blank?(a) }
-      "#{field_name}: #{return_array.join(", \r\n\s")}\r\n"
-    end
-
-    def do_decode
-      return nil if Utilities.blank?(value)
-      address_array = address_list.addresses.reject { |a| decoded_group_addresses.include?(a.decoded) }.map { |a| a.decoded }
-      address_text  = address_array.join(", ")
-      group_array = groups.map { |k,v| "#{k}: #{v.map { |a| a.decoded }.join(", ")};" }
-      group_text  = group_array.join(" ")
-      return_array = [address_text, group_text].reject { |a| Utilities.blank?(a) }
-      return_array.join(", ")
-    end
-
-    def address_list # :nodoc:
-      @address_list ||= AddressList.new(value)
-    end
-  
-    def get_group_addresses(group_list)
-      if group_list.respond_to?(:addresses)
-        group_list.addresses.map do |address|
-          Mail::Address.new(address)
-        end
-      else
-        []
-      end
-    end
-  end
-end

data/lib/mail/fields/common/common_date.rb

@@ -1,36 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-module Mail
-  module CommonDate # :nodoc:
-    # Returns a date time object of the parsed date
-    def date_time
-      ::DateTime.parse("#{element.date_string} #{element.time_string}")
-    end
-
-    def default
-      date_time
-    end
-    
-    def parse(val = value)
-      unless Utilities.blank?(val)
-        @element = Mail::DateTimeElement.new(val)
-      else
-        nil
-      end
-    end
-
-    private
-    
-    def do_encode(field_name)
-      "#{field_name}: #{value}\r\n"
-    end
-    
-    def do_decode
-      "#{value}"
-    end
-
-    def element
-      @element ||= Mail::DateTimeElement.new(value)
-    end
-  end
-end

data/lib/mail/fields/common/common_field.rb

@@ -1,61 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-module Mail
-  module CommonField # :nodoc:
-    include Mail::Constants
-
-    def name=(value)
-      @name = value
-    end
-
-    def name
-      @name ||= nil
-    end
-
-    def value=(value)
-      @length = nil
-      @tree = nil
-      @element = nil
-      @value = value
-    end
-
-    def value
-      @value
-    end
-
-    def to_s
-      decoded.to_s
-    end
-
-    def default
-      decoded
-    end
-
-    def field_length
-      @length ||= "#{name}: #{encode(decoded)}".length
-    end
-
-    def responsible_for?( val )
-      name.to_s.casecmp(val.to_s) == 0
-    end
-
-    private
-
-    def strip_field(field_name, value)
-      if value.is_a?(Array)
-        value
-      else
-        value.to_s.sub(/\A#{field_name}:\s+/i, EMPTY)
-      end
-    end
-
-    FILENAME_RE = /\b(filename|name)=([^;"\r\n]+\s[^;"\r\n]+)/
-    def ensure_filename_quoted(value)
-      if value.is_a?(String)
-        value.sub FILENAME_RE, '\1="\2"'
-      else
-        value
-      end
-    end
-  end
-end

data/lib/mail/fields/common/common_message_id.rb

@@ -1,49 +0,0 @@
-# encoding: utf-8
-# frozen_string_literal: true
-module Mail
-  module CommonMessageId # :nodoc:
-    def element
-      @element ||= Mail::MessageIdsElement.new(value) unless Utilities.blank?(value)
-    end
-
-    def parse(val = value)
-      unless Utilities.blank?(val)
-        @element = Mail::MessageIdsElement.new(val)
-      else
-        nil
-      end
-    end
-    
-    def message_id
-      element.message_id if element
-    end
-    
-    def message_ids
-      element.message_ids if element
-    end
-    
-    def default
-      return nil unless message_ids
-      if message_ids.length == 1
-        message_ids[0]
-      else
-        message_ids
-      end
-    end
-
-    private
-
-    def do_encode(field_name)
-      %Q{#{field_name}: #{formated_message_ids("\r\n ")}\r\n}
-    end
-
-    def do_decode
-      formated_message_ids(' ')
-    end
-
-    def formated_message_ids(join)
-      message_ids.map{ |m| "<#{m}>" }.join(join) if message_ids
-    end
-
-  end
-end