Module: Redmine::CodesetUtil

Defined in:
lib/redmine/codeset_util.rb

Class Method Summary collapse

Class Method Details

.from_utf8(str, encoding) ⇒ Object 



81
82
83
84
85
86
87
88
89
90
91
92
93
 
# File 'lib/redmine/codeset_util.rb', line 81

def self.from_utf8(str, encoding)
  return if str.nil?

  str = str.dup
  str ||= ''
  str.force_encoding('UTF-8')
  if encoding.casecmp('UTF-8') != 0
    str = str.encode(encoding, :invalid => :replace,
                     :undef => :replace, :replace => '?')
  else
    str = self.replace_invalid_utf8(str)
  end
end

.guess_encoding(str) ⇒ Object 



95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
 
# File 'lib/redmine/codeset_util.rb', line 95

def self.guess_encoding(str)
  return if str.nil?

  str = str.dup
  encodings = Setting.repositories_encodings.split(',').collect(&:strip)
  encodings = encodings.presence || ['UTF-8']

  encodings.each do |encoding|
    begin
      str.force_encoding(encoding)
    rescue Encoding::ConverterNotFoundError
      # ignore if the encoding name is invalid
    end
    return encoding if str.valid_encoding?
  end
  nil
end

.replace_invalid_utf8(str) ⇒ Object 



22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/redmine/codeset_util.rb', line 22

def self.replace_invalid_utf8(str)
  return nil if str.nil?

  str = str.dup
  str.force_encoding('UTF-8')
  unless str.valid_encoding?
    str = str.encode("UTF-16LE", :invalid => :replace,
          :undef => :replace, :replace => '?').encode("UTF-8")
  end
  str
end

.to_utf8(str, encoding) ⇒ Object 



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
 
# File 'lib/redmine/codeset_util.rb', line 34

def self.to_utf8(str, encoding)
  return if str.nil?

  str = str.b
  if str.empty?
    str.force_encoding("UTF-8")
    return str
  end
  enc = encoding.blank? ? "UTF-8" : encoding
  if enc.casecmp("UTF-8") != 0
    str.force_encoding(enc)
    str = str.encode("UTF-8", :invalid => :replace,
          :undef => :replace, :replace => '?')
  else
    str = replace_invalid_utf8(str)
  end
  str
end

.to_utf8_by_setting(str) ⇒ Object 



53
54
55
56
57
58
 
# File 'lib/redmine/codeset_util.rb', line 53

def self.to_utf8_by_setting(str)
  return if str.nil?

  str = str.dup
  self.to_utf8_by_setting_internal(str).force_encoding('UTF-8')
end

.to_utf8_by_setting_internal(str) ⇒ Object 



60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/redmine/codeset_util.rb', line 60

def self.to_utf8_by_setting_internal(str)
  return if str.nil?

  str = str.b
  return str if str.empty?
  return str if /\A[\r\n\t\x20-\x7e]*\Z/n.match?(str) # for us-ascii

  str.force_encoding('UTF-8')
  encodings = Setting.repositories_encodings.split(',').collect(&:strip)
  encodings.each do |encoding|
    begin
      str.force_encoding(encoding)
      utf8 = str.encode('UTF-8')
      return utf8 if utf8.valid_encoding?
    rescue
      # do nothing here and try the next encoding
    end
  end
  self.replace_invalid_utf8(str).force_encoding('UTF-8')
end