Module: MiniI18n

Extended by:
Localization
Defined in:
lib/mini_i18n.rb,
lib/mini_i18n/utils.rb,
lib/mini_i18n/version.rb,
lib/mini_i18n/localization.rb,
lib/mini_i18n/pluralization.rb

Defined Under Namespace

Modules: Localization, Pluralization, Utils

Constant Summary collapse

DEFAULT_LOCALE = 
:en
DEFAULT_SEPARATOR = 
'.'
VERSION = 
"1.0.0"

Constants included from Localization

Localization::DAYS_MONTHS_REGEX, Localization::DELIMITER_REGEX

Class Attribute Summary collapse

Class Method Summary collapse

Methods included from Localization

localize

Class Attribute Details

.fallbacks ⇒ Object

Returns the value of attribute fallbacks.



15
16
17
 
# File 'lib/mini_i18n.rb', line 15

def fallbacks
  @fallbacks
end

Class Method Details

.available_locales ⇒ Object 



25
26
27
 
# File 'lib/mini_i18n.rb', line 25

def available_locales
  @@available_locales ||= translations.keys
end

.available_locales=(new_locales) ⇒ Object 



29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/mini_i18n.rb', line 29

def available_locales=(new_locales)
  @@available_locales = Array(new_locales).map(&:to_s)

  # Load built-in localization defaults
  @@available_locales.each do |locale|
    default_locale_path = File.join(File.dirname(__FILE__), "mini_i18n", "locales", "#{locale}.yml")
    if File.exist?(default_locale_path)
      YAML.load_file(default_locale_path).each do |loc, translations|
        add_translations(loc, translations)
      end
    end
  end
end

.configure {|_self| ... } ⇒ Object

Yields:

  • (_self)

Yield Parameters:

  • _self (MiniI18n) —

    the object that the method was called on



71
72
73
 
# File 'lib/mini_i18n.rb', line 71

def configure
  yield(self) if block_given?
end

.default_locale ⇒ Object 



17
18
19
 
# File 'lib/mini_i18n.rb', line 17

def default_locale
  @@default_locale ||= DEFAULT_LOCALE
end

.default_locale=(new_locale) ⇒ Object 



21
22
23
 
# File 'lib/mini_i18n.rb', line 21

def default_locale=(new_locale)
  @@default_locale = available_locale?(new_locale) || default_locale
end

.load_translations(path) ⇒ Object 



75
76
77
78
79
80
81
 
# File 'lib/mini_i18n.rb', line 75

def load_translations(path)
  Dir[path.to_s].sort.each do |file|
    YAML.load_file(file).each do |locale, new_translations|
      add_translations(locale.to_s, new_translations)
    end
  end
end

.locale ⇒ Object 



47
48
49
 
# File 'lib/mini_i18n.rb', line 47

def locale
  Thread.current[:mini_i18n_locale] ||= default_locale
end

.locale=(new_locale) ⇒ Object 



51
52
53
 
# File 'lib/mini_i18n.rb', line 51

def locale=(new_locale)
  set_locale(new_locale)
end

.pluralization_rules ⇒ Object 



63
64
65
 
# File 'lib/mini_i18n.rb', line 63

def pluralization_rules
  @@pluralization_rules ||= {}
end

.pluralization_rules=(new_rules) ⇒ Object 



67
68
69
 
# File 'lib/mini_i18n.rb', line 67

def pluralization_rules=(new_rules)
  @@pluralization_rules = new_rules
end

.separator ⇒ Object 



55
56
57
 
# File 'lib/mini_i18n.rb', line 55

def separator
  @@separator ||= DEFAULT_SEPARATOR
end

.separator=(new_separator) ⇒ Object 



59
60
61
 
# File 'lib/mini_i18n.rb', line 59

def separator=(new_separator)
  @@separator = new_separator || DEFAULT_SEPARATOR
end

.translate(key, options = {}) ⇒ Object Also known as: t 



83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
 
# File 'lib/mini_i18n.rb', line 83

def translate(key, options = {})
  return if key.empty? || translations.empty?

  return multiple_translate(key, options) if key.is_a?(Array)
  return multiple_locales(key, options) if options[:locale].is_a?(Array)

  _locale = available_locale?(options[:locale]) || locale
  scope = options[:scope]

  keys = [_locale.to_s]
  keys << scope.to_s.split(separator) if scope
  keys << key.to_s.split(separator)
  keys = keys.flatten

  result = lookup(*keys)

  result = with_fallbacks(result, keys)
  result = with_pluralization(result, options, _locale)
  result = with_interpolation(result, options)

  result || options[:default]
end

.translations ⇒ Object 



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

def translations
  @@translations ||= {}
end