dustin-elock-client 0.1

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/lib/elock-client.rb

@@ -0,0 +1,53 @@
+require 'socket'
+require 'fcntl'
+
+# 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.
+  def with_lock(name, timeout=nil)
+    yield if lock(name, timeout).first == 200 
+  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,56 @@
+--- !ruby/object:Gem::Specification 
+name: dustin-elock-client
+version: !ruby/object:Gem::Version 
+  version: "0.1"
+platform: ruby
+authors: 
+- Dustin Sallings
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2008-05-29 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
+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.0.1
+signing_key: 
+specification_version: 2
+summary: Ruby client for the elock distributed lock server.
+test_files: []
+