Class: IRB::Locale

Inherits:
Object show all
Defined in:
lib/irb/locale.rb

Overview

:nodoc:

Constant Summary collapse

LOCALE_NAME_RE =
%r[
  (?<language>[[:alpha:]]{2,3})
  (?:_  (?<territory>[[:alpha:]]{2,3}) )?
  (?:\. (?<codeset>[^@]+) )?
  (?:@  (?<modifier>.*) )?
]x
LOCALE_DIR =
"/lc/"
LEGACY_ENCODING_ALIAS_MAP =
{
  'ujis' => Encoding::EUC_JP,
  'euc' => Encoding::EUC_JP
}
@@loaded =
[]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(locale = nil) ⇒ Locale

Returns a new instance of Locale.



25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# File 'lib/irb/locale.rb', line 25

def initialize(locale = nil)
  @override_encoding = nil
  @lang = @territory = @encoding_name = @modifier = nil
  @locale = locale || ENV["IRB_LANG"] || ENV["LC_MESSAGES"] || ENV["LC_ALL"] || ENV["LANG"] || "C"
  if m = LOCALE_NAME_RE.match(@locale)
    @lang, @territory, @encoding_name, @modifier = m[:language], m[:territory], m[:codeset], m[:modifier]

    if @encoding_name
      if @encoding = LEGACY_ENCODING_ALIAS_MAP[@encoding_name]
        warn(("%s is obsolete. use %s" % ["#{@lang}_#{@territory}.#{@encoding_name}", "#{@lang}_#{@territory}.#{@encoding.name}"]), uplevel: 1)
      else
        @encoding = Encoding.find(@encoding_name) rescue nil
      end
    end
  end
  @encoding ||= (Encoding.find('locale') rescue Encoding::ASCII_8BIT)
end

Instance Attribute Details

#langObject (readonly)

Returns the value of attribute lang.



43
44
45
# File 'lib/irb/locale.rb', line 43

def lang
  @lang
end

#modifierObject (readonly)

Returns the value of attribute modifier.



43
44
45
# File 'lib/irb/locale.rb', line 43

def modifier
  @modifier
end

#territoryObject (readonly)

Returns the value of attribute territory.



43
44
45
# File 'lib/irb/locale.rb', line 43

def territory
  @territory
end

Instance Method Details

#each_localized_path(dir, file) ⇒ Object



126
127
128
129
130
131
# File 'lib/irb/locale.rb', line 126

def each_localized_path(dir, file)
  return enum_for(:each_localized_path) unless block_given?
  each_sublocale do |lc|
    yield lc.nil? ? File.join(dir, LOCALE_DIR, file) : File.join(dir, LOCALE_DIR, lc, file)
  end
end

#each_sublocale {|nil| ... } ⇒ Object

Yields:

  • (nil)


133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
# File 'lib/irb/locale.rb', line 133

def each_sublocale
  if @lang
    if @territory
      if @encoding_name
        yield "#{@lang}_#{@territory}.#{@encoding_name}@#{@modifier}" if @modifier
        yield "#{@lang}_#{@territory}.#{@encoding_name}"
      end
      yield "#{@lang}_#{@territory}@#{@modifier}" if @modifier
      yield "#{@lang}_#{@territory}"
    end
    if @encoding_name
      yield "#{@lang}.#{@encoding_name}@#{@modifier}" if @modifier
      yield "#{@lang}.#{@encoding_name}"
    end
    yield "#{@lang}@#{@modifier}" if @modifier
    yield "#{@lang}"
  end
  yield nil
end

#encodingObject



45
46
47
# File 'lib/irb/locale.rb', line 45

def encoding
  @override_encoding || @encoding
end

#find(file, paths = $:) ⇒ Object



97
98
99
100
101
102
103
104
105
106
107
# File 'lib/irb/locale.rb', line 97

def find(file , paths = $:)
  dir = File.dirname(file)
  dir = "" if dir == "."
  base = File.basename(file)

  if dir.start_with?('/')
    return each_localized_path(dir, base).find{|full_path| File.readable? full_path}
  else
    return search_file(paths, dir, base)
  end
end

#format(*opts) ⇒ Object



58
59
60
# File 'lib/irb/locale.rb', line 58

def format(*opts)
  String(super(*opts))
end

#gets(*rs) ⇒ Object



62
63
64
# File 'lib/irb/locale.rb', line 62

def gets(*rs)
  String(super(*rs))
end

#load(file) ⇒ Object



85
86
87
88
89
90
91
92
93
94
95
# File 'lib/irb/locale.rb', line 85

def load(file)
  found = find(file)
  if found
    unless @@loaded.include?(found)
      @@loaded << found # cache
      Kernel.load(found)
    end
  else
    raise LoadError, "No such file to load -- #{file}"
  end
end


70
71
72
73
# File 'lib/irb/locale.rb', line 70

def print(*opts)
  ary = opts.collect{|opt| String(opt)}
  super(*ary)
end

#printf(*opts) ⇒ Object



75
76
77
78
# File 'lib/irb/locale.rb', line 75

def printf(*opts)
  s = format(*opts)
  print s
end

#puts(*opts) ⇒ Object



80
81
82
83
# File 'lib/irb/locale.rb', line 80

def puts(*opts)
  ary = opts.collect{|opt| String(opt)}
  super(*ary)
end

#readline(*rs) ⇒ Object



66
67
68
# File 'lib/irb/locale.rb', line 66

def readline(*rs)
  String(super(*rs))
end

#search_file(lib_paths, dir, file) ⇒ Object

typically, for the parameters and a <path> in paths, it searches

<path>/<dir>/<locale>/<file>

Parameters:

  • paths

    load paths in which IRB find a localized file.

  • dir

    directory

  • file

    basename to be localized



115
116
117
118
119
120
121
122
123
124
# File 'lib/irb/locale.rb', line 115

def search_file(lib_paths, dir, file)
  each_localized_path(dir, file) do |lc_path|
    lib_paths.each do |libpath|
      full_path = File.join(libpath, lc_path)
      return full_path if File.readable?(full_path)
    end
    redo if defined?(Gem) and Gem.try_activate(lc_path)
  end
  nil
end

#String(mes) ⇒ Object



49
50
51
52
53
54
55
56
# File 'lib/irb/locale.rb', line 49

def String(mes)
  mes = super(mes)
  if encoding
    mes.encode(encoding, undef: :replace)
  else
    mes
  end
end