Class: Mail::Ruby18

Inherits:
Object
  • Object
show all
Defined in:
lib/mail/version_specific/ruby_1_8.rb

Class Method Summary collapse

Class Method Details

.b_value_decode(str) ⇒ Object



80
81
82
83
84
85
86
87
88
# File 'lib/mail/version_specific/ruby_1_8.rb', line 80

def Ruby18.b_value_decode(str)
  match = str.match(/\=\?(.+)?\?[Bb]\?(.*)\?\=/m)
  if match
    encoding = match[1]
    str = Ruby18.decode_base64(match[2])
    str = transcode_charset(str, encoding)
  end
  str
end

.b_value_encode(str, encoding) ⇒ Object

Raises:

  • (ArgumentError)


73
74
75
76
77
78
# File 'lib/mail/version_specific/ruby_1_8.rb', line 73

def Ruby18.b_value_encode(str, encoding)
  # Ruby 1.8 requires an encoding to work
  raise ArgumentError, "Must supply an encoding" if encoding.nil?
  encoding = encoding.to_s.upcase.gsub('_', '-')
  [Encodings::Base64.encode(str), normalize_iconv_charset_encoding(encoding)]
end

.bracket(str) ⇒ Object



36
37
38
39
40
# File 'lib/mail/version_specific/ruby_1_8.rb', line 36

def Ruby18.bracket( str )
  str = $1 if str =~ /^\<(.*)?\>$/
  str = escape_bracket( str )
  '<' + str + '>'
end

.decode_base64(str) ⇒ Object



42
43
44
# File 'lib/mail/version_specific/ruby_1_8.rb', line 42

def Ruby18.decode_base64(str)
  Base64.decode64(str) if str
end

.encode_base64(str) ⇒ Object



46
47
48
# File 'lib/mail/version_specific/ruby_1_8.rb', line 46

def Ruby18.encode_base64(str)
  Base64.encode64(str)
end

.escape_bracket(str) ⇒ Object



27
28
29
30
31
32
33
34
# File 'lib/mail/version_specific/ruby_1_8.rb', line 27

def Ruby18.escape_bracket( str )
  re = /\\\>/
  str = str.gsub(re) { |s| '>'}
  re = /\\\</
  str = str.gsub(re) { |s| '<'}
  re = /([\<\>])/          # Only match unescaped parens
  str.gsub(re) { |s| '\\' + s }
end

.escape_paren(str) ⇒ Object

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



12
13
14
15
16
17
18
19
# File 'lib/mail/version_specific/ruby_1_8.rb', line 12

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

.get_constant(klass, string) ⇒ Object



54
55
56
# File 'lib/mail/version_specific/ruby_1_8.rb', line 54

def Ruby18.get_constant(klass, string)
  klass.const_get( string )
end

.has_constant?(klass, string) ⇒ Boolean

Returns:

  • (Boolean)


50
51
52
# File 'lib/mail/version_specific/ruby_1_8.rb', line 50

def Ruby18.has_constant?(klass, string)
  klass.constants.include?( string )
end

.param_decode(str, encoding) ⇒ Object



110
111
112
# File 'lib/mail/version_specific/ruby_1_8.rb', line 110

def Ruby18.param_decode(str, encoding)
  URI.unescape(str)
end

.param_encode(str) ⇒ Object



114
115
116
117
118
# File 'lib/mail/version_specific/ruby_1_8.rb', line 114

def Ruby18.param_encode(str)
  encoding = $KCODE.to_s.downcase
  language = Configuration.instance.param_encode_language
  "#{encoding}'#{language}'#{URI.escape(str)}"
end

.paren(str) ⇒ Object



21
22
23
24
25
# File 'lib/mail/version_specific/ruby_1_8.rb', line 21

def Ruby18.paren( str )
  str = $1 if str =~ /^\((.*)?\)$/
  str = escape_paren( str )
  '(' + str + ')'
end

.q_value_decode(str) ⇒ Object



97
98
99
100
101
102
103
104
105
106
107
108
# File 'lib/mail/version_specific/ruby_1_8.rb', line 97

def Ruby18.q_value_decode(str)
  match = str.match(/\=\?(.+)?\?[Qq]\?(.*)\?\=/m)
  if match
    encoding = 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 = transcode_charset(str, encoding)
  end
  str
end

.q_value_encode(str, encoding) ⇒ Object

Raises:

  • (ArgumentError)


90
91
92
93
94
95
# File 'lib/mail/version_specific/ruby_1_8.rb', line 90

def Ruby18.q_value_encode(str, encoding)
  # Ruby 1.8 requires an encoding to work
  raise ArgumentError, "Must supply an encoding" if encoding.nil?
  encoding = encoding.to_s.upcase.gsub('_', '-')
  [Encodings::QuotedPrintable.encode(str), encoding]
end

.transcode_charset(str, from_encoding, to_encoding = 'UTF-8') ⇒ Object



58
59
60
61
62
63
64
65
66
67
68
69
70
71
# File 'lib/mail/version_specific/ruby_1_8.rb', line 58

def Ruby18.transcode_charset(str, from_encoding, to_encoding = 'UTF-8')
  retried = false
  begin
    Iconv.conv("#{normalize_iconv_charset_encoding(to_encoding)}//IGNORE", normalize_iconv_charset_encoding(from_encoding), str)
  rescue Iconv::InvalidEncoding
    if retried
      raise
    else
      from_encoding = 'ASCII'
      retried = true
      retry
    end
  end
end