ohm-contrib 0.0.11 → 0.0.12

data/VERSION

@@ -1 +1 @@
-0.0.11
+0.0.12

data/lib/ohm/contrib/locking.rb

@@ -0,0 +1,53 @@
+module Ohm
+  # This module is a straight extraction from Ohm. The only difference is
+  # that this allows for a custom sleep value.
+  # In addition, since future ohm versions might drop mutexes, I thought it
+  # might be a good idea to preseve this feature as a drop-in module.
+  module Locking
+    # Public: Lock the object before executing the block, and release it once the block is done.
+    # 
+    # Examples:
+    #
+    #   post = Order.create(:customer => Customer.create)
+    #   post.mutex(0.01) do
+    #     # this block is in a mutex!
+    #   end
+    def mutex(wait = 0.1)
+      lock!(wait)
+      yield
+      self
+    ensure
+      unlock!
+    end
+
+  protected
+    # Lock the object so no other instances can modify it.
+    # This method implements the design pattern for locks
+    # described at: http://code.google.com/p/redis/wiki/SetnxCommand
+    #
+    # @see Model#mutex
+    def lock!(wait = 0.1)
+      until db.setnx(key(:_lock), lock_timeout)
+        next unless lock = db.get(key(:_lock))
+        sleep(wait) and next unless lock_expired?(lock)
+
+        break unless lock = db.getset(key(:_lock), lock_timeout)
+        break if lock_expired?(lock)
+      end
+    end
+
+    # Release the lock.
+    # @see Model#mutex
+    def unlock!
+      db.del(key(:_lock))
+    end
+
+    def lock_timeout
+      Time.now.to_f + 1
+    end
+
+    def lock_expired? lock
+      lock.to_f < Time.now.to_f
+    end
+  end
+end

data/lib/ohm/contrib.rb

@@ -1,6 +1,6 @@
 module Ohm
   module Contrib
-    VERSION = '0.0.11'
+    VERSION = '0.0.12'
   end
 
   autoload :Boundaries,        "ohm/contrib/boundaries"
@@ -9,4 +9,5 @@ module Ohm
   autoload :WebValidations,    "ohm/contrib/web_validations"
   autoload :NumberValidations, "ohm/contrib/number_validations"
   autoload :Typecast,          "ohm/contrib/typecast"
-end
+  autoload :Locking,           "ohm/contrib/locking"
+end

data/ohm-contrib.gemspec

@@ -5,11 +5,11 @@
 
 Gem::Specification.new do |s|
   s.name = %q{ohm-contrib}
-  s.version = "0.0.11"
+  s.version = "0.0.12"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Cyril David"]
-  s.date = %q{2010-05-18}
+  s.date = %q{2010-05-19}
   s.description = %q{Highly decoupled drop-in functionality for Ohm models}
   s.email = %q{cyx.ucron@gmail.com}
   s.extra_rdoc_files = [
@@ -25,6 +25,7 @@ Gem::Specification.new do |s|
      "VERSION",
      "lib/ohm/contrib.rb",
      "lib/ohm/contrib/boundaries.rb",
+     "lib/ohm/contrib/locking.rb",
      "lib/ohm/contrib/number_validations.rb",
      "lib/ohm/contrib/timestamping.rb",
      "lib/ohm/contrib/to_hash.rb",

data/test/test_ohm_contrib.rb

@@ -36,4 +36,10 @@ class TestOhmContrib < Test::Unit::TestCase
       Ohm::Typecast
     end
   end
-end
+
+  test "autoloading of Locking" do
+    assert_nothing_raised NameError, LoadError do
+      Ohm::Locking
+    end
+  end
+end

metadata

@@ -5,8 +5,8 @@ version: !ruby/object:Gem::Version
   segments: 
   - 0
   - 0
-  - 11
-  version: 0.0.11
+  - 12
+  version: 0.0.12
 platform: ruby
 authors: 
 - Cyril David
@@ -14,7 +14,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2010-05-18 00:00:00 +08:00
+date: 2010-05-19 00:00:00 +08:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -95,6 +95,7 @@ files:
 - VERSION
 - lib/ohm/contrib.rb
 - lib/ohm/contrib/boundaries.rb
+- lib/ohm/contrib/locking.rb
 - lib/ohm/contrib/number_validations.rb
 - lib/ohm/contrib/timestamping.rb
 - lib/ohm/contrib/to_hash.rb