fat_cache 0.0.7 → 0.0.8

data/VERSION

@@ -1 +1 @@
-0.0.7
+0.0.8

data/lib/fat_cache.rb

@@ -2,6 +2,8 @@ require 'rubygems'
 require 'ruby-debug'
 
 class FatCache
+  class CacheMiss < RuntimeError; end
+  class AmbiguousHit < RuntimeError; end
 
   class << self
     @initted = false
@@ -40,6 +42,20 @@ class FatCache
       indexed_fatcache[key][by][using]
     end
 
+    def one(key, spec={})
+      result = lookup(key, :by => spec.keys, :using => spec.values)
+      if result && result.length > 1
+        raise AmbiguousHit, "expected one record for #{key} with #{spec.inspect}, got #{result.inspect}" 
+      end
+      result.first if result # makes us return nil if result is nil
+    end
+
+    def one!(key, spec={})
+      result = one(key, spec)
+      raise CacheMiss, "count not find find #{key} with #{spec.inspect}" unless result
+      result
+    end
+
     def index(key, on, &block)
       on = [*on] # ensure we're dealing with an array, we're such a friendly API!
 

data/spec/fat_cache_spec.rb

@@ -105,6 +105,47 @@ describe FatCache do
     end
   end
 
+  describe 'one(key, spec)' do
+
+    describe 'one', :shared => true do
+      it 'returns one record found in the dataset specified by key, with a spec matching the spec hash' do
+        FatCache.set(:numbers) { [0,1,2,3,4] }
+        FatCache.one(:numbers, :zero? => true).should == 0
+      end
+
+      it 'raises an error if more than one record matches spec' do
+        FatCache.set(:numbers) { [0,1,2,3,4] }
+        lambda {
+          FatCache.one(:numbers, :odd? => false)
+        }.should raise_error(FatCache::AmbiguousHit)
+      end
+
+      it 'raises an error if no cache exists for key' do
+        lambda {
+          FatCache.one(:no_way, :not => 'here')
+        }.should raise_error(/no_way/)
+      end
+    end
+
+    it_should_behave_like 'one'
+
+    it 'returns nil if no record found in index' do
+      FatCache.set(:numbers) { [1,2,3,4] }
+      FatCache.one(:numbers, :zero? => true).should be_nil
+    end
+  end
+
+  describe 'one!(key, spec)' do
+    it_should_behave_like 'one'
+
+    it 'raises an error if no record found in index' do
+      FatCache.set(:numbers) { [1,2,3,4] }
+      lambda {
+        FatCache.one!(:numbers, :zero? => true)
+      }.should raise_error(FatCache::CacheMiss)
+    end
+  end
+
   describe 'index(key, on) { optional_block }' do
     it 'raises an error if there is no raw data to index for specified key' do
       lambda {

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: fat_cache
 version: !ruby/object:Gem::Version 
-  version: 0.0.7
+  version: 0.0.8
 platform: ruby
 authors: 
 - phinze