non_blocking_lock 0.1.0

data/.gitignore

@@ -0,0 +1,18 @@
+*.gem
+*.rbc
+.bundle
+.config
+.yardoc
+Gemfile.lock
+InstalledFiles
+_yardoc
+coverage
+doc/
+lib/bundler/man
+pkg
+rdoc
+spec/reports
+test/tmp
+test/version_tmp
+tmp
+*.sublime-*

data/Gemfile

@@ -0,0 +1,2 @@
+source 'http://rubygems.org'
+gemspec

data/Rakefile

@@ -0,0 +1,2 @@
+#!/usr/bin/env rake
+require "bundler/gem_tasks"

data/lib/non_blocking_lock.rb

@@ -0,0 +1,10 @@
+require "non_blocking_lock/version"
+require "non_blocking_lock/base"
+
+if defined? ActiveRecord
+  require "non_blocking_lock/mysql2_adapter"
+
+  ActiveRecord::Base.class_eval do
+    include NonBlockingLock
+  end
+end

data/lib/non_blocking_lock/base.rb

@@ -0,0 +1,52 @@
+module NonBlockingLock
+  class LockFailed < ActiveRecord::ActiveRecordError #:nodoc:
+  end
+
+  module ClassMethods
+    # name - lock name
+    # wait_time - default 1.second
+    # &block to execute if lock obtained
+    # return false if failed to get lock
+    def non_blocking_lock( *args, &block )
+      if connection.respond_to?( :non_blocking_lock )
+        connection.non_blocking_lock( *args, &block )
+      else
+        raise ::LockFailed.new( "Not implemented." )
+      end
+    end
+
+    # name - lock name
+    # wait_time - default 1.second
+    # &block to execute if lock obtained
+    # raises exception if failed to get lock
+    def non_blocking_lock!( *args, &block )
+      unless non_blocking_lock( *args, &block )
+        raise ::LockFailed.new( "Failed to obtain a lock." )
+      end
+    end
+  end
+
+  module InstanceMethods
+    # name - lock name
+    # wait_time - default 1.second
+    # &block to execute if lock obtained
+    # return false if failed to get lock
+    def non_blocking_lock( *args, &block )
+      string_id = "_#{self.class}_#{self.id}"
+      if args.first.is_a? String
+        args[0] += string_id
+      else
+        args.unshift(string_id)
+      end
+      self.class.non_blocking_lock( *args, &block )
+    end
+  end
+
+  def self.included( base )
+    base.extend( ClassMethods )
+    base.class_eval do
+      include ::NonBlockingLock::ClassMethods
+      include ::NonBlockingLock::InstanceMethods
+    end
+  end
+end

data/lib/non_blocking_lock/mysql2_adapter.rb

@@ -0,0 +1,27 @@
+require 'active_record/connection_adapters/abstract_mysql_adapter'
+
+module ActiveRecord
+  module ConnectionAdapters
+    class Mysql2Adapter < AbstractMysqlAdapter
+      # name - lock name
+      # wait_time - default 1.second
+      # &block to execute if lock obtained
+      # return false if failed to get lock
+      def non_blocking_lock( name, wait_time=1.0 )
+        raise ArgumentError.new("name can't be empty") if name.blank?
+        raise ArgumentError.new("wait_time can't be less then 0") if wait_time.to_f <= 0
+
+        name = quote_string( name )
+
+        begin
+          mysql_result = select_value( "SELECT GET_LOCK('#{name}', #{wait_time.to_f})" )
+          mysql_get_lock_obtained = mysql_result.to_s == "1"
+          yield if mysql_get_lock_obtained
+          return mysql_get_lock_obtained
+        ensure
+          select_value("SELECT RELEASE_LOCK('#{name}')") if mysql_get_lock_obtained
+        end
+      end
+    end
+  end
+end

data/lib/non_blocking_lock/version.rb

@@ -0,0 +1,3 @@
+module NonBlockingLock
+  VERSION = "0.1.0"
+end

data/non_blocking_lock.gemspec

@@ -0,0 +1,17 @@
+# -*- encoding: utf-8 -*-
+require File.expand_path('../lib/non_blocking_lock/version', __FILE__)
+
+Gem::Specification.new do |gem|
+  gem.authors        = ["Ryan Funduk"]
+  gem.email          = ["ryan.funduk@gmail.com"]
+  gem.description    = %q{A non_blocking_lock implementation for ActiveRecord adapters (well, just Mysql2 right now).}
+  gem.summary        = %q{}
+  gem.homepage       = "http://github.com/rfunduk/non_blocking_lock"
+
+  gem.executables    = `git ls-files -- bin/*`.split("\n").map{ |f| File.basename(f) }
+  gem.files          = `git ls-files`.split("\n")
+  gem.test_files     = `git ls-files -- {test,spec,features}/*`.split("\n")
+  gem.name           = "non_blocking_lock"
+  gem.require_paths  = ["lib"]
+  gem.version        = NonBlockingLock::VERSION
+end

metadata

@@ -0,0 +1,55 @@
+--- !ruby/object:Gem::Specification
+name: non_blocking_lock
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+  prerelease: 
+platform: ruby
+authors:
+- Ryan Funduk
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-01-06 00:00:00.000000000 Z
+dependencies: []
+description: A non_blocking_lock implementation for ActiveRecord adapters (well, just
+  Mysql2 right now).
+email:
+- ryan.funduk@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .gitignore
+- Gemfile
+- Rakefile
+- lib/non_blocking_lock.rb
+- lib/non_blocking_lock/base.rb
+- lib/non_blocking_lock/mysql2_adapter.rb
+- lib/non_blocking_lock/version.rb
+- non_blocking_lock.gemspec
+homepage: http://github.com/rfunduk/non_blocking_lock
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.11
+signing_key: 
+specification_version: 3
+summary: ''
+test_files: []
+has_rdoc: