db_lock 0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: a417593c5982747526ac5920330834da914b6738
+  data.tar.gz: 4bb0bcb0d544ee9caa69898d2490d84236788674
+SHA512:
+  metadata.gz: 0845da08c077e9e781142b5933227918661b2865a18bc46f9f2b70702a86658556cf5124296ede7fa4d05b310f7b930805bce70942986683cc6e6e3f44209390
+  data.tar.gz: 036c960adfe8d81385a1eeaac2cd8ccb8d696dab8b73fb18152adbc6169db9676954c5862682770db57c0695940030c1ef5960b30eaf4751ff07c4fd1f07ea86

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright 2013 YOURNAME
+
+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.md

@@ -0,0 +1,25 @@
+# DBLock
+
+Gem to obtain and release manual mysql db locks. This can be utilized for example to make sure that certain rake tasks do not run in parallel on the same database (for exampel when corn jobs run for too long or are accidnetially started multiple times).
+
+## Installation
+
+Add this line to your application's Gemfile:
+
+    gem 'db_lock'
+
+then run `bundle`
+
+## Usage
+
+```ruby
+DBLock::Lock.get('name_of_lock', 5) do
+  # code here
+end
+```
+
+Before the code block is executed, it will attempt to aquire a mysql db lock for X seconds (5 in this example). If this fails it will raise an `DBLock::AlreadyLocked` error. The lock is released after the block is executed, even if the block raised an error itself.
+
+## Smart lock name
+
+If you prefix the lock with a `.` in a Rails application, `.` will be automatically replaced with `YourAppName.`.

data/lib/db_lock.rb

@@ -0,0 +1,38 @@
+module DBLock
+  class AlreadyLocked < StandardError; end
+
+  class Lock
+    class << self
+      def get(name, timeout=0)
+        timeout = timeout.to_i # catches nil
+        timeout = 0 if timeout < 0
+        raise "invalid lock name: #{name.inspect}" if !name or name.to_s.length == 0
+        raise AlreadyLocked.new("Already lock in progress") if locked?
+        name = prefixed_lock_name(name)
+        res = ActiveRecord::Base.connection.execute("SELECT GET_LOCK('#{name}', #{timeout})")
+        if @locked = (res and res.first and res.first[0] == 1)
+          yield
+        else
+          raise AlreadyLocked.new("Unable to obtain lock '#{name}' within #{timeout} seconds") unless @locked
+        end
+      ensure
+        ActiveRecord::Base.connection.execute("SELECT RELEASE_LOCK('#{name}')") if @locked
+        @locked = false
+      end
+
+      def locked?
+        @locked ||= false
+      end
+
+    private
+
+      def prefixed_lock_name(name)
+        if name[0] == "." and defined? Rails
+          name = "#{Rails.application.class.parent_name}.#{name}"
+        else
+          name
+        end
+      end
+    end
+  end
+end

data/lib/db_lock/version.rb

@@ -0,0 +1,3 @@
+module DBLock
+  VERSION = "0.1"
+end

metadata

@@ -0,0 +1,83 @@
+--- !ruby/object:Gem::Specification
+name: db_lock
+version: !ruby/object:Gem::Version
+  version: '0.1'
+platform: ruby
+authors:
+- mkon
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2014-08-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: activerecord
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '3.0'
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '5'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '3.0'
+description: Obtain manual db locks to guard blocks of code from parallel execution.
+  Currently only supports mysql.
+email:
+- konstantin@munteanu.de
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- MIT-LICENSE
+- README.md
+- lib/db_lock.rb
+- lib/db_lock/version.rb
+homepage: https://github.com/mkon/db_lock
+licenses:
+- MIT
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: Obtain manual db/mysql locks
+test_files: []