tater 1.1.1 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: '00580e7b14eb0c1f1bc26b9a8cc2470638aa06f2f9800b4a4c542de913fffcb4'
-  data.tar.gz: f807ce661a2bed8ca9526f309c1548ddf292f034cbcaeae4223a385f89296c86
+  metadata.gz: df91dea484a66a6511be668c7738e1970a588f07e3bb71f25687b0472290117d
+  data.tar.gz: 97966c5fa1ff9db5f1c42b1ed98720892646e8dce07e49d24e058c79c9fc08a7
 SHA512:
-  metadata.gz: 8ff891fe31f924f41c5bd20aaa0b58c39659a2e0e72cabd4cfd55df79d2e237daaabe2bb717415eca782f814dcd1322737a861f23fd37449e4f8516a71ea197e
-  data.tar.gz: f231dcbca0ca5826a4c99f92afa6c98514985c262a66f473ddb8696d754e849e6c50d371cf82c056e395565b199d6179d665b28b580cade63aa24932c4a378e6
+  metadata.gz: e636ba94fb9e1100729adfa4422fa0dc9c0c692bc38915c114a8115c9b711838b448ee49c63653ccdabbbf467c56450aa661240392b61a833061c1e78d1ddd41
+  data.tar.gz: 60bfea0ecab01a4d99fd28789c6cfe9d7bc5f919d430d63eb1f651e58e45166384e244868ccae42246a2668ac4eb6d63964f536d6baee4a7f1b24cfd1953ef8c

data/lib/tater.rb

@@ -241,6 +241,41 @@ class Tater
     end
   end
 
+  # Check that there's a key at the given path.
+  #
+  # @param key [String]
+  #   The period-separated key path to look within our messages for.
+  # @param options [Hash]
+  #   Options to pass to the #lookup method, including locale overrides.
+  #
+  # @option options [Boolean] :cascade
+  #   Should this lookup cascade or not? Can override @cascade.
+  # @option options [String] :locale
+  #   A specific locale to lookup within. This will take precedence over the
+  #   :locales option.
+  # @option options [Array<String>] :locales
+  #   An array of locales to look within.
+  #
+  # @return [Boolean]
+  def includes?(key, options = {})
+    cascade_override = options.delete(:cascade)
+    locale_override = options.delete(:locale)
+    locales = options.delete(:locales)
+
+    message =
+      if locale_override || !locales
+        lookup(key, locale_override, cascade_override)
+      else
+        locales.find do |accept|
+          found = lookup(key, accept, cascade_override)
+
+          break found if found
+        end
+      end
+
+    !message.nil?
+  end
+
   # Translate a key path and optional interpolation arguments into a string.
   # It's effectively a combination of #lookup and #interpolate.
   #

data/test/tater_test.rb

@@ -334,4 +334,29 @@ describe Tater do
       assert cascade.cascades?
     end
   end
+
+  describe '#includes?' do
+    let :i18n do
+      Tater.new(path: File.expand_path('test/fixtures'))
+    end
+
+    it 'tells you if you have a translation' do
+      assert i18n.includes?('deep')
+      assert i18n.includes?('deep.key')
+      refute i18n.includes?('deep.nope')
+      refute i18n.includes?('nope')
+    end
+
+    it 'allows overriding the locale' do
+      assert i18n.includes?('french', locale: 'fr')
+      assert i18n.includes?('french', locales: %w[en fr])
+      refute i18n.includes?('french', locales: %w[en])
+      refute i18n.includes?('french')
+    end
+
+    it 'allows cascading' do
+      assert i18n.includes?('cascade.nope.tacos', cascade: true)
+      refute i18n.includes?('cascade.nope.tacos', cascade: false)
+    end
+  end
 end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: tater
 version: !ruby/object:Gem::Version
-  version: 1.1.1
+  version: 1.2.0
 platform: ruby
 authors:
 - Evan Lecklider
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-14 00:00:00.000000000 Z
+date: 2019-07-18 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: minitest