elock-client 0.3

data/README.txt

@@ -0,0 +1,10 @@
+Ruby Client for elock
+
+This library provides an easy-to-use ruby client for
+elock (https://github.com/dustin/elock).
+
+== Example Usage (automatic lock management)
+
+    require 'elock-client'
+    l = ELock.new 'localhost'
+    l.with_lock('some_lock') { puts "I got the lock!" }

data/elock-client.gemspec

@@ -0,0 +1,18 @@
+# -*- mode: ruby -*-
+
+require 'time'
+
+Gem::Specification.new do |s|
+  s.name = "elock-client"
+  s.version = `git describe`.gsub('-', '.')
+  s.date = Time.now.strftime '%Y-%m-%d'
+  s.summary = "Ruby client for the elock distributed lock server."
+  s.email = "dustin@spy.net"
+  s.homepage = "http://github.com/dustin/elock-ruby"
+  s.description = "elock-client provides a simple ruby interface to the elock distributed lock server."
+  s.has_rdoc = true
+  s.authors = ["Dustin Sallings"]
+  s.files = ["README.txt", "elock-client.gemspec", "lib/elock-client.rb"]
+  s.rdoc_options = ["--main", "README.txt"]
+  s.extra_rdoc_files = ["README.txt"]
+end

data/lib/elock-client.rb

@@ -0,0 +1,62 @@
+require 'socket'
+require 'fcntl'
+
+# Exception thrown from with_lock when the lock was not acquired.
+class Locked < RuntimeError
+end
+
+# A client for elock.
+class ELock
+
+  # Construct a new ELock client pointed at the given server.
+  def initialize(host, port=11400)
+    connect host, port
+  end
+
+  # Acquire a lock.  This method should return very quickly except in the
+  # case where a timeout is requested and the lock is unavailable.
+  def lock(name, timeout=nil)
+    do_cmd(timeout.nil? ? "lock #{name}" : "lock #{name} #{timeout}")
+  end
+
+  # Release a lock from elock.
+  def unlock(name)
+    do_cmd("unlock #{name}")
+  end
+
+  # Unlock all locks obtained by this client.
+  def unlock_all
+    do_cmd("unlock_all")
+  end
+
+  # Run a block while holding the named lock.
+  # raises Locked if the lock could not be acquired.
+  def with_lock(name, timeout=nil)
+    if lock(name, timeout).first == 200
+      yield
+    else
+      raise Locked
+    end
+  ensure
+    unlock name
+  end
+
+  # Close this connction
+  def close
+    @socket = @socket.close
+  end
+
+  private
+
+  def connect(host, port)
+    @socket = TCPSocket.new(host, port.to_i)
+    @socket.fcntl(Fcntl::F_SETFD, Fcntl::FD_CLOEXEC)
+  end
+
+  def do_cmd(cmd)
+    @socket.write(cmd + "\r\n")
+    res = @socket.gets("\r\n")
+    [res.to_i, res[4..-3]]
+  end
+
+end

metadata

@@ -0,0 +1,58 @@
+--- !ruby/object:Gem::Specification 
+name: elock-client
+version: !ruby/object:Gem::Version 
+  version: "0.3"
+platform: ruby
+authors: 
+- Dustin Sallings
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-10-09 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: elock-client provides a simple ruby interface to the elock distributed lock server.
+email: dustin@spy.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.txt
+files: 
+- README.txt
+- elock-client.gemspec
+- lib/elock-client.rb
+has_rdoc: true
+homepage: http://github.com/dustin/elock-ruby
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --main
+- README.txt
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: Ruby client for the elock distributed lock server.
+test_files: []
+