Module: Redmine::CodesetUtil

Defined in:
lib/redmine/codeset_util.rb

Class Method Summary collapse

Class Method Details

.from_utf8(str, encoding) ⇒ Object 



65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/redmine/codeset_util.rb', line 65

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 



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

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 



6
7
8
9
10
11
12
13
14
15
16
 
# File 'lib/redmine/codeset_util.rb', line 6

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

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

.to_utf8(str, encoding) ⇒ Object 



18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
 
# File 'lib/redmine/codeset_util.rb', line 18

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 



37
38
39
40
41
42
 
# File 'lib/redmine/codeset_util.rb', line 37

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 



44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
 
# File 'lib/redmine/codeset_util.rb', line 44

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