Module: TMail::TextUtils

Included in:
TMail, Address, Decoder, Encoder, HeaderField, Mail
Defined in:
lib/action_mailer/vendor/tmail/utils.rb

Constant Summary collapse

ATOM_UNSAFE = 
/[#{Regexp.quote aspecial}#{control}#{lwsp}]/n
PHRASE_UNSAFE = 
/[#{Regexp.quote aspecial}#{control}]/n
TOKEN_UNSAFE = 
/[#{Regexp.quote tspecial}#{control}#{lwsp}]/n
CONTROL_CHAR = 
/[#{control}]/n
ZONESTR_TABLE = 
{
  'jst' =>   9 * 60,
  'eet' =>   2 * 60,
  'bst' =>   1 * 60,
  'met' =>   1 * 60,
  'gmt' =>   0,
  'utc' =>   0,
  'ut'  =>   0,
  'nst' => -(3 * 60 + 30),
  'ast' =>  -4 * 60,
  'edt' =>  -4 * 60,
  'est' =>  -5 * 60,
  'cdt' =>  -5 * 60,
  'cst' =>  -6 * 60,
  'mdt' =>  -6 * 60,
  'mst' =>  -7 * 60,
  'pdt' =>  -7 * 60,
  'pst' =>  -8 * 60,
  'a'   =>  -1 * 60,
  'b'   =>  -2 * 60,
  'c'   =>  -3 * 60,
  'd'   =>  -4 * 60,
  'e'   =>  -5 * 60,
  'f'   =>  -6 * 60,
  'g'   =>  -7 * 60,
  'h'   =>  -8 * 60,
  'i'   =>  -9 * 60,
  # j not use
  'k'   => -10 * 60,
  'l'   => -11 * 60,
  'm'   => -12 * 60,
  'n'   =>   1 * 60,
  'o'   =>   2 * 60,
  'p'   =>   3 * 60,
  'q'   =>   4 * 60,
  'r'   =>   5 * 60,
  's'   =>   6 * 60,
  't'   =>   7 * 60,
  'u'   =>   8 * 60,
  'v'   =>   9 * 60,
  'w'   =>  10 * 60,
  'x'   =>  11 * 60,
  'y'   =>  12 * 60,
  'z'   =>   0 * 60
}
WDAY = 
%w( Sun Mon Tue Wed Thu Fri Sat TMailBUG )
MONTH = 
%w( TMailBUG Jan Feb Mar Apr May Jun
Jul Aug Sep Oct Nov Dec TMailBUG )
MESSAGE_ID = 
/<[^\@>]+\@[^>\@]+>/
MIME_ENCODED = 
/=\?[^\s?=]+\?[QB]\?[^\s?=]+\?=/i
NKF_FLAGS = 
{
  'EUC'  => '-e -m',
  'SJIS' => '-s -m'
}
RFC2231_ENCODED = 
/\A(?:iso-2022-jp|euc-jp|shift_jis|us-ascii)?'[a-z]*'/in

Instance Method Summary collapse

Instance Method Details

#atom_safe?(str) ⇒ Boolean

Returns:

  • (Boolean) 


49
50
51
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 49

def atom_safe?( str )
  not ATOM_UNSAFE === str
end

#decode_params(hash) ⇒ Object 



176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 176

def decode_params( hash )
  new = Hash.new
  encoded = nil
  hash.each do |key, value|
    if m = /\*(?:(\d+)\*)?\z/.match(key)
      ((encoded ||= {})[m.pre_match] ||= [])[(m[1] || 0).to_i] = value
    else
      new[key] = to_kcode(value)
    end
  end
  if encoded
    encoded.each do |key, strings|
      new[key] = decode_RFC2231(strings.join(''))
    end
  end

  new
end

#decode_RFC2231(str) ⇒ Object 



207
208
209
210
211
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 207

def decode_RFC2231( str )
  m = RFC2231_ENCODED.match(str) or return str
  NKF.nkf(NKF_FLAGS[$KCODE],
          m.post_match.gsub(/%[\da-f]{2}/in) {|s| s[1,2].hex.chr })
end

#join_domain(arr) ⇒ Object 



75
76
77
78
79
80
81
82
83
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 75

def join_domain( arr )
  arr.map {|i|
      if /\A\[.*\]\z/ === i
        i
      else
        quote_atom(i)
      end
  }.join('.')
end

#message_id?(str) ⇒ Boolean

Returns:

  • (Boolean) 


164
165
166
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 164

def message_id?( str )
  MESSAGE_ID === str
end

#mime_encoded?(str) ⇒ Boolean

Returns:

  • (Boolean) 


171
172
173
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 171

def mime_encoded?( str )
  MIME_ENCODED === str
end

#quote_atom(str) ⇒ Object 



53
54
55
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 53

def quote_atom( str )
  (ATOM_UNSAFE === str) ? dquote(str) : str
end

#quote_phrase(str) ⇒ Object 



57
58
59
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 57

def quote_phrase( str )
  (PHRASE_UNSAFE === str) ? dquote(str) : str
end

#quote_token(str) ⇒ Object 



65
66
67
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 65

def quote_token( str )
  (TOKEN_UNSAFE === str) ? dquote(str) : str
end

#time2str(tm) ⇒ Object 



148
149
150
151
152
153
154
155
156
157
158
159
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 148

def time2str( tm )
  # [ruby-list:7928]
  gmt = Time.at(tm.to_i)
  gmt.gmtime
  offset = tm.to_i - Time.local(*gmt.to_a[0,6].reverse).to_i

  # DO NOT USE strftime: setlocale() breaks it
  sprintf '%s, %s %s %d %02d:%02d:%02d %+.2d%.2d',
          WDAY[tm.wday], tm.mday, MONTH[tm.month],
          tm.year, tm.hour, tm.min, tm.sec,
          *(offset / 60).divmod(60)
end

#timezone_string_to_unixtime(str) ⇒ Object 



132
133
134
135
136
137
138
139
140
141
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 132

def timezone_string_to_unixtime( str )
  if m = /([\+\-])(\d\d?)(\d\d)/.match(str)
    sec = (m[2].to_i * 60 + m[3].to_i) * 60
    m[1] == '-' ? -sec : sec
  else
    min = ZONESTR_TABLE[str.downcase] or
            raise SyntaxError, "wrong timezone format '#{str}'"
    min * 60
  end
end

#to_kcode(str) ⇒ Object 



200
201
202
203
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 200

def to_kcode( str )
  flag = NKF_FLAGS[$KCODE] or return str
  NKF.nkf(flag, str)
end

#token_safe?(str) ⇒ Boolean

Returns:

  • (Boolean) 


61
62
63
 
# File 'lib/action_mailer/vendor/tmail/utils.rb', line 61

def token_safe?( str )
  not TOKEN_UNSAFE === str
end