Ensure documentation for fallbacks reflects reality

ruby-i18n · Jul 14, 2020 · dfd1e29 · dfd1e29
1 parent f59c50f
commit dfd1e29
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 1 deletion.
diff --git a/lib/i18n/locale/fallbacks.rb b/lib/i18n/locale/fallbacks.rb
@@ -26,7 +26,7 @@
 #
 #   I18n.default_locale = :"en-US"
 #   I18n.fallbacks = I18n::Locale::Fallbacks.new(:"de-AT" => :"de-DE")
-#   I18n.fallbacks[:"de-AT"] # => [:"de-AT", :"de-DE", :de, :"en-US", :en]
+#   I18n.fallbacks[:"de-AT"] # => [:"de-AT", :de, :"de-DE"]
 #
 #   # using a custom locale as default fallback locale
 #

diff --git a/test/locale/fallbacks_test.rb b/test/locale/fallbacks_test.rb
@@ -9,6 +9,19 @@ class I18nFallbacksDefaultsTest < I18n::TestCase
     assert_equal [], fallbacks.defaults
   end
 
+  test "documentation example #1 - does not use default locale in fallbacks - See Issues #413 & #415" do
+    I18n.default_locale = :"en-US"
+    fallbacks = Fallbacks.new(:"de-AT" => :"de-DE")
+    assert_equal [:"de-AT", :de, :"de-DE"], fallbacks[:"de-AT"]
+  end
+
+  test "documentation example #2 - does not use default locale in fallbacks - Uses custom locale - See Issues #413 & #415" do
+    I18n.default_locale = :"en-US"
+    fallbacks = Fallbacks.new(:"en-GB", :"de-AT" => :de, :"de-CH" => :de)
+    assert_equal [:"de-AT", :de, :"en-GB", :en], fallbacks[:"de-AT"]
+    assert_equal [:"de-CH", :de, :"en-GB", :en], fallbacks[:"de-CH"]
+  end
+
   test "defaults reflect a manually passed default locale if any" do
     fallbacks = Fallbacks.new(:'fi-FI')
     assert_equal [:'fi-FI', :fi], fallbacks.defaults