# class Mail::Ruby19

### Attributes

charset_encoder[RW]

### Public Class Methods

b_value_decode(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 87
    def Ruby19.b_value_decode(str)
      match = str.match(/\=\?(.+)?\?[Bb]\?(.*)\?\=/m)
      if match
        charset = match[1]
        str = Ruby19.decode_base64(match[2])
        str = charset_encoder.encode(str, charset)
      end
      decoded = str.encode(Encoding::UTF_8, :invalid => :replace, :replace => "")
      decoded.valid_encoding? ? decoded : decoded.encode(Encoding::UTF_16LE, :invalid => :replace, :replace => "").encode(Encoding::UTF_8)
    rescue Encoding::UndefinedConversionError, ArgumentError, Encoding::ConverterNotFoundError
      warn "Encoding conversion failed #{$!}"
      str.dup.force_encoding(Encoding::UTF_8)
    end

b_value_encode(str, encoding = nil) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 82
    def Ruby19.b_value_encode(str, encoding = nil)
      encoding = str.encoding.to_s
      [Ruby19.encode_base64(str), encoding]
    end

bracket( str ) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 53
    def Ruby19.bracket( str )
      str = $1 if str =~ /^\<(.*)?\>$/
      str = escape_bracket( str )
      '<' + str + '>'
    end

decode_base64(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 59
    def Ruby19.decode_base64(str)
      if !str.end_with?("=") && str.length % 4 != 0
        str = str.ljust((str.length + 3) & ~3, "=")
      end
      str.unpack( 'm' ).first
    end

encode_base64(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 66
    def Ruby19.encode_base64(str)
      [str].pack( 'm' )
    end

escape_bracket( str ) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 48
    def Ruby19.escape_bracket( str )
      re = /(?<!\)([\<\>])/          # Only match unescaped brackets
      str.gsub(re) { |s| '\' + s }
    end

escape_paren( str ) click to toggle source

Escapes any parenthesis in a string that are unescaped this uses a Ruby 1.9.1 regexp feature of negative look behind

    # File lib/mail/version_specific/ruby_1_9.rb, line 37
    def Ruby19.escape_paren( str )
      re = /(?<!\)([\(\)])/          # Only match unescaped parens
      str.gsub(re) { |s| '\' + s }
    end

get_constant(klass, string) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 74
    def Ruby19.get_constant(klass, string)
      klass.const_get( string )
    end

has_constant?(klass, string) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 70
    def Ruby19.has_constant?(klass, string)
      klass.const_defined?( string, false )
    end

param_decode(str, encoding) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 126
    def Ruby19.param_decode(str, encoding)
      str = uri_parser.unescape(str)
      str = charset_encoder.encode(str, encoding) if encoding
      str
    end

param_encode(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 132
    def Ruby19.param_encode(str)
      encoding = str.encoding.to_s.downcase
      language = Configuration.instance.param_encode_language
      "#{encoding}'#{language}'#{uri_parser.escape(str)}"
    end

paren( str ) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 42
    def Ruby19.paren( str )
      str = $1 if str =~ /^\((.*)?\)$/
      str = escape_paren( str )
      '(' + str + ')'
    end

pick_encoding(charset) click to toggle source

Pick a Ruby encoding corresponding to the message charset. Most charsets have a Ruby encoding, but some need manual aliasing here.

TODO: add this as a test somewhere:

    Encoding.list.map { |e| [e.to_s.upcase == pick_encoding(e.to_s.downcase.gsub("-", "")), e.to_s] }.select {|a,b| !b}
    Encoding.list.map { |e| [e.to_s == pick_encoding(e.to_s), e.to_s] }.select {|a,b| !b}

    # File lib/mail/version_specific/ruby_1_9.rb, line 148
    def Ruby19.pick_encoding(charset)
      charset = charset.to_s
      encoding = case charset.downcase

      # ISO-8859-8-I etc. http://en.wikipedia.org/wiki/ISO-8859-8-I
      when /^iso[-_]?8859-(\d+)(-i)?$/
        "ISO-8859-#{$1}"

      # ISO-8859-15, ISO-2022-JP and alike
      when /^iso[-_]?(\d{4})-?(\w{1,2})$/
        "ISO-#{$1}-#{$2}"

      # "ISO-2022-JP-KDDI"  and alike
      when /^iso[-_]?(\d{4})-?(\w{1,2})-?(\w*)$/
        "ISO-#{$1}-#{$2}-#{$3}"

      # UTF-8, UTF-32BE and alike
      when /^utf[\-_]?(\d{1,2})?(\w{1,2})$/
        "UTF-#{$1}#{$2}".gsub(/\A(UTF-(?:16|32))\z/, '\1BE')

      # Windows-1252 and alike
      when /^windows-?(.*)$/
        "Windows-#{$1}"

      when '8bit'
        Encoding::ASCII_8BIT

      # alternatives/misspellings of us-ascii seen in the wild
      when /^iso[-_]?646(-us)?$/, 'us=ascii'
        Encoding::ASCII

      # Microsoft-specific alias for MACROMAN
      when 'macintosh'
        Encoding::MACROMAN

      # Microsoft-specific alias for CP949 (Korean)
      when 'ks_c_5601-1987'
        Encoding::CP949

      # Wrongly written Shift_JIS (Japanese)
      when 'shift-jis'
        Encoding::Shift_JIS

      # GB2312 (Chinese charset) is a subset of GB18030 (its replacement)
      when 'gb2312'
        Encoding::GB18030

      when 'cp-850'
        Encoding::CP850

      when 'latin2'
        Encoding::ISO_8859_2

      else
        charset
      end

      convert_to_encoding(encoding)
    end

q_value_decode(str) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 106
    def Ruby19.q_value_decode(str)
      match = str.match(/\=\?(.+)?\?[Qq]\?(.*)\?\=/m)
      if match
        charset = match[1]
        string = match[2].gsub(/_/, '=20')
        # Remove trailing = if it exists in a Q encoding
        string = string.sub(/\=$/, '')
        str = Encodings::QuotedPrintable.decode(string)
        str = charset_encoder.encode(str, charset)
        # We assume that binary strings hold utf-8 directly to work around
        # jruby/jruby#829 which subtly changes String#encode semantics.
        str.force_encoding(Encoding::UTF_8) if str.encoding == Encoding::ASCII_8BIT
      end
      decoded = str.encode(Encoding::UTF_8, :invalid => :replace, :replace => "")
      decoded.valid_encoding? ? decoded : decoded.encode(Encoding::UTF_16LE, :invalid => :replace, :replace => "").encode(Encoding::UTF_8)
    rescue Encoding::UndefinedConversionError, ArgumentError, Encoding::ConverterNotFoundError
      warn "Encoding conversion failed #{$!}"
      str.dup.force_encoding(Encoding::UTF_8)
    end

q_value_encode(str, encoding = nil) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 101
    def Ruby19.q_value_encode(str, encoding = nil)
      encoding = str.encoding.to_s
      [Encodings::QuotedPrintable.encode(str), encoding]
    end

transcode_charset(str, from_encoding, to_encoding = Encoding::UTF_8) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 78
    def Ruby19.transcode_charset(str, from_encoding, to_encoding = Encoding::UTF_8)
      charset_encoder.encode(str.dup, from_encoding).encode(to_encoding, :undef => :replace, :invalid => :replace, :replace => '')
    end

uri_parser() click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 138
    def Ruby19.uri_parser
      @uri_parser ||= URI::Parser.new
    end

### Private Class Methods

convert_to_encoding(encoding) click to toggle source

    # File lib/mail/version_specific/ruby_1_9.rb, line 211
    def convert_to_encoding(encoding)
      if encoding.is_a?(Encoding)
        encoding
      else
        begin
          Encoding.find(encoding)
        rescue ArgumentError
          Encoding::BINARY
        end
      end
    end