i18n 0.5.0beta1 → 0.5.0beta2

data/test/gettext/backend_test.rb

@@ -0,0 +1,93 @@
+# encoding: utf-8
+
+require 'test_helper'
+
+# apparently Ruby 1.9.1p129 has encoding problems with the gettext po parser
+unless RUBY_VERSION == '1.9.1' && RUBY_PATCHLEVEL <= 129
+
+  class I18nGettextBackendTest < Test::Unit::TestCase
+    include I18n::Gettext::Helpers
+
+    class Backend < I18n::Backend::Simple
+      include I18n::Backend::Gettext
+    end
+
+    def setup
+      I18n.backend = Backend.new
+      I18n.locale = :en
+      I18n.load_path = ["#{locales_dir}/de.po"]
+      @old_separator, I18n.default_separator = I18n.default_separator, '|'
+    end
+
+    def teardown
+      I18n.load_path = nil
+      I18n.backend = nil
+      I18n.default_separator = @old_separator
+    end
+
+    def test_backend_loads_po_file
+      I18n.backend.send(:init_translations)
+      assert I18n.backend.send(:translations)[:de][:"Axis"]
+    end
+
+    def test_looks_up_a_translation
+      I18n.locale = :de
+      assert_equal 'Auto', gettext('car')
+    end
+
+    def test_uses_default_translation
+      assert_equal 'car', gettext('car')
+    end
+
+    def test_looks_up_a_namespaced_translation
+      I18n.locale = :de
+      assert_equal 'Räderzahl', sgettext('Car|Wheels count')
+      assert_equal 'Räderzahl', pgettext('Car', 'Wheels count')
+    end
+
+    def test_uses_namespaced_default_translation
+      assert_equal 'Wheels count', sgettext('Car|Wheels count')
+      assert_equal 'Wheels count', pgettext('Car', 'Wheels count')
+    end
+
+    def test_pluralizes_entry
+      I18n.locale = :de
+      assert_equal 'Achse', ngettext('Axis', 'Axis', 1)
+      assert_equal 'Achsen', ngettext('Axis', 'Axis', 2)
+    end
+
+    def test_pluralizes_default_entry
+      assert_equal 'Axis', ngettext('Axis', 'Axis', 1)
+      assert_equal 'Axis', ngettext('Axis', 'Axis', 2)
+    end
+
+    def test_pluralizes_namespaced_entry
+      I18n.locale = :de
+      assert_equal 'Rad',   nsgettext('Car|wheel', 'wheels', 1)
+      assert_equal 'Räder', nsgettext('Car|wheel', 'wheels', 2)
+      assert_equal 'Rad',   npgettext('Car', 'wheel', 'wheels', 1)
+      assert_equal 'Räder', npgettext('Car', 'wheel', 'wheels', 2)
+    end
+
+    def test_pluralizes_namespaced_default_entry
+      assert_equal 'wheel',  nsgettext('Car|wheel', 'wheels', 1)
+      assert_equal 'wheels', nsgettext('Car|wheel', 'wheels', 2)
+      assert_equal 'wheel',  npgettext('Car', 'wheel', 'wheels', 1)
+      assert_equal 'wheels', npgettext('Car', 'wheel', 'wheels', 2)
+    end
+
+    def test_pluralizes_namespaced_entry_with_alternative_syntax
+      I18n.locale = :de
+      assert_equal 'Rad',   nsgettext(['Car|wheel', 'wheels'], 1)
+      assert_equal 'Räder', nsgettext(['Car|wheel', 'wheels'], 2)
+      assert_equal 'Rad',   npgettext('Car', ['wheel', 'wheels'], 1)
+      assert_equal 'Räder', npgettext('Car', ['wheel', 'wheels'], 2)
+    end
+
+    def test_ngettextpluralizes_entry_with_dots
+      I18n.locale = :de
+      assert_equal 'Auf 1 Achse.', n_("On %{count} wheel.", "On %{count} wheels.", 1)
+      assert_equal 'Auf 2 Achsen.', n_("On %{count} wheel.", "On %{count} wheels.", 2)
+    end
+  end
+end

data/test/i18n/exceptions_test.rb

@@ -0,0 +1,116 @@
+require 'test_helper'
+
+class I18nExceptionsTest < Test::Unit::TestCase
+  def test_invalid_locale_stores_locale
+    force_invalid_locale
+  rescue I18n::ArgumentError => e
+    assert_nil exception.locale
+  end
+
+  test "passing an invalid locale raises an InvalidLocale exception" do
+    force_invalid_locale do |exception|
+      assert_equal 'nil is not a valid locale', exception.message
+    end
+  end
+
+  test "MissingTranslationData exception stores locale, key and options" do
+    force_missing_translation_data do |exception|
+      assert_equal 'de', exception.locale
+      assert_equal :foo, exception.key
+      assert_equal({:scope => :bar}, exception.options)
+    end
+  end
+
+  test "MissingTranslationData message contains the locale and scoped key" do
+    force_missing_translation_data do |exception|
+      assert_equal 'translation missing: de.bar.foo', exception.message
+    end
+  end
+
+  test "MissingTranslationData html_message is a span with the titlelized last key token" do
+    force_missing_translation_data do |exception|
+      assert_equal '<span class="translation_missing" title="translation missing: de.bar.foo">Foo</span>', exception.html_message
+    end
+  end
+
+  test "ExceptionHandler returns the html_message if :rescue_format => :html was given" do
+    message = force_missing_translation_data(:rescue_format => :html)
+    assert_equal '<span class="translation_missing" title="translation missing: de.bar.foo">Foo</span>', message
+  end
+
+  test "InvalidPluralizationData stores entry and count" do
+    force_invalid_pluralization_data do |exception|
+      assert_equal [:bar], exception.entry
+      assert_equal 1, exception.count
+    end
+  end
+
+  test "InvalidPluralizationData message contains count and data" do
+    force_invalid_pluralization_data do |exception|
+      assert_equal 'translation data [:bar] can not be used with :count => 1', exception.message
+    end
+  end
+
+  test "MissingInterpolationArgument stores key and string" do
+    assert_raise(I18n::MissingInterpolationArgument) { force_missing_interpolation_argument }
+    force_missing_interpolation_argument do |exception|
+      # assert_equal :bar, exception.key
+      assert_equal "%{bar}", exception.string
+    end
+  end
+
+  test "MissingInterpolationArgument message contains the missing and given arguments" do
+    force_missing_interpolation_argument do |exception|
+      assert_equal 'missing interpolation argument in "%{bar}" ({:baz=>"baz"} given)', exception.message
+    end
+  end
+
+  test "ReservedInterpolationKey stores key and string" do
+    force_reserved_interpolation_key do |exception|
+      assert_equal :scope, exception.key
+      assert_equal "%{scope}", exception.string
+    end
+  end
+
+  test "ReservedInterpolationKey message contains the reserved key" do
+    force_reserved_interpolation_key do |exception|
+      assert_equal 'reserved key :scope used in "%{scope}"', exception.message
+    end
+  end
+
+  private
+
+    def force_invalid_locale
+      I18n.translate(:foo, :locale => nil)
+    rescue I18n::ArgumentError => e
+      block_given? ? yield(e) : raise(e)
+    end
+
+    def force_missing_translation_data(options = {})
+      I18n.backend.store_translations('de', :bar => nil)
+      I18n.translate(:foo, options.merge(:scope => :bar, :locale => :de))
+    rescue I18n::ArgumentError => e
+      block_given? ? yield(e) : raise(e)
+    end
+
+    def force_invalid_pluralization_data
+      I18n.backend.store_translations('de', :foo => [:bar])
+      I18n.translate(:foo, :count => 1, :locale => :de)
+    rescue I18n::ArgumentError => e
+      block_given? ? yield(e) : raise(e)
+    end
+
+    def force_missing_interpolation_argument
+      I18n.backend.store_translations('de', :foo => "%{bar}")
+      I18n.translate(:foo, :baz => 'baz', :locale => :de)
+    rescue I18n::ArgumentError => e
+      block_given? ? yield(e) : raise(e)
+    end
+
+    def force_reserved_interpolation_key
+      I18n.backend.store_translations('de', :foo => "%{scope}")
+      I18n.translate(:foo, :baz => 'baz', :locale => :de)
+    rescue I18n::ArgumentError => e
+      block_given? ? yield(e) : raise(e)
+    end
+end

data/test/i18n/interpolate_test.rb

@@ -0,0 +1,60 @@
+require 'test_helper'
+
+# thanks to Masao's String extensions, some tests taken from Masao's tests
+# http://github.com/mutoh/gettext/blob/edbbe1fa8238fa12c7f26f2418403015f0270e47/test/test_string.rb
+
+class I18nInterpolateTest < Test::Unit::TestCase
+  test "String interpolates a hash argument w/ named placeholders" do
+    assert_equal "Masao Mutoh", I18n.interpolate("%{first} %{last}", :first => 'Masao', :last => 'Mutoh' )
+  end
+
+  test "String interpolates a hash argument w/ named placeholders (reverse order)" do
+    assert_equal "Mutoh, Masao", I18n.interpolate("%{last}, %{first}", :first => 'Masao', :last => 'Mutoh' )
+  end
+
+  test "String interpolates named placeholders with sprintf syntax" do
+    assert_equal "10, 43.4", I18n.interpolate("%<integer>d, %<float>.1f", :integer => 10, :float => 43.4)
+  end
+
+  test "String interpolates named placeholders with sprintf syntax, does not recurse" do
+    assert_equal "%<not_translated>s", I18n.interpolate("%{msg}", :msg => '%<not_translated>s', :not_translated => 'should not happen' )
+  end
+
+  test "String interpolation does not replace anything when no placeholders are given" do
+    assert_equal "aaa", I18n.interpolate("aaa", :num => 1)
+  end
+
+  test "String interpolation sprintf behaviour equals Ruby 1.9 behaviour" do
+    assert_equal "1", I18n.interpolate("%<num>d", :num => 1)
+    assert_equal "0b1", I18n.interpolate("%<num>#b", :num => 1)
+    assert_equal "foo", I18n.interpolate("%<msg>s", :msg => "foo")
+    assert_equal "1.000000", I18n.interpolate("%<num>f", :num => 1.0)
+    assert_equal "  1", I18n.interpolate("%<num>3.0f", :num => 1.0)
+    assert_equal "100.00", I18n.interpolate("%<num>2.2f", :num => 100.0)
+    assert_equal "0x64", I18n.interpolate("%<num>#x", :num => 100.0)
+    assert_raise(ArgumentError) { I18n.interpolate("%<num>,d", :num => 100) }
+    assert_raise(ArgumentError) { I18n.interpolate("%<num>/d", :num => 100) }
+  end
+
+  test "String interpolation raises an I18n::MissingInterpolationArgument when the string has extra placeholders" do
+    assert_raise(I18n::MissingInterpolationArgument) do # Ruby 1.9 msg: "key not found"
+      I18n.interpolate("%{first} %{last}", :first => 'Masao')
+    end
+  end
+
+  test "String interpolation does not raise when extra values were passed" do
+    assert_nothing_raised do
+      assert_equal "Masao Mutoh", I18n.interpolate("%{first} %{last}", :first => 'Masao', :last => 'Mutoh', :salutation => 'Mr.' )
+    end
+  end
+
+  test "% acts as escape character in String interpolation" do
+    assert_equal "%{first}", I18n.interpolate("%%{first}", :first => 'Masao')
+    assert_equal "% 1", I18n.interpolate("%% %<num>d", :num => 1.0)
+    assert_equal "%{num} %<num>d", I18n.interpolate("%%{num} %%<num>d", :num => 1)
+  end
+
+  def test_sprintf_mix_unformatted_and_formatted_named_placeholders
+    assert_equal "foo 1.000000", I18n.interpolate("%{name} %<num>f", :name => "foo", :num => 1.0)
+  end
+end

data/test/i18n/load_path_test.rb

@@ -0,0 +1,26 @@
+require 'test_helper'
+
+class I18nLoadPathTest < Test::Unit::TestCase
+  def setup
+    I18n.locale = :en
+    I18n.backend = I18n::Backend::Simple.new
+    store_translations(:en, :foo => {:bar => 'bar', :baz => 'baz'})
+  end
+
+  test "nested load paths do not break locale loading" do
+    I18n.load_path = [[locales_dir + '/en.yml']]
+    assert_equal "baz", I18n.t(:'foo.bar')
+  end
+
+  test "loading an empty yml file raises an InvalidLocaleData exception" do
+    assert_raise I18n::InvalidLocaleData do
+      I18n.load_path = [[locales_dir + '/invalid/empty.yml']]
+      I18n.t(:'foo.bar', :default => "baz")
+    end
+  end
+
+  test "adding arrays of filenames to the load path does not break locale loading" do
+    I18n.load_path << Dir[locales_dir + '/*.{rb,yml}']
+    assert_equal "baz", I18n.t(:'foo.bar')
+  end
+end

data/test/i18n_test.rb

@@ -0,0 +1,236 @@
+require 'test_helper'
+
+class I18nTest < Test::Unit::TestCase
+  def setup
+    I18n.backend.store_translations(:'en', :currency => { :format => { :separator => '.', :delimiter => ',', } })
+  end
+
+  test "exposes its VERSION constant" do
+    assert I18n::VERSION
+  end
+
+  test "uses the simple backend by default" do
+    assert I18n.backend.is_a?(I18n::Backend::Simple)
+  end
+
+  test "can set the backend" do
+    begin
+      assert_nothing_raised { I18n.backend = self }
+      assert_equal self, I18n.backend
+    ensure
+      I18n.backend = I18n::Backend::Simple.new
+    end
+  end
+
+  test "uses :en as a default_locale by default" do
+    assert_equal :en, I18n.default_locale
+  end
+
+  test "can set the default locale" do
+    begin
+      assert_nothing_raised { I18n.default_locale = 'de' }
+      assert_equal :de, I18n.default_locale
+    ensure
+      I18n.default_locale = :en
+    end
+  end
+
+  test "uses the default locale as a locale by default" do
+    assert_equal I18n.default_locale, I18n.locale
+  end
+
+  test "sets the current locale to Thread.current" do
+    assert_nothing_raised { I18n.locale = 'de' }
+    assert_equal :de, I18n.locale
+    assert_equal :de, Thread.current[:i18n_config].locale
+    I18n.locale = :en
+  end
+
+  test "can set the configuration object" do
+    begin
+      I18n.config = self
+      assert_equal self, I18n.config
+      assert_equal self, Thread.current[:i18n_config]
+    ensure
+      I18n.config = ::I18n::Config.new
+    end
+  end
+
+  test "locale is not shared between configurations" do
+    a = I18n::Config.new
+    b = I18n::Config.new
+    a.locale = :fr
+    b.locale = :es
+    assert_equal :fr, a.locale
+    assert_equal :es, b.locale
+    assert_equal :en, I18n.locale
+  end
+
+  test "other options are shared between configurations" do
+    begin
+      a = I18n::Config.new
+      b = I18n::Config.new
+      a.default_locale = :fr
+      b.default_locale = :es
+      assert_equal :es, a.default_locale
+      assert_equal :es, b.default_locale
+      assert_equal :es, I18n.default_locale
+    ensure
+      I18n.default_locale = :en
+    end
+  end
+
+  test "uses a dot as a default_separator by default" do
+    assert_equal '.', I18n.default_separator
+  end
+
+  test "can set the default_separator" do
+    begin
+      assert_nothing_raised { I18n.default_separator = "\001" }
+    ensure
+      I18n.default_separator = '.'
+    end
+  end
+
+  test "normalize_keys normalizes given locale, keys and scope to an array of single-key symbols" do
+    assert_equal [:en, :foo, :bar], I18n.normalize_keys(:en, :bar, :foo)
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, :'baz.buz', :'foo.bar')
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, 'baz.buz', 'foo.bar')
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, %w(baz buz), %w(foo bar))
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, [:baz, :buz], [:foo, :bar])
+  end
+
+  test "normalize_keys discards empty keys" do
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, :'baz..buz', :'foo..bar')
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, :'baz......buz', :'foo......bar')
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, ['baz', nil, '', 'buz'], ['foo', nil, '', 'bar'])
+  end
+
+  test "normalize_keys uses a given separator" do
+    assert_equal [:en, :foo, :bar, :baz, :buz], I18n.normalize_keys(:en, :'baz|buz', :'foo|bar', '|')
+  end
+
+  test "can set the exception_handler" do
+    begin
+      previous_exception_handler = I18n.exception_handler
+      assert_nothing_raised { I18n.exception_handler = :custom_exception_handler }
+    ensure
+      I18n.exception_handler = previous_exception_handler
+    end
+  end
+
+  test "uses a custom exception handler set to I18n.exception_handler" do
+    begin
+      previous_exception_handler = I18n.exception_handler
+      I18n.exception_handler = :custom_exception_handler
+      I18n.expects(:custom_exception_handler)
+      I18n.translate :bogus
+    ensure
+      I18n.exception_handler = previous_exception_handler
+    end
+  end
+
+  test "uses a custom exception handler passed as an option" do
+    I18n.expects(:custom_exception_handler)
+    I18n.translate(:bogus, :exception_handler => :custom_exception_handler)
+  end
+
+  test "delegates translate calls to the backend" do
+    I18n.backend.expects(:translate).with('de', :foo, {})
+    I18n.translate :foo, :locale => 'de'
+  end
+
+  test "delegates localize calls to the backend" do
+    I18n.backend.expects(:localize).with('de', :whatever, :default, {})
+    I18n.localize :whatever, :locale => 'de'
+  end
+
+  test "translate given no locale uses the current locale" do
+    I18n.backend.expects(:translate).with(:en, :foo, {})
+    I18n.translate :foo
+  end
+
+  test "translate works with nested symbol keys" do
+    assert_equal ".", I18n.t(:'currency.format.separator')
+  end
+
+  test "translate works with nested string keys" do
+    assert_equal ".", I18n.t('currency.format.separator')
+  end
+
+  test "translate with an array as a scope works" do
+    assert_equal ".", I18n.t(:separator, :scope => %w(currency format))
+  end
+
+  test "translate with an array containing dot separated strings as a scope works" do
+    assert_equal ".", I18n.t(:separator, :scope => ['currency.format'])
+  end
+
+  test "translate with an array of keys and a dot separated string as a scope works" do
+    assert_equal [".", ","], I18n.t(%w(separator delimiter), :scope => 'currency.format')
+  end
+
+  test "translate with an array of dot separated keys and a scope works" do
+    assert_equal [".", ","], I18n.t(%w(format.separator format.delimiter), :scope => 'currency')
+  end
+
+  # def test_translate_given_no_args_raises_missing_translation_data
+  #   assert_equal "translation missing: en, no key", I18n.t
+  # end
+
+  test "translate given a bogus key returns an error message" do
+    assert_equal "translation missing: en.bogus", I18n.t(:bogus)
+  end
+
+  test "translate given an empty string as a key raises an I18n::ArgumentError" do
+    assert_raise(I18n::ArgumentError) { I18n.t("") }
+  end
+
+  test "localize given nil raises an I18n::ArgumentError" do
+    assert_raise(I18n::ArgumentError) { I18n.l nil }
+  end
+
+  test "localize givan an Object raises an I18n::ArgumentError" do
+    assert_raise(I18n::ArgumentError) { I18n.l Object.new }
+  end
+
+  test "can use a lambda as an exception handler" do
+    begin
+      previous_exception_handler = I18n.exception_handler
+      I18n.exception_handler = Proc.new { |exception, locale, key, options| exception }
+      assert_equal I18n::MissingTranslationData, I18n.translate(:test_proc_handler).class
+    ensure
+      I18n.exception_handler = previous_exception_handler
+    end
+  end
+
+  test "can use an object responding to #call as an exception handler" do
+    begin
+      previous_exception_handler = I18n.exception_handler
+      I18n.exception_handler = Class.new do
+        def call(exception, locale, key, options); exception; end
+      end.new
+      assert_equal I18n::MissingTranslationData, I18n.translate(:test_proc_handler).class
+    ensure
+      I18n.exception_handler = previous_exception_handler
+    end
+  end
+
+  test "I18n.with_locale temporarily sets the given locale" do
+    store_translations(:en, :foo => 'Foo in :en')
+    store_translations(:de, :foo => 'Foo in :de')
+    store_translations(:pl, :foo => 'Foo in :pl')
+
+    I18n.with_locale      { assert_equal [:en, 'Foo in :en'], [I18n.locale, I18n.t(:foo)] }
+    I18n.with_locale(:de) { assert_equal [:de, 'Foo in :de'], [I18n.locale, I18n.t(:foo)] }
+    I18n.with_locale(:pl) { assert_equal [:pl, 'Foo in :pl'], [I18n.locale, I18n.t(:foo)] }
+    I18n.with_locale(:en) { assert_equal [:en, 'Foo in :en'], [I18n.locale, I18n.t(:foo)] }
+
+    assert_equal I18n.default_locale, I18n.locale
+  end
+
+  test "I18n.with_locale resets the locale in case of errors" do
+    assert_raise(I18n::ArgumentError) { I18n.with_locale(:pl) { raise I18n::ArgumentError } }
+    assert_equal I18n.default_locale, I18n.locale
+  end
+end