air18n 0.1.25 → 0.1.26

data/lib/air18n/backend.rb

@@ -224,5 +224,35 @@ module Air18n
 
       result
     end
+
+    # If there is a translation of given key in given, or a less-specific
+    # fallback locale, returns the most specific locale that has a translation.
+    # Returns nil otherwise.
+    #
+    # For "guessed" specific locales like British English, returns the specific
+    # locale only if there is a manually-written translation for that locale.
+    #
+    # This is useful for knowing whether or not there is a translation for a
+    # key in a locale. It can also be used to determine whether a translation comes
+    # from a fallback locale or not.
+    def has_translation?(key, locale)
+      if key.blank? || !key.is_a?(String)
+        return false
+      end
+
+      init_translations(locale)
+
+      for fallback_locale in I18n.fallbacks_for(locale, :exclude_default => true)
+        if @translation_data.include?(fallback_locale) && @translation_data[fallback_locale].include?(key)
+          return fallback_locale
+        end
+
+        if fallback_locale == I18n.default_locale
+          return fallback_locale
+        end
+      end
+
+      return nil
+    end
   end
 end

data/lib/air18n/class_methods.rb

@@ -294,5 +294,21 @@ module Air18n
 
       result
     end
+
+    # If there is a translation of given key in given, or a less-specific
+    # fallback locale, returns the most specific locale that has a translation.
+    # Returns nil otherwise.
+    #
+    # For "guessed" specific locales like British English, returns the specific
+    # locale only if there is a manually-written translation for that locale.
+    # Otherwise, if the given locale falls back to the default locale, returns
+    # the default locale.
+    #
+    # This is useful for knowing whether or not there is a translation for a
+    # key in a locale. It can also be used to determine whether a translation comes
+    # from a fallback locale or not.
+    def has_translation?(key, locale)
+      @air18n_backend.has_translation?(key, locale)
+    end
   end
 end

data/lib/air18n/version.rb

@@ -1,3 +1,3 @@
 module Air18n
-  VERSION = "0.1.25"
+  VERSION = "0.1.26"
 end

data/spec/lib/air18n/backend_spec.rb

@@ -136,6 +136,33 @@ describe Air18n::Backend do
     end
   end
 
+  context 'has_translation?' do
+    it 'should fallback to less specific locale' do
+      @phrase1 = FactoryGirl.create(:phrase, :key => 'has_translation?, key 1', :value => 'value 1')
+      FactoryGirl.create(:phrase_translation, :phrase => @phrase1, :value => 'Spanish Spanish value 1', :locale => :es)
+      FactoryGirl.create(:phrase_translation, :phrase => @phrase1, :value => 'Latin American Spanish value 1', :locale => :"es-419")
+      @phrase2 = FactoryGirl.create(:phrase, :key => 'has_translation?, key 2', :value => 'value 2')
+      FactoryGirl.create(:phrase_translation, :phrase => @phrase2, :value => 'Spanish Spanish value 2', :locale => :es)
+
+      @backend = Air18n::Backend.new
+      @backend.lookup(:es, 'has_translation?, key 1', @scope).should == 'Spanish Spanish value 1'
+      @backend.lookup(:"es-419", 'has_translation?, key 1', @scope).should == 'Latin American Spanish value 1'
+      @backend.lookup(:es, 'has_translation?, key 2', @scope).should == 'Spanish Spanish value 2'
+      @backend.lookup(:"es-419", 'has_translation?, key 2', @scope).should == 'Spanish Spanish value 2'
+
+      @backend.has_translation?('has_translation?, key 1', :"es-419").should == :"es-419"
+      @backend.has_translation?('has_translation?, key 1', :es).should == :es
+      @backend.has_translation?('has_translation?, key 2', :"es-419").should == :es
+      @backend.has_translation?('has_translation?, key 2', :es).should == :es
+
+      @backend.has_translation?('has_translation?, key 2', :"en-GB").should == :en
+      @backend.has_translation?('has_translation?, key 2', :en).should == :en
+
+      @backend.has_translation?('has_translation?, key 2', :"de-AT").should == nil
+      @backend.has_translation?('has_translation?, key 2', :de).should == nil
+    end
+  end
+
   context 'Language variants' do
     before :all do
       I18n.reset(:en)

data/spec/lib/air18n/phrase_translation_spec.rb

@@ -179,8 +179,7 @@ describe Air18n::PhraseTranslation do
     it 'should keep track of translated and verified word count in new regime' do
       @user1 = 3
       @user2 = 4
-      @phrase1 = FactoryGirl.create(:phrase, :value => 'two words')
-      @phrase2 = FactoryGirl.create(:phrase, :value => 'three long words')
+      @phrase1 = FactoryGirl.create(:phrase, :key => 'new regime payments key 1', :value => 'two words')
 
       without_timestamping_of Air18n::PhraseTranslation do
         @phrase1.value = "one two three four five six seven eight"
@@ -210,33 +209,35 @@ describe Air18n::PhraseTranslation do
       #   Translator B is paid for verifying phrase Y -- 8 words
       #   Translator B is paid for translating phrase Y -- 13 words
 
-      data.should include(
+      data.first.should include(
         {:year=>2012,
          :month=>10,
          :locale=>"es",
-         :user_id=>3,
-         :activity=>
+         :user_id=>3}
+      )
+      data.first[:activity].should include(
           {:num_translations=>2,
            :num_verifications=>0,
            :word_count_translations=>21,
            :word_count_verifications=>0,
            :translated_keys=>
-            [["example.key.4", "38a72c02b5febe4975fdcf19d32e412d"],
-             ["example.key.4", "bef8ae7ec7a9d0145615a1dd8e902e43"]],
-           :verified_keys=>[]}}
+            [["new regime payments key 1", "38a72c02b5febe4975fdcf19d32e412d"],
+             ["new regime payments key 1", "bef8ae7ec7a9d0145615a1dd8e902e43"]],
+           :verified_keys=>[]}
       )
-      data.should include(
+      data.second.should include(
          {:year=>2012,
           :month=>10,
           :locale=>"es",
-          :user_id=>4,
-          :activity=>
+          :user_id=>4}
+      )
+      data.second[:activity].should include(
            {:num_translations=>1,
             :num_verifications=>1,
             :word_count_translations=>13,
             :word_count_verifications=>8,
-            :translated_keys=>[["example.key.4", "bef8ae7ec7a9d0145615a1dd8e902e43"]],
-            :verified_keys=>[["example.key.4", "38a72c02b5febe4975fdcf19d32e412d"]]}}
+            :translated_keys=>[["new regime payments key 1", "bef8ae7ec7a9d0145615a1dd8e902e43"]],
+            :verified_keys=>[["new regime payments key 1", "38a72c02b5febe4975fdcf19d32e412d"]]}
       )
     end
   end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: air18n
 version: !ruby/object:Gem::Version
-  version: 0.1.25
+  version: 0.1.26
   prerelease: 
 platform: ruby
 authors:
@@ -13,7 +13,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2012-11-06 00:00:00.000000000 Z
+date: 2012-11-07 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: i18n