redislike 0.2.0 → 0.2.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: be9073ce31c76bc2fe4b3395ea7118953d792c7b
-  data.tar.gz: 83f2fb7b888471aac831d9bed7ec2ac0a040c00e
+  metadata.gz: eb04d4b6e5e86b980b69f5798f5f615104c117c9
+  data.tar.gz: 8e59980011755be17d0a2d87913ba59dfc6736f9
 SHA512:
-  metadata.gz: 5f208e78072393e3f78831956a921fec73994e6f1761b1043c7ae6d47d272e9d8265e568ecffb368370fa36deb6b3ca161eb7eeb990a54df4daa23a94c3cf89f
-  data.tar.gz: 63531c739bd0928a9e8e201147817b80014822b88a8c39e7c91bca6a5f9cc9e46247bc6de15dc10ecc1f2feb4aee4086c1f5c2bf99bcd32013c28e7260dd0f3d
+  metadata.gz: 948a85049408f51cea11c1e428ca0c00aa242bb2f54dc5348e83cc375b6cb9597c9a448c2dec9a8ccd0a6ef0254fb9552a602a34fe3891e6a23eb48bda0a63e5
+  data.tar.gz: 668fee9ae35e5273bf5d907dfdf2c28deda1e15ef97740b9bd88400b5a6a32c32f5a439218c5faea533e3299ea8b003839ef38e74644b57080c54c570d558c4e

data/README.md

@@ -7,6 +7,9 @@ redislike adds backend-independent support for redis-like list operations to any
 
 Supported Operations
 --------------------
+* BLPOP
+* BRPOP
+* BRPOPLPUSH
 * LINDEX
 * LINSERT
 * LLEN
@@ -22,16 +25,15 @@ Supported Operations
 * RPUSH
 * RPUSHX
 
-Missing
--------
-* BLPOP
-* BRPOP
-* BRPOPLPUSH
-
 Other Supported Operations
 --------------------------
 * EXISTS
 
+Differences from Redis
+----------------------
+* LSET with a non-existent list raises a ```KeyError``` rather than a ```Redis::CommandError```.
+* LSET with an out of range index raises an ```IndexError``` rather than a ```Redis::CommandError```.
+
 Installation
 ------------
 

data/lib/redislike/helpers/lists.rb

@@ -35,6 +35,10 @@ module RedisLike
         # store list, remaining
         # items.length - remaining.length
       end
+
+      def block_while_empty(list, interval = 0.010)
+        sleep interval until llen(list) > 0
+      end
     end
   end
 end

data/lib/redislike/lists.rb

@@ -24,6 +24,11 @@ module RedisLike
       enqueue list, item, to: :tail, allow_create: false
     end
 
+    def blpop(list)
+      block_while_empty list
+      lpop list
+    end
+
     def lpop(list)
       dequeue list, from: :head
     end
@@ -32,12 +37,22 @@ module RedisLike
       dequeue list, from: :tail
     end
 
+    def brpop(list)
+      block_while_empty list
+      rpop list
+    end
+
     def rpoplpush(source, destination)
       item = rpop source
       lpush destination, item
       item
     end
 
+    def brpoplpush(source, destination)
+      block_while_empty source
+      brpoplpush source, destination
+    end
+
     def lindex(list, item)
       fetch(list, []).at item
     end

data/redislike.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |gem|
   gem.name        = 'redislike'
-  gem.version     = '0.2.0'
+  gem.version     = '0.2.4'
   gem.licenses    = 'MIT'
   gem.authors     = ['Chris Olstrom']
   gem.email       = 'chris@olstrom.com'

data/tests/redislike/lists/blpop.rb

@@ -0,0 +1,37 @@
+require 'timeout'
+
+context 'BLPOP' do
+  setup do
+    @db = Moneta.new :Memory
+  end
+
+  given 'an empty list' do
+    should 'block' do
+      assert_raises Timeout::Error do
+        Timeout.timeout(0.1) { @db.blpop 'test:nx' }
+      end
+    end
+  end
+
+  given 'a list with two items in it' do
+    setup do
+      @db.lpush 'test:blpop', 'foo'
+      @db.lpush 'test:blpop', 'bar'
+    end
+
+    should 'return items from the head of the list' do
+      values = 2.times.map { @db.blpop 'test:blpop' }
+      assert_equal ['bar', 'foo'], values
+    end
+
+    should 'block when there are no items in the list' do
+      2.times { @db.blpop 'test:blpop' }
+
+      assert_raises Timeout::Error do
+        Timeout.timeout(0.1) { @db.blpop 'test:blpop' }
+      end
+    end      
+  end
+
+  teardown { @db.close }
+end

data/tests/redislike/lists/brpop.rb

@@ -0,0 +1,37 @@
+require 'timeout'
+
+context 'BRPOP' do
+  setup do
+    @db = Moneta.new :Memory
+  end
+
+  given 'an empty list' do
+    should 'block' do
+      assert_raises Timeout::Error do
+        Timeout.timeout(0.1) { @db.brpop 'test:nx' }
+      end
+    end
+  end
+
+  given 'a list with two items in it' do
+    setup do
+      @db.lpush 'test:brpop', 'foo'
+      @db.lpush 'test:brpop', 'bar'
+    end
+
+    should 'return items from the head of the list' do
+      values = 2.times.map { @db.brpop 'test:brpop' }
+      assert_equal ['foo', 'bar'], values
+    end
+
+    should 'block when there are no items in the list' do
+      2.times { @db.brpop 'test:brpop' }
+
+      assert_raises Timeout::Error do
+        Timeout.timeout(0.1) { @db.brpop 'test:brpop' }
+      end
+    end      
+  end
+
+  teardown { @db.close }
+end

data/tests/redislike/lists/brpoplpush.rb

@@ -0,0 +1,17 @@
+require 'timeout'
+
+context 'BRPOPLPUSH' do
+  setup do
+    @db = Moneta.new :Memory
+  end
+
+  given 'an empty list' do
+    should 'block' do
+      assert_raises Timeout::Error do
+        Timeout.timeout(0.1) { @db.brpoplpush 'test:nx', 'test:rpoplpush:b' }
+      end
+    end
+  end
+
+  teardown { @db.close }
+end

data/tests/redislike/lists/lrem.rb

@@ -0,0 +1,73 @@
+context 'LREM' do
+  setup do
+    @db = Moneta.new :Memory
+  end
+
+  given 'an empty list' do
+    should 'return no items removed' do
+      assert_equal 0, @db.lrem('test:nx', 0, 'foo')
+    end
+  end
+
+  given 'a list with 6 items' do
+    setup do
+      3.times { @db.lpush 'test:lrem', 'foo' }
+      3.times { @db.lpush 'test:lrem', 'bar' }
+    end
+
+    context 'when the target is present 3 times' do
+      [1, -1].each do |multiplier|
+        direction = multiplier > 0 ? 'head' : 'tail'
+        context "when removing 9 times from #{direction}" do
+          should 'remove 3 items from' do
+            assert_equal 3, @db.lrem('test:lrem', 9 * multiplier, 'foo')
+          end
+
+          should 'not remove other elements' do
+            @db.lrem('test:lrem', 9 * multiplier, 'foo')
+            assert_equal 3, @db.lrange('test:lrem', 0, -1).count('bar')
+          end
+
+          should 'not contain the target anymore' do
+            @db.lrem('test:lrem', 9 * multiplier, 'foo')
+            assert !@db.lrange('test:lrem', 0, -1).include?('foo')
+          end
+        end
+
+        context "when removing 2 times from #{direction}" do
+          should 'remove 2 items' do
+            assert_equal 2, @db.lrem('test:lrem', 2 * multiplier, 'foo')
+          end
+
+          should 'not remove other elements' do
+            @db.lrem('test:lrem', 2 * multiplier, 'foo')
+            assert_equal 3, @db.lrange('test:lrem', 0, -1).count('bar')
+          end
+
+          should 'have one of the target remaining' do
+            @db.lrem('test:lrem', 2 * multiplier, 'foo')
+            assert_equal 1, @db.lrange('test:lrem', 0, -1).count('foo')
+          end
+        end
+
+        context "when removing all from #{direction}" do
+          should 'remove 3 items' do
+            assert_equal 3, @db.lrem('test:lrem', 0 * multiplier, 'foo')
+          end
+
+          should 'not remove other elements' do
+            @db.lrem('test:lrem', 0 * multiplier, 'foo')
+            assert_equal 3, @db.lrange('test:lrem', 0, -1).count('bar')
+          end
+
+          should 'not contain the target anymore' do
+            @db.lrem('test:lrem', 0 * multiplier, 'foo')
+            assert !@db.lrange('test:lrem', 0, -1).include?('foo')
+          end
+        end
+      end
+    end
+  end
+
+  teardown { @db.close }
+end

data/tests/redislike/lists/ltrim.rb

@@ -0,0 +1,51 @@
+context 'LTRIM' do
+  setup do
+    @db = Moneta.new :Memory
+  end
+
+  given 'an empty list' do
+    should 'return success' do
+      assert_equal 'OK', @db.ltrim('test:nx', 0, 99)
+    end
+  end
+
+  given 'a list with 100 items' do
+    setup do
+      50.times { @db.lpush 'test:ltrim', 'foo' }
+      50.times { @db.lpush 'test:ltrim', 'bar' }
+    end
+
+    context 'stop beyond list length' do
+      should 'not truncate the list' do
+        assert_equal 'OK', @db.ltrim('test:ltrim', 0, 200)
+        assert_equal 100, @db.lrange('test:ltrim', 0, -1).length
+      end
+    end
+
+    context 'when stop is positive' do
+      setup { @db.ltrim('test:ltrim', 0, 49) }
+
+      should 'contain items within the range' do
+        assert @db.lrange('test:ltrim', 0, -1).include?('bar')
+      end
+
+      should 'not contain items outside the range' do
+        assert !@db.lrange('test:ltrim', 0, -1).include?('foo')
+      end
+    end
+
+    context 'when stop is negative' do
+      setup { @db.ltrim('test:ltrim', -50, -1) }
+
+      should 'contain items within the range' do
+        assert !@db.lrange('test:ltrim', 0, -1).include?('bar')
+      end
+
+      should 'not contain items outside the range' do
+        assert @db.lrange('test:ltrim', 0, -1).include?('foo')
+      end
+    end
+  end
+
+  teardown { @db.close }
+end

data/tests/redislike/lists.rb

@@ -1,3 +1,6 @@
+require_relative 'lists/blpop'
+require_relative 'lists/brpop'
+require_relative 'lists/brpoplpush'
 require_relative 'lists/lindex'
 require_relative 'lists/linsert'
 require_relative 'lists/llen'
@@ -5,7 +8,9 @@ require_relative 'lists/lpop'
 require_relative 'lists/lpush'
 require_relative 'lists/lpushx'
 require_relative 'lists/lrange'
+require_relative 'lists/lrem'
 require_relative 'lists/lset'
+require_relative 'lists/ltrim'
 require_relative 'lists/rpop'
 require_relative 'lists/rpoplpush'
 require_relative 'lists/rpush'

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: redislike
 version: !ruby/object:Gem::Version
-  version: 0.2.0
+  version: 0.2.4
 platform: ruby
 authors:
 - Chris Olstrom
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-04-07 00:00:00.000000000 Z
+date: 2015-04-08 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: moneta
@@ -102,6 +102,9 @@ files:
 - tests/compatibility/redislike/lists/rpushx.rb
 - tests/redislike.rb
 - tests/redislike/lists.rb
+- tests/redislike/lists/blpop.rb
+- tests/redislike/lists/brpop.rb
+- tests/redislike/lists/brpoplpush.rb
 - tests/redislike/lists/lindex.rb
 - tests/redislike/lists/linsert.rb
 - tests/redislike/lists/llen.rb
@@ -109,7 +112,9 @@ files:
 - tests/redislike/lists/lpush.rb
 - tests/redislike/lists/lpushx.rb
 - tests/redislike/lists/lrange.rb
+- tests/redislike/lists/lrem.rb
 - tests/redislike/lists/lset.rb
+- tests/redislike/lists/ltrim.rb
 - tests/redislike/lists/rpop.rb
 - tests/redislike/lists/rpoplpush.rb
 - tests/redislike/lists/rpush.rb