gearmand_control 0.1.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: 0b8acdbc56b4bd1bb5c5aac2ea18613c1a94c67b
+  data.tar.gz: fcb0e60e0b742060f82f74c6a3a25ae57c0dafb1
+SHA512:
+  metadata.gz: 196468b61ccca58223a6679f0c7d165c3c1dce7757e5b298838891b068a071bedc13bc2e5897e799749fdb42c93a2c678664f6cac6ee543db140d9fd593a2739
+  data.tar.gz: c798c920422dbc53de5a668acb5740a870fb20d8a55998a949e9cb2e48cb8c5cae1f441fe292dadad50238f9ff912711c48e34c6cfe6e9faf532a96eb17469b8

data/README.markdown

@@ -0,0 +1,30 @@
+# GearmandControl
+
+Control a [gearmand] process with Ruby. In writing Gearman workers and clients, I've found this useful when running integration tests.
+
+## Example
+
+```ruby
+# start gearmand, listening on 4730
+gearmand = GearmandControl.new
+gearmand.start
+
+# attempt to open a TCP connection on localhost:4730
+# raises GearmandControl::TestFailed if it cannot
+gearmand.test!
+
+# get the process's PID
+gearmand.pid
+
+# have we started?
+gearman.started?
+
+# stop gearmand
+gearmand.stop
+```
+
+## TODO
+
+- `gearmand` takes a number of options. Make it easy to set those.
+
+[gearmand]: http://gearman.org/

data/lib/gearmand_control/version.rb

@@ -0,0 +1,3 @@
+class GearmandControl
+  VERSION = "0.1.0"
+end

data/lib/gearmand_control.rb

@@ -0,0 +1,58 @@
+require 'socket'
+require 'timeout'
+
+class GearmandControl
+
+  UNSTARTED = :unstarted unless defined? UNSTARTED
+
+  class TestFailed < RuntimeError ; end
+
+  attr_reader :address
+  
+  def initialize(port)
+    @port = port
+    @command = 'gearmand'
+    @io = UNSTARTED
+    @address = ['localhost', port].join(':')
+  end
+
+  def pid
+    started? ? @io.pid : -1
+  end
+
+  def start
+    process = [@command, '-p', @port]
+    @io = IO.popen(process.map(&method(:String)))
+  end
+
+  def started?
+    @io != UNSTARTED
+  end
+
+  def stop(signal = :TERM)
+    if started?
+      Process.kill(signal, pid)
+      @io.close
+      @io = UNSTARTED
+    end
+  end
+
+  def test!
+    socket = nil
+
+    Timeout.timeout(0.5, TestFailed) do
+      begin
+        socket = TCPSocket.new('localhost', 4730)
+      rescue Errno::ECONNREFUSED
+        sleep (rand / 100.0)
+
+        retry
+      ensure
+        socket.close unless socket.nil?
+      end
+    end
+
+    true
+  end
+
+end

data/spec/gearmand_control_spec.rb

@@ -0,0 +1,49 @@
+require 'gearmand_control'
+
+describe GearmandControl do
+
+  before do
+    @control = GearmandControl.new(4730)
+  end
+
+  after do
+    @control.stop
+  end
+
+  it 'starts gearmand' do
+    @control.start
+
+    expect(Process.getsid(@control.pid)).to be_a(Fixnum)
+  end
+
+  it 'stops gearmand' do
+    @control.start
+    pid = @control.pid
+    @control.stop
+
+    expect do
+      Process.getsid(pid)
+    end.to raise_error(Errno::ESRCH)
+  end
+
+  it 'tests succesfully after starting gearmand' do
+    @control.start
+
+    expect do
+      @control.test!
+    end.to_not raise_error
+  end
+
+  it 'raises if its test fails' do
+    expect do
+      @control.test!
+    end.to raise_error(GearmandControl::TestFailed)
+  end
+
+  it 'knows if the daemon has been started' do
+    @control.start
+
+    expect(@control).to be_started
+  end
+
+end

metadata

@@ -0,0 +1,76 @@
+--- !ruby/object:Gem::Specification
+name: gearmand_control
+version: !ruby/object:Gem::Version
+  version: 0.1.0
+platform: ruby
+authors:
+- Brian
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-02 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: bundler
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+- !ruby/object:Gem::Dependency
+  name: rspec
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: Ruby wrapper around running gearmand
+email:
+- bcobb@uwalumni.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- lib/gearmand_control/version.rb
+- lib/gearmand_control.rb
+- README.markdown
+- spec/gearmand_control_spec.rb
+homepage: http://github.com/bcobb/gearmand_control
+licenses: []
+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.0.3
+signing_key: 
+specification_version: 4
+summary: Control gearmand with Ruby
+test_files:
+- spec/gearmand_control_spec.rb