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 84
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 79
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)
  str.unpack( 'm' ).first
end
encode_base64(str) click to toggle source
# File lib/mail/version_specific/ruby_1_9.rb, line 63
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 71
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 67
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 123
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 129
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 145
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 103
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 98
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 75
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 135
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 208
def convert_to_encoding(encoding)
  if encoding.is_a?(Encoding)
    encoding
  else
    begin
      Encoding.find(encoding)
    rescue ArgumentError
      Encoding::BINARY
    end
  end
end