activesupport 2.3.5 → 2.3.6.pre

data/lib/active_support/vendor/i18n-0.3.3/contributors.txt

@@ -0,0 +1,17 @@
+Akira Matsuda
+Andrew Briening
+Clemens Kofler
+Frederick Cheung
+Jeremy Kemper
+Josh Harvey
+José Valim
+Lawrence Pit
+Luca Guidi
+M4SSIVE
+Marko Seppae
+Mathias Meyer
+Matt Aimonetti
+Michael Lang
+Sven Fuchs
+Theo Cushion
+Yaroslav Markin

data/lib/active_support/vendor/i18n-0.3.3/i18n.gemspec

@@ -0,0 +1,165 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{i18n}
+  s.version = "0.3.3"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Sven Fuchs", "Joshua Harvey", "Matt Aimonetti", "Stephan Soller", "Saimon Moore"]
+  s.date = %q{2009-12-29}
+  s.description = %q{Add Internationalization support to your Ruby application.}
+  s.email = %q{rails-i18n@googlegroups.com}
+  s.extra_rdoc_files = [
+    "README.textile"
+  ]
+  s.files = [
+    "CHANGELOG.textile",
+     "MIT-LICENSE",
+     "README.textile",
+     "Rakefile",
+     "lib/i18n.rb",
+     "lib/i18n/backend.rb",
+     "lib/i18n/backend/active_record.rb",
+     "lib/i18n/backend/active_record/missing.rb",
+     "lib/i18n/backend/active_record/store_procs.rb",
+     "lib/i18n/backend/active_record/translation.rb",
+     "lib/i18n/backend/base.rb",
+     "lib/i18n/backend/cache.rb",
+     "lib/i18n/backend/cascade.rb",
+     "lib/i18n/backend/chain.rb",
+     "lib/i18n/backend/fallbacks.rb",
+     "lib/i18n/backend/fast.rb",
+     "lib/i18n/backend/gettext.rb",
+     "lib/i18n/backend/helpers.rb",
+     "lib/i18n/backend/interpolation_compiler.rb",
+     "lib/i18n/backend/metadata.rb",
+     "lib/i18n/backend/pluralization.rb",
+     "lib/i18n/backend/simple.rb",
+     "lib/i18n/core_ext/object/meta_class.rb",
+     "lib/i18n/core_ext/string/interpolate.rb",
+     "lib/i18n/exceptions.rb",
+     "lib/i18n/gettext.rb",
+     "lib/i18n/helpers.rb",
+     "lib/i18n/helpers/gettext.rb",
+     "lib/i18n/locale.rb",
+     "lib/i18n/locale/fallbacks.rb",
+     "lib/i18n/locale/tag.rb",
+     "lib/i18n/locale/tag/parents.rb",
+     "lib/i18n/locale/tag/rfc4646.rb",
+     "lib/i18n/locale/tag/simple.rb",
+     "lib/i18n/version.rb",
+     "test/all.rb",
+     "test/api/basics.rb",
+     "test/api/defaults.rb",
+     "test/api/interpolation.rb",
+     "test/api/link.rb",
+     "test/api/localization/date.rb",
+     "test/api/localization/date_time.rb",
+     "test/api/localization/procs.rb",
+     "test/api/localization/time.rb",
+     "test/api/lookup.rb",
+     "test/api/pluralization.rb",
+     "test/api/procs.rb",
+     "test/cases/api/active_record_test.rb",
+     "test/cases/api/all_features_test.rb",
+     "test/cases/api/cascade_test.rb",
+     "test/cases/api/chain_test.rb",
+     "test/cases/api/fallbacks_test.rb",
+     "test/cases/api/fast_test.rb",
+     "test/cases/api/pluralization_test.rb",
+     "test/cases/api/simple_test.rb",
+     "test/cases/backend/active_record/missing_test.rb",
+     "test/cases/backend/active_record_test.rb",
+     "test/cases/backend/cache_test.rb",
+     "test/cases/backend/cascade_test.rb",
+     "test/cases/backend/chain_test.rb",
+     "test/cases/backend/fallbacks_test.rb",
+     "test/cases/backend/fast_test.rb",
+     "test/cases/backend/helpers_test.rb",
+     "test/cases/backend/interpolation_compiler_test.rb",
+     "test/cases/backend/metadata_test.rb",
+     "test/cases/backend/pluralization_test.rb",
+     "test/cases/backend/simple_test.rb",
+     "test/cases/core_ext/string/interpolate_test.rb",
+     "test/cases/gettext/api_test.rb",
+     "test/cases/gettext/backend_test.rb",
+     "test/cases/i18n_exceptions_test.rb",
+     "test/cases/i18n_load_path_test.rb",
+     "test/cases/i18n_test.rb",
+     "test/cases/locale/fallbacks_test.rb",
+     "test/cases/locale/tag/rfc4646_test.rb",
+     "test/cases/locale/tag/simple_test.rb",
+     "test/fixtures/locales/de.po",
+     "test/fixtures/locales/en.rb",
+     "test/fixtures/locales/en.yml",
+     "test/fixtures/locales/plurals.rb",
+     "test/test_helper.rb",
+     "vendor/po_parser.rb"
+  ]
+  s.homepage = %q{http://rails-i18n.org}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{i18n}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{New wave Internationalization support for Ruby}
+  s.test_files = [
+    "test/all.rb",
+     "test/api/basics.rb",
+     "test/api/defaults.rb",
+     "test/api/interpolation.rb",
+     "test/api/link.rb",
+     "test/api/localization/date.rb",
+     "test/api/localization/date_time.rb",
+     "test/api/localization/procs.rb",
+     "test/api/localization/time.rb",
+     "test/api/lookup.rb",
+     "test/api/pluralization.rb",
+     "test/api/procs.rb",
+     "test/cases/api/active_record_test.rb",
+     "test/cases/api/all_features_test.rb",
+     "test/cases/api/cascade_test.rb",
+     "test/cases/api/chain_test.rb",
+     "test/cases/api/fallbacks_test.rb",
+     "test/cases/api/fast_test.rb",
+     "test/cases/api/pluralization_test.rb",
+     "test/cases/api/simple_test.rb",
+     "test/cases/backend/active_record/missing_test.rb",
+     "test/cases/backend/active_record_test.rb",
+     "test/cases/backend/cache_test.rb",
+     "test/cases/backend/cascade_test.rb",
+     "test/cases/backend/chain_test.rb",
+     "test/cases/backend/fallbacks_test.rb",
+     "test/cases/backend/fast_test.rb",
+     "test/cases/backend/helpers_test.rb",
+     "test/cases/backend/interpolation_compiler_test.rb",
+     "test/cases/backend/metadata_test.rb",
+     "test/cases/backend/pluralization_test.rb",
+     "test/cases/backend/simple_test.rb",
+     "test/cases/core_ext/string/interpolate_test.rb",
+     "test/cases/gettext/api_test.rb",
+     "test/cases/gettext/backend_test.rb",
+     "test/cases/i18n_exceptions_test.rb",
+     "test/cases/i18n_load_path_test.rb",
+     "test/cases/i18n_test.rb",
+     "test/cases/locale/fallbacks_test.rb",
+     "test/cases/locale/tag/rfc4646_test.rb",
+     "test/cases/locale/tag/simple_test.rb",
+     "test/fixtures/locales/en.rb",
+     "test/fixtures/locales/plurals.rb",
+     "test/test_helper.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end
+

data/lib/active_support/vendor/i18n-0.3.3/init.rb

@@ -0,0 +1 @@
+require File.dirname(__FILE__) + '/lib/i18n'

data/lib/active_support/vendor/{i18n-0.1.3 → i18n-0.3.3}/lib/i18n.rb

@@ -1,17 +1,24 @@
-# Authors::   Matt Aimonetti (http://railsontherun.com/),
-#             Sven Fuchs (http://www.artweb-design.de),
+# encoding: utf-8
+
+# Authors::   Sven Fuchs (http://www.artweb-design.de),
 #             Joshua Harvey (http://www.workingwithrails.com/person/759-joshua-harvey),
+#             Stephan Soller (http://www.arkanis-development.de/),
 #             Saimon Moore (http://saimonmoore.net),
-#             Stephan Soller (http://www.arkanis-development.de/)
+#             Matt Aimonetti (http://railsontherun.com/)
 # Copyright:: Copyright (c) 2008 The Ruby i18n Team
 # License::   MIT
-require 'i18n/backend/simple'
 require 'i18n/exceptions'
+require 'i18n/core_ext/string/interpolate'
 
 module I18n
+  autoload :Backend, 'i18n/backend'
+  autoload :Helpers, 'i18n/helpers'
+  autoload :Locale,  'i18n/locale'
+
   @@backend = nil
   @@load_path = nil
-  @@default_locale = :'en'
+  @@default_locale = :en
+  @@default_separator = '.'
   @@exception_handler = :default_exception_handler
 
   class << self
@@ -32,7 +39,7 @@ module I18n
 
     # Sets the current default locale. Used to set a custom default locale.
     def default_locale=(locale)
-      @@default_locale = locale
+      @@default_locale = locale.to_sym rescue nil
     end
 
     # Returns the current locale. Defaults to I18n.default_locale.
@@ -42,12 +49,29 @@ module I18n
 
     # Sets the current locale pseudo-globally, i.e. in the Thread.current hash.
     def locale=(locale)
-      Thread.current[:locale] = locale
+      Thread.current[:locale] = locale.to_sym rescue nil
     end
 
-    # Returns an array of locales for which translations are available
+    # Returns an array of locales for which translations are available.
+    # Unless you explicitely set the these through I18n.available_locales=
+    # the call will be delegated to the backend and memoized on the I18n module.
     def available_locales
-      backend.available_locales
+      @@available_locales ||= backend.available_locales
+    end
+
+    # Sets the available locales.
+    def available_locales=(locales)
+      @@available_locales = locales
+    end
+
+    # Returns the current default scope separator. Defaults to '.'
+    def default_separator
+      @@default_separator
+    end
+
+    # Sets the current default scope separator.
+    def default_separator=(separator)
+      @@default_separator = separator
     end
 
     # Sets the exception handler.
@@ -150,7 +174,7 @@ module I18n
     # or <tt>default</tt> if no translations for <tt>:foo</tt> and <tt>:bar</tt> were found.
     #   I18n.t :foo, :default => [:bar, 'default']
     #
-    # <b>BULK LOOKUP</b>
+    # *BULK LOOKUP*
     #
     # This returns an array with the translations for <tt>:foo</tt> and <tt>:bar</tt>.
     #   I18n.t [:foo, :bar]
@@ -160,15 +184,39 @@ module I18n
     #
     # Which is the same as using a scope option:
     #   I18n.t [:foo, :bar], :scope => :baz
-    def translate(key, options = {})
-      locale = options.delete(:locale) || I18n.locale
-      backend.translate(locale, key, options)
-    rescue I18n::ArgumentError => e
-      raise e if options[:raise]
-      send(@@exception_handler, e, locale, key, options)
+    #
+    # *LAMBDAS*
+    #
+    # Both translations and defaults can be given as Ruby lambdas. Lambdas will be
+    # called and passed the key and options.
+    #
+    # E.g. assuming the key <tt>:salutation</tt> resolves to:
+    #   lambda { |key, options| options[:gender] == 'm' ? "Mr. {{options[:name]}}" : "Mrs. {{options[:name]}}" }
+    #
+    # Then <tt>I18n.t(:salutation, :gender => 'w', :name => 'Smith') will result in "Mrs. Smith".
+    #
+    # It is recommended to use/implement lambdas in an "idempotent" way. E.g. when
+    # a cache layer is put in front of I18n.translate it will generate a cache key
+    # from the argument values passed to #translate. Therefor your lambdas should
+    # always return the same translations/values per unique combination of argument
+    # values.
+    def translate(*args)
+      options = args.pop if args.last.is_a?(Hash)
+      key     = args.shift
+      locale  = options && options.delete(:locale) || I18n.locale
+      raises  = options && options.delete(:raise)
+      backend.translate(locale, key, options || {})
+    rescue I18n::ArgumentError => exception
+      raise exception if raises
+      handle_exception(exception, locale, key, options)
     end
     alias :t :translate
 
+    def translate!(key, options = {})
+      translate(key, options.merge( :raise => true ))
+    end
+    alias :t! :translate!
+
     # Localizes certain objects, such as dates and numbers to local formatting.
     def localize(object, options = {})
       locale = options[:locale] || I18n.locale
@@ -177,7 +225,10 @@ module I18n
     end
     alias :l :localize
 
-  protected
+  # making these private until Ruby 1.9.2 can send to protected methods again
+  # see http://redmine.ruby-lang.org/repositories/revision/ruby-19?rev=24280
+  private
+
     # Handles exceptions raised in the backend. All exceptions except for
     # MissingTranslationData exceptions are re-raised. When a MissingTranslationData
     # was caught and the option :raise is not set the handler returns an error
@@ -187,13 +238,40 @@ module I18n
       raise exception
     end
 
+    # Any exceptions thrown in translate will be sent to the @@exception_handler
+    # which can be a Symbol, a Proc or any other Object.
+    #
+    # If exception_handler is a Symbol then it will simply be sent to I18n as
+    # a method call. A Proc will simply be called. In any other case the
+    # method #call will be called on the exception_handler object.
+    #
+    # Examples:
+    #
+    #   I18n.exception_handler = :default_exception_handler             # this is the default
+    #   I18n.default_exception_handler(exception, locale, key, options) # will be called like this
+    #
+    #   I18n.exception_handler = lambda { |*args| ... }                 # a lambda
+    #   I18n.exception_handler.call(exception, locale, key, options)    # will be called like this
+    #
+    #  I18n.exception_handler = I18nExceptionHandler.new                # an object
+    #  I18n.exception_handler.call(exception, locale, key, options)     # will be called like this
+    def handle_exception(exception, locale, key, options)
+      case @@exception_handler
+      when Symbol
+        send(@@exception_handler, exception, locale, key, options)
+      else
+        @@exception_handler.call(exception, locale, key, options)
+      end
+    end
+
     # Merges the given locale, key and scope into a single array of keys.
     # Splits keys that contain dots into multiple keys. Makes sure all
     # keys are Symbols.
-    def normalize_translation_keys(locale, key, scope)
-      keys = [locale] + Array(scope) + [key]
-      keys = keys.map { |k| k.to_s.split(/\./) }
-      keys.flatten.map { |k| k.to_sym }
+    def normalize_translation_keys(locale, key, scope, separator = nil)
+      keys = [locale] + Array(scope) + Array(key)
+      keys = keys.map { |k| k.to_s.split(separator || I18n.default_separator) }
+      keys = keys.flatten - ['']
+      keys.map { |k| k.to_sym }
     end
   end
 end

data/lib/active_support/vendor/i18n-0.3.3/lib/i18n/backend.rb

@@ -0,0 +1,17 @@
+module I18n
+  module Backend
+    autoload :ActiveRecord,          'i18n/backend/active_record'
+    autoload :Base,                  'i18n/backend/base'
+    autoload :Cache,                 'i18n/backend/cache'
+    autoload :Cascade,               'i18n/backend/cascade'
+    autoload :Chain,                 'i18n/backend/chain'
+    autoload :Fallbacks,             'i18n/backend/fallbacks'
+    autoload :Fast,                  'i18n/backend/fast'
+    autoload :Gettext,               'i18n/backend/gettext'
+    autoload :Helpers,               'i18n/backend/helpers'
+    autoload :InterpolationCompiler, 'i18n/backend/interpolation_compiler'
+    autoload :Metadata,              'i18n/backend/metadata'
+    autoload :Pluralization,         'i18n/backend/pluralization'
+    autoload :Simple,                'i18n/backend/simple'
+  end
+end

data/lib/active_support/vendor/i18n-0.3.3/lib/i18n/backend/active_record.rb

@@ -0,0 +1,70 @@
+require 'i18n/backend/base'
+require 'i18n/backend/active_record/translation'
+
+#
+#  This backend reads translations from a Translations table in environment database. Note that the database
+#  will not automatically be prepopulated with missing keys. You can achieve this effect with the ActiveRecordMissing backend, 
+#  as the following example shows:
+#
+#     I18n.backend = I18n::Backend::Chain.new(I18n::Backend::ActiveRecord.new, I18.backend, I18n::Backend::ActiveRecordMissing.new)
+#
+module I18n
+  module Backend
+    class ActiveRecord
+      autoload :Missing,     'i18n/backend/active_record/missing'
+      autoload :StoreProcs,  'i18n/backend/active_record/store_procs'
+      autoload :Translation, 'i18n/backend/active_record/translation'
+
+      include Base
+
+      def reload!
+      end
+
+      def store_translations(locale, data, options = {})
+        separator = options[:separator] || I18n.default_separator
+        wind_keys(data, separator).each do |key, v|
+          Translation.locale(locale).lookup(expand_keys(key, separator), separator).delete_all
+          Translation.create(:locale => locale.to_s, :key => key.to_s, :value => v)
+        end
+      end
+
+      def available_locales
+        begin
+          Translation.available_locales
+        rescue ::ActiveRecord::StatementInvalid
+          []
+        end
+      end
+
+      protected
+
+        def lookup(locale, key, scope = [], separator = nil)
+          return unless key
+
+          separator ||= I18n.default_separator
+          key = (Array(scope) + Array(key)).join(separator)
+
+          result = Translation.locale(locale).lookup(key, separator).all
+          if result.empty?
+            return nil
+          elsif result.first.key == key
+            return result.first.value
+          else
+            chop_range = (key.size + separator.size)..-1
+            result = result.inject({}) do |hash, r|
+              hash[r.key.slice(chop_range)] = r.value
+              hash
+            end
+            deep_symbolize_keys(unwind_keys(result, separator))
+          end
+        end
+
+        # For a key :'foo.bar.baz' return ['foo', 'foo.bar', 'foo.bar.baz']
+        def expand_keys(key, separator = I18n.default_separator)
+          key.to_s.split(separator).inject([]) do |keys, key|
+            keys << [keys.last, key].compact.join(separator)
+          end
+        end
+    end
+  end
+end