Contents

# encoding: utf-8

# The Fast module contains optimizations that can tremendously speed up the
# lookup process on the Simple backend. It works by flattening the nested
# translation hash to a flat hash (e.g. { :a => { :b => 'c' } } becomes
# { :'a.b' => 'c' }).
#
# To enable these optimizations you can simply include the Fast module to
# the Simple backend:
#
#   I18n::Backend::Simple.send(:include, I18n::Backend::Fast)
module I18n
  module Backend
    module Fast
      include Flatten

      # Overwrite reload! to also clean up flattened translations.
      def reload!
        super
        reset_flattened_translations!
      end

      protected

        # Generate flattened translations after translations are initialized.
        def init_translations
          super
          flattened_translations
        end

        def lookup(locale, key, scope = nil, options = {})
          locale = locale.to_sym
          return nil unless flattened_translations[locale]

          key = normalize_keys(locale, key, scope, options[:separator]).to_sym
          flattened_translations[locale][key]
        end

        # Store flattened translations in a variable.
        def flattened_translations
          @flattened_translations ||=
            translations.inject({}) do |result, (locale, data)|
              result[locale] = flatten_translations(locale, data, true)
              result
            end
        end

        # Clean up flattened translations variable. Should be called whenever
        # the internal hash is changed.
        def reset_flattened_translations!
          @flattened_translations = nil
        end

        # Overwrite merge_translations to clean up the internal hash so added
        # translations are also cached.
        def merge_translations(locale, data, options = {})
          super
          reset_flattened_translations!
        end
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
i18n-0.4.0.beta	lib/i18n/backend/fast.rb