peons 0.0.1 → 0.0.2

data/LICENSE

@@ -0,0 +1,19 @@
+Copyright (c) 2010 Cyril David
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
+THE SOFTWARE.

data/README.markdown

@@ -0,0 +1,60 @@
+Peons
+=====
+
+Peons
+
+_n. Hard working dependable slaves, with a keen attention to mining your gold._
+
+Quick Start
+-----------
+
+It's easy to get started with Peon.
+
+    $ [sudo] gem install peons
+    $ redis-server # Assuming you have redis-server installed and in your path
+
+    require "peons"
+
+    Peons[:fortress].push "1"
+    Peons[:fortress].push "2"
+    Peons[:fortress].push "3"
+    Peons[:fortress].push "4"
+
+    output = []
+
+    Peons[:fortress].each do |item|
+      output << item
+    end
+
+    output == ["1", "2", "3", "4"]
+    # => true
+
+### Atomic Pops
+
+You can also do atomic pops, if you'd prefer that over looping your entire 
+queue.
+
+    Peons[:fortress].push "1"
+    
+    popped = nil
+
+    Peons[:fortress].pop do |item|
+      popped = item
+    end
+
+    popped == "1"
+    # => true
+
+### Connecting to a different Redis connection
+
+For cases where you want to connect to a Redis connection which isn't the
+default, simply assign like so:
+
+    Peons.redis = Redis.connect(:url => "redis://127.0.0.1:22222/1")
+
+### TODO
+
+1. Testing for thread safety.
+2. A sinatra web interface to display all queues
+3. General hardening.
+

data/lib/peons.rb

@@ -2,7 +2,7 @@ require "redis"
 require "nest"
 
 module Peons
-  VERSION = "0.0.1"
+  VERSION = "0.0.2"
   
   class Queue < Nest
     alias :push :lpush
@@ -15,7 +15,7 @@ module Peons
       rescue Exception => e
         fail(e, item)
       ensure
-        backup.lrem 1, item
+        backup.del
       end
     end
 
@@ -28,7 +28,7 @@ module Peons
     end
 
     def backup
-      self[:backup]
+      self[Process.pid][:backup]
     end
 
     def errors
@@ -49,11 +49,11 @@ module Peons
   end
 
   def self.[](key)
-    Queue.new(key, redis)
+    Queue.new(:peons, redis)[key]
   end
 
   def self.redis
-    threaded[:redis] ||= Redis.new
+    threaded[:redis] ||= Redis.connect
   end
 
   def self.redis=(redis)

data/test/peons_test.rb

@@ -30,6 +30,7 @@ test "popping from a queue with one element" do |q|
   end
 
   assert "1" == popped
+  assert 0 == q.llen
   assert 0 == q.backup.llen
 end
 
@@ -44,6 +45,7 @@ test "popping from a queue with two distinct elements" do |q|
   end
 
   assert "1" == popped
+  assert 1 == q.llen
   assert 0 == q.backup.llen
 end
 
@@ -58,6 +60,7 @@ test "popping from a queue with two equal elements" do |q|
   end
 
   assert "1" == popped
+  assert 1 == q.llen
   assert 0 == q.backup.llen
 end
 
@@ -71,7 +74,6 @@ test "popping and producing an error inside the block" do |q|
   
   assert 1 == q.llen
   assert 0 == q.backup.llen
-
   assert 1 == q.errors.llen
   
   assert q.errors.lrange(0, -1).grep(/1 => #<RuntimeError: Fabrication>/).any?
@@ -89,5 +91,15 @@ test "looping against the queue" do |q|
   end
   
   assert ["1", "2", "3"] == output
+
+  assert 0 == q.llen
+  assert 0 == q.backup.llen
+  assert 0 == q.errors.llen
+end
+
+test "all queues are namespaced" do
+  assert "peons:foo" == Peons[:foo] 
+  assert "peons:bar" == Peons[:bar] 
+  assert "peons:baz" == Peons[:baz] 
 end
 

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 1
-  version: 0.0.1
+  - 2
+  version: 0.0.2
 platform: ruby
 authors: 
 - Cyril David
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-10-01 00:00:00 +08:00
+date: 2010-10-05 00:00:00 +08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -66,6 +66,8 @@ extra_rdoc_files: []
 
 files: 
 - lib/peons.rb
+- README.markdown
+- LICENSE
 - Rakefile
 - test/helper.rb
 - test/peons_test.rb