Class: I18n::Railtie

Inherits:
Rails::Railtie
  • Object
show all
Defined in:
lib/active_support/i18n_railtie.rb

Class Method Summary collapse

Class Method Details

.include_fallbacks_module ⇒ Object 



95
96
97
 
# File 'lib/active_support/i18n_railtie.rb', line 95

def self.include_fallbacks_module
  I18n.backend.class.include(I18n::Backend::Fallbacks)
end

.init_fallbacks(fallbacks) ⇒ Object 



99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
 
# File 'lib/active_support/i18n_railtie.rb', line 99

def self.init_fallbacks(fallbacks)
  include_fallbacks_module

  args = \
    case fallbacks
    when ActiveSupport::OrderedOptions
      [*(fallbacks[:defaults] || []) << fallbacks[:map]].compact
    when Hash, Array
      Array.wrap(fallbacks)
    else # TrueClass
      [I18n.default_locale]
    end

  I18n.fallbacks = I18n::Locale::Fallbacks.new(*args)
end

.initialize_i18n(app) ⇒ Object

Setup i18n configuration.



32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
 
# File 'lib/active_support/i18n_railtie.rb', line 32

def self.initialize_i18n(app)
  return if @i18n_inited

  fallbacks = app.config.i18n.delete(:fallbacks)

  # Avoid issues with setting the default_locale by disabling available locales
  # check while configuring.
  enforce_available_locales = app.config.i18n.delete(:enforce_available_locales)
  enforce_available_locales = I18n.enforce_available_locales if enforce_available_locales.nil?
  I18n.enforce_available_locales = false

  reloadable_paths = []
  app.config.i18n.each do |setting, value|
    case setting
    when :railties_load_path
      reloadable_paths = value
      app.config.i18n.load_path.unshift(*value.flat_map(&:existent))
    when :load_path
      I18n.load_path += value
    when :raise_on_missing_translations
      setup_raise_on_missing_translations_config(app)
    else
      I18n.public_send("#{setting}=", value)
    end
  end

  init_fallbacks(fallbacks) if fallbacks && validate_fallbacks(fallbacks)

  # Restore available locales check so it will take place from now on.
  I18n.enforce_available_locales = enforce_available_locales

  if app.config.reloading_enabled?
    directories = watched_dirs_with_extensions(reloadable_paths)
    reloader = app.config.file_watcher.new(I18n.load_path.dup, directories) do
      I18n.load_path.keep_if { |p| File.exist?(p) }
      I18n.load_path |= reloadable_paths.flat_map(&:existent)
    end

    app.reloaders << reloader
    app.reloader.to_run do
      reloader.execute_if_updated { require_unload_lock! }
    end
    reloader.execute
  end

  @i18n_inited = true
end

.setup_raise_on_missing_translations_config(app) ⇒ Object 



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

def self.setup_raise_on_missing_translations_config(app)
  ActiveSupport.on_load(:action_view) do
    ActionView::Helpers::TranslationHelper.raise_on_missing_translations = app.config.i18n.raise_on_missing_translations
  end

  if app.config.i18n.raise_on_missing_translations &&
      I18n.exception_handler.is_a?(I18n::ExceptionHandler) # Only override the i18n gem's default exception handler.

    I18n.exception_handler = ->(exception, *) {
      exception = exception.to_exception if exception.is_a?(I18n::MissingTranslation)
      raise exception
    }
  end
end

.validate_fallbacks(fallbacks) ⇒ Object 



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

def self.validate_fallbacks(fallbacks)
  case fallbacks
  when ActiveSupport::OrderedOptions
    !fallbacks.empty?
  when TrueClass, Array, Hash
    true
  else
    raise "Unexpected fallback type #{fallbacks.inspect}"
  end
end

.watched_dirs_with_extensions(paths) ⇒ Object 



126
127
128
129
130
 
# File 'lib/active_support/i18n_railtie.rb', line 126

def self.watched_dirs_with_extensions(paths)
  paths.each_with_object({}) do |path, result|
    result[path.absolute_current] = path.extensions
  end
end