mail 2.6.6 → 2.7.1

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,14 +0,0 @@
-source 'https://rubygems.org'
-
-gemspec
-
-gem 'tlsmail', '~> 0.0.1' if RUBY_VERSION <= '1.8.6'
-gem 'jruby-openssl', :platforms => :jruby
-gem 'rake', '< 11.0', :platforms => :ruby_18
-gem 'rdoc', '< 4.3', :platforms => [ :ruby_18, :ruby_19 ]
-gem 'mime-types', '< 2.0', :platforms => [ :ruby_18, :ruby_19 ]
-
-# For gems not required to run tests
-group :local_development, :test do
-  gem 'appraisal', '~> 1.0' unless RUBY_VERSION < '1.9'
-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/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/multibyte/exceptions.rb

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

data/lib/mail/parsers/ragel/common.rl

@@ -1,185 +0,0 @@
-%%{
-
-  machine common;
-
-  action comment_begin { fcall comment_tail; }
-  action comment_exit { fret; }
-
-  # RFC5322: address_lists, date_time, message_ids, phrase_lists, received
-
-  obs_NO_WS_CTL = 0x01..0x08 | 0x0b | 0x0c | 0x0e..0x1f | 0x7f;
-  LF = "\n";
-  CR = "\r";
-  CRLF = "\r\n";
-  WSP = 0x09 | 0x20;
-  obs_ctext = obs_NO_WS_CTL;
-  VCHAR = 0x21..0x7e;
-  obs_qp = "\\" (0x00 | obs_NO_WS_CTL | LF | CR);
-  obs_FWS = (CRLF? WSP)+;
-  ctext = 0x21..0x27 | 0x2a..0x5b | 0x5d..0x7e | obs_ctext;
-  quoted_pair = ("\\" (VCHAR | WSP)) | obs_qp;
-  FWS = (WSP* CRLF WSP+) | (CRLF WSP+) | obs_FWS;
-  ALPHA = [a-zA-Z];
-  DIGIT = [0-9];
-  DQUOTE = '"';
-  obs_qtext = obs_NO_WS_CTL;
-  atext = ALPHA | DIGIT | "!" | "#" | "$" | "%" | "&" |
-          "'" | "*" | "+" | "-" | "/" | "=" | "?" | "^" |
-          "_" | "`" | "{" | "|" | "}" | "~";
-  qtext = 0x21 | 0x23..0x5b | 0x5d..0x7e | obs_qtext;
-  obs_dtext = obs_NO_WS_CTL | quoted_pair;
-  qcontent = qtext | quoted_pair;
-
-  # Handle recursive comments
-  ccontent = ctext | quoted_pair | "(" @comment_begin;
-  comment_tail := ((FWS? ccontent)* >comment_s) FWS? ")" @comment_exit;
-  comment = "(" @comment_begin %comment_e;
-  CFWS = ((FWS? comment)+ FWS?) | FWS;
-
-  quoted_string = CFWS?
-                  (DQUOTE
-                    (((FWS? qcontent)* FWS?) >qstr_s %qstr_e)
-                  DQUOTE)
-                  CFWS?;
-
-  atom = CFWS? atext+ CFWS?;
-  word = atom | quoted_string;
-
-  # phrase_lists
-  obs_phrase = (word | "." | "@")+;
-  phrase = (obs_phrase | word+) >phrase_s %phrase_e;
-  phrase_lists = phrase ("," FWS* phrase)*;
-
-  # address_lists
-
-  # local_part:
-  domain_text = (DQUOTE (FWS? qcontent)+ FWS? DQUOTE) | atext+;
-  local_dot_atom_text = ("."* domain_text "."*)+;
-  local_dot_atom = CFWS?
-                   (local_dot_atom_text >local_dot_atom_s %local_dot_atom_pre_comment_e)
-                   CFWS?;
-  obs_local_part = word ("." word)*;
-  local_part = (local_dot_atom >local_dot_atom_s %local_dot_atom_e |
-                (quoted_string %local_quoted_string_e) |
-                obs_local_part);
-
-  # Treetop parser behavior was to ignore addresses missing '@' inside of angle
-  # brackets. This construction preserves that behavior.
-  local_part_no_capture = (local_dot_atom | quoted_string | obs_local_part);
-
-  # domain:
-  dot_atom_text = "."* domain_text ("."* domain_text)*;
-  dtext = 0x21..0x5a | 0x5e..0x7e | obs_dtext;
-  dot_atom = CFWS? dot_atom_text (CFWS? >(comment_after_address,1));
-  domain_literal = CFWS? "[" (FWS? dtext)* FWS? "]" CFWS?;
-  obs_domain = atom ("." atom)*;
-  domain = (dot_atom | domain_literal | obs_domain) >domain_s %domain_e;
-
-  # addr_spec:
-
-  # The %(end_addr,N) priority resolves uncertainty when whitespace
-  # after an addr_spec could cause it to be interpreted as a
-  # display name: "bar@example.com ,..."
-
-  addr_spec_in_angle_brackets =
-    (local_part "@" domain) %(end_addr,1) |
-    local_part_no_capture   %(end_addr,0);
-
-  addr_spec_no_angle_brackets =
-    (local_part "@" domain) %(end_addr,1) |
-    local_part              %(end_addr,0);
-
-  # angle_addr:
-  obs_domain_list = (CFWS | ",")* "@" domain ("," CFWS? ("@" domain)?)*;
-  obs_route = (obs_domain_list ":") >obs_domain_list_s %obs_domain_list_e;
-  obs_angle_addr = CFWS? "<" obs_route? addr_spec_in_angle_brackets ">" CFWS?;
-
-  angle_addr = CFWS? ("<" >angle_addr_s) addr_spec_in_angle_brackets ">" CFWS? |
-                obs_angle_addr;
-
-  # Address
-  display_name = phrase;
-  name_addr = display_name? %(end_addr,2) angle_addr;
-  mailbox = (name_addr | addr_spec_no_angle_brackets) >address_s %address_e;
-  obs_mbox_list = (CFWS? ",")* mailbox ("," (mailbox | CFWS)?)*;
-  mailbox_list = (mailbox (("," | ";") mailbox)*) | obs_mbox_list;
-  obs_group_list = (CFWS? ",")+ CFWS?;
-  group_list = mailbox_list | CFWS | obs_group_list;
-  group = (display_name >group_name_s %group_name_e) ":"
-            (group_list?) ";" CFWS?;
-  address = group | mailbox;
-  #obs_addr_list = (CFWS? ",")* address ("," (address | CFWS)?)*;
-  address_lists = address? %(comment_after_address,0)
-                  (FWS* ("," | ";") FWS* address?)*;
-
-  # message_ids
-  obs_id_left = local_part;
-  id_left = dot_atom_text | obs_id_left;
-  # id_right modifications to support multiple '@' in msg_id.
-  msg_id_atext = ALPHA | DIGIT | "!" | "#" | "$" | "%" | "&" | "'" | "*" |
-                 "+" | "-" | "/" | "=" | "?" | "^" | "_" | "`" | "{" | "|" |
-                 "}" | "~" | "@";
-  msg_id_dot_atom_text = (msg_id_atext+ "."?)+;
-  obs_id_right = domain;
-  no_fold_literal = "[" (dtext)* "]";
-  id_right = msg_id_dot_atom_text | no_fold_literal | obs_id_right;
-  msg_id = (CFWS)?
-           (("<" id_left "@" id_right ">") >msg_id_s %msg_id_e)
-           (CFWS)?;
-  message_ids = msg_id (CFWS? msg_id)*;
-
-  include date_time "date_time.rl";
-  date_time = (day_of_week ",")?
-              (date >date_s %date_e) <: (time >time_s %time_e) CFWS?;
-
-  # Added CFWS? to increase robustness
-  # (qmail likes to include a comment style string...?)
-  received_token = word | angle_addr | addr_spec_no_angle_brackets | domain;
-  received = ((CFWS? received_token*) >received_tokens_s %received_tokens_e)
-              ";" date_time;
-
-  # RFC2045: mime_version, content_type, content_transfer_encoding
-  mime_version = CFWS?
-            (DIGIT+ >major_digits_s %major_digits_e)
-            comment? "." comment?
-            (DIGIT+ >minor_digits_s %minor_digits_e)
-            CFWS?;
-
-  token = 0x21..0x27 | 0x2a..0x2b | 0x2c..0x2e |
-          0x30..0x39 | 0x41..0x5a | 0x5e..0x7e;
-  value = (quoted_string | (token -- '"' | 0x3d)+) >param_val_s %param_val_e;
-  attribute = (token+) >param_attr_s %param_attr_e;
-  parameter = CFWS? attribute "=" value CFWS?;
-
-  ietf_token = token+;
-  custom_x_token = 'x'i "-" token+;
-  extension_token = ietf_token | custom_x_token;
-  discrete_type = 'text'i | 'image'i | 'audio'i | 'video'i |
-                  'application'i | extension_token;
-  composite_type = 'message'i | 'multipart'i | extension_token;
-  iana_token = token+;
-  main_type = (discrete_type | composite_type) >main_type_s %main_type_e;
-  sub_type = (extension_token | iana_token) >sub_type_s %sub_type_e;
-  content_type = main_type "/" sub_type (((CFWS? ";"+) | CFWS) parameter CFWS?)*;
-
-  encoding = ('7bits' | '8bits' | '7bit' | '8bit' | 'binary' |
-              'quoted-printable' | 'base64' | ietf_token |
-              custom_x_token) >encoding_s %encoding_e;
-  content_transfer_encoding = CFWS? encoding CFWS? ";"? CFWS?;
-
-  # RFC2183: content_disposition
-  # TODO: recognize filename, size, creation date, etc.
-  disposition_type = 'inline'i | 'attachment'i | extension_token | '';
-  content_disposition = (disposition_type >disp_type_s %disp_type_e)
-                        (CFWS? ";" parameter CFWS?)*;
-
-  # Envelope From
-  ctime_date = day_name " "+ month " "+ day " " time_of_day " " year;
-  null_sender = ('<>' ' '{0,1});
-  envelope_from = (addr_spec_no_angle_brackets | null_sender) >address_s %address_e " "
-                  (ctime_date >ctime_date_s %ctime_date_e);
-
-  # content_location
-  location = quoted_string | ((token | 0x3d)+ >token_string_s %token_string_e);
-  content_location = CFWS? location CFWS?;
-}%%

data/lib/mail/parsers/ragel/parser_info.rb

@@ -1,61 +0,0 @@
-module Mail
-  module Parsers
-    module Ragel
-      ACTIONS = [
-       :addr_spec,
-       :address_e,
-       :address_s,
-       :angle_addr_s,
-       :comment_e,
-       :comment_s,
-       :ctime_date_e,
-       :ctime_date_s,
-       :date_e,
-       :date_s,
-       :disp_type_e,
-       :disp_type_s,
-       :domain_e,
-       :domain_s,
-       :encoding_e,
-       :encoding_s,
-       :group_name_e,
-       :group_name_s,
-       :local_dot_atom_e,
-       :local_dot_atom_pre_comment_e,
-       :local_dot_atom_s,
-       :local_quoted_string_e,
-       :main_type_e,
-       :main_type_s,
-       :major_digits_e,
-       :major_digits_s,
-       :minor_digits_e,
-       :minor_digits_s,
-       :msg_id_e,
-       :msg_id_s,
-       :obs_domain_list_e,
-       :obs_domain_list_s,
-       :param_attr_e,
-       :param_attr_s,
-       :param_val_e,
-       :param_val_s,
-       :phrase_e,
-       :phrase_s,
-       :qstr_e,
-       :qstr_s,
-       :received_tokens_e,
-       :received_tokens_s,
-       :sub_type_e,
-       :sub_type_s,
-       :time_e,
-       :time_s,
-       :token_string_e,
-       :token_string_s
-      ]
-
-      FIELD_PARSERS = %w[ address_lists phrase_lists
-                          date_time received message_ids envelope_from
-                          mime_version content_type content_disposition
-                          content_transfer_encoding content_location ]
-    end
-  end
-end