123456789_123456789_123456789_123456789_123456789_

Class: I18n::Railtie

Do not use. This class is for internal use only.
Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ::Rails::Railtie, ::ActiveSupport::DescendantsTracker
Instance Chain:
self, ::Rails::Railtie, ::Rails::Initializable
Inherits: Rails::Railtie
Defined in: activesupport/lib/active_support/i18n_railtie.rb

Constant Summary

::Rails::Railtie - Inherited

ABSTRACT_RAILTIES

Class Attribute Summary

::Rails::Railtie - Inherited

.abstract_railtie?, .load_index

Class Method Summary

::Rails::Railtie - Inherited

.configure

Allows you to configure the railtie.
.console, .generators, .inherited,
.instance

Since ::Rails::Railtie cannot be instantiated, any methods that call instance are intended to be called only on subclasses of a Railtie.
.railtie_name, .rake_tasks, .runner, .server, .subclasses, .increment_load_index, .generate_railtie_name,
.method_missing

If the class method does not have a method, then send the method call to the Railtie instance.
.register_block_for

receives an instance variable identifier, set the variable value if is blank and append given block to value, which will be used later in #each_registered_block(type, &block).
.respond_to_missing?, .<=>, .new

::ActiveSupport::DescendantsTracker - Extended

descendants

See additional method definition at line 109.
subclasses, inherited

Instance Attribute Summary

::Rails::Railtie - Inherited

#config

This is used to create the config object on Railties, an instance of Railtie::Configuration, that is used by Railties and Application to store related configuration.
#railtie_name

Instance Method Summary

::Rails::Railtie - Inherited

#each_registered_block

run &block in every registered block in #register_block_for
#configure, #inspect, #railtie_namespace, #run_console_blocks, #run_generators_blocks, #run_runner_blocks, #run_server_blocks, #run_tasks_blocks

::Rails::Initializable - Included

#initializers, #run_initializers

Constructor Details

This class inherits a constructor from Rails::Railtie

Class Method Details

.include_fallbacks_module

[ GitHub ] 

  


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



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


  








  

    .init_fallbacks(fallbacks)  
  

  [ GitHub ]


  

  


# File 'activesupport/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)  
  



  

    

Setup i18n configuration.


  



  [ GitHub ]


  

  


# File 'activesupport/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)  
  

  [ GitHub ]


  

  


# File 'activesupport/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)  
  

  [ GitHub ]


  

  


# File 'activesupport/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)  
  

  [ GitHub ]


  

  


# File 'activesupport/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