lsof 0.1.0

data/README

@@ -0,0 +1,8 @@
+= Lsof
+Lsof has some utility functions that allow you to manage processes using the unix lsof command.
+Functions include getting the pid and killing a process that listens on a particular port.
+
+== Usage
+  Lsof.running?(6666) # returns true if there is the process that listens on port 6666
+  Lsof.kill(6666) # kill the process that listens on port 6666
+  Lsof.listener_pid(6666) # returns the process id for the process that listens on port 6666

data/Rakefile

@@ -0,0 +1,69 @@
+require "rake"
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc "Runs the Rspec suite"
+task(:default) do
+  run_suite
+end
+
+desc "Runs the Rspec suite"
+task(:spec) do
+  run_suite
+end
+
+desc "Copies the trunk to a tag with the name of the current release"
+task(:tag_release) do
+  tag_release
+end
+
+def run_suite
+  dir = File.dirname(__FILE__)
+  system("ruby #{dir}/spec/spec_suite.rb") || raise("Spec Suite failed")
+end
+
+PKG_NAME = "lsof"
+PKG_VERSION = "0.1.0"
+PKG_FILES = FileList[
+  '[A-Z]*',
+  '*.rb',
+  'lib/**/*.rb',
+  'spec/**/*.rb'
+]
+
+spec = Gem::Specification.new do |s|
+  s.name = PKG_NAME
+  s.version = PKG_VERSION
+  s.summary = "A library utilizing the lsof unix command for process management."
+  s.test_files = "spec/spec_suite.rb"
+  s.description = s.summary
+
+  s.files = PKG_FILES.to_a
+  s.require_path = 'lib'
+
+  s.has_rdoc = true
+  s.extra_rdoc_files = [ "README", "CHANGES" ]
+  s.rdoc_options = ["--main", "README", "--inline-source", "--line-numbers"]
+
+  s.test_files = Dir.glob('spec/*_spec.rb')
+  s.require_path = 'lib'
+  s.autorequire = 'lsof'
+  s.author = "Corey Innis + Brian Takita"
+  s.email = "corey@pivotallabs.com;brian@pivotallabs.com;"
+  s.homepage = "http://pivotallabs.com"
+  s.rubyforge_project = "pivotalrb"
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.need_zip = true
+  pkg.need_tar = true
+end
+
+def tag_release
+  dashed_version = PKG_VERSION.gsub('.', '-')
+  svn_user = "#{ENV["SVN_USER"]}@" || ""
+  `svn cp svn+ssh://#{svn_user}rubyforge.org/var/svn/pivotalrb/lsof/trunk svn+ssh://#{svn_user}rubyforge.org/var/svn/pivotalrb/lsof/tags/REL-#{dashed_version} -m 'Version #{PKG_VERSION}'`
+end

data/lib/lsof.rb

@@ -0,0 +1,21 @@
+class Lsof
+  class << self
+    def kill(port)
+      pid = listener_pid(port)
+      system "kill -9 #{pid}" if pid
+    end
+
+    def running?(port)
+      listener_pid(port) ? true : false
+    end
+
+    def listener_pid(port)
+      port = `lsof -i tcp:#{port} | grep '(LISTEN)' | awk '{print $2}'`
+      if port.empty?
+        nil
+      else
+        Integer(port)
+      end
+    end
+  end
+end

data/spec/lsof_spec.rb

@@ -0,0 +1,90 @@
+require "#{File.dirname(__FILE__)}/spec_helper"
+
+describe Lsof do
+  include WaitFor
+  include FileUtils
+  attr_reader :port, :pid_of_process
+  before do
+    @port = 6666
+  end
+
+  after do
+    hide_error_stream do
+      Lsof.kill port
+    end
+
+    rm_rf "lsof.pid"
+  end
+
+  def start_process_using_port
+    Thread.start do
+      cmd = <<-CMD
+        ruby -e '
+                  File.open("lsof.pid", "w") do |file|
+                    file.print Process.pid.to_s
+                  end
+                  require "rubygems"
+                  require "eventmachine"
+                  EventMachine::run do
+                    EventMachine::start_server "127.0.0.1", #{port}, EventMachine::Protocols::LineAndTextProtocol
+                  end
+                '2>&1
+      CMD
+      `#{cmd}`
+    end
+    wait_for do
+      Lsof.running?(port)
+    end
+    @pid_of_process = Integer(File.read("lsof.pid"))
+    pid_of_process.should_not be_nil
+    pid_of_process.class.should == Fixnum
+  end
+
+  def hide_error_stream
+    old_stderr = $stderr
+    begin
+      $stderr = StringIO.new
+      yield
+    rescue Exception => e
+      $stderr = old_stderr
+      raise e
+    ensure
+      $stderr = old_stderr
+    end
+  end
+
+  describe '.kill' do
+    it "kills all processes associated with a provided port" do
+      start_process_using_port
+      hide_error_stream do
+        Lsof.kill port
+      end
+      wait_for do
+        !Lsof.running?(port)
+      end
+    end
+  end
+
+  describe '.running?' do
+    it "when there is a process is using the port, returns true" do
+      start_process_using_port
+      Lsof.running?(port).should be_true
+    end
+
+    it "when there is no process using the port, returns false" do
+      Lsof.running?(port).should be_false
+    end
+  end
+
+  describe ".listener_pid" do
+    it "when there is a process listening on a port, returns the process id" do
+      start_process_using_port
+      pid = Lsof.listener_pid(port)
+      pid.should == pid_of_process
+    end
+
+    it "when there is no process listening on a port, returns nil" do
+      Lsof.listener_pid(port).should == nil
+    end
+  end
+end

data/spec/spec_helper.rb

@@ -0,0 +1,22 @@
+require "rubygems"
+require "spec"
+dir = File.dirname(__FILE__)
+$LOAD_PATH.unshift File.expand_path("#{dir}/../lib")
+require "lsof"
+require "rr"
+require "fileutils"
+require "eventmachine"
+
+Spec::Runner.configure do |config|
+  config.mock_with :rr
+end
+
+module WaitFor
+  def wait_for(seconds=5)
+    Timeout.timeout(seconds) do
+      loop do
+        break if yield
+      end
+    end
+  end
+end

data/spec/spec_suite.rb

@@ -0,0 +1,12 @@
+class SpecSuite
+  def run
+    dir = File.dirname(__FILE__)
+    Dir["#{dir}/**/*_spec.rb"].each do |file|
+      require file
+    end
+  end
+end
+
+if __FILE__ == $0
+  SpecSuite.new.run
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+rubygems_version: 0.9.4
+specification_version: 1
+name: lsof
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+date: 2007-12-28 00:00:00 -08:00
+summary: A library utilizing the lsof unix command for process management.
+require_paths: 
+- lib
+email: corey@pivotallabs.com;brian@pivotallabs.com;
+homepage: http://pivotallabs.com
+rubyforge_project: pivotalrb
+description: A library utilizing the lsof unix command for process management.
+autorequire: lsof
+default_executable: 
+bindir: bin
+has_rdoc: true
+required_ruby_version: !ruby/object:Gem::Version::Requirement 
+  requirements: 
+  - - ">"
+    - !ruby/object:Gem::Version 
+      version: 0.0.0
+  version: 
+platform: ruby
+signing_key: 
+cert_chain: 
+post_install_message: 
+authors: 
+- Corey Innis + Brian Takita
+files: 
+- CHANGES
+- Rakefile
+- README
+- lib/lsof.rb
+- spec/lsof_spec.rb
+- spec/spec_helper.rb
+- spec/spec_suite.rb
+test_files: 
+- spec/lsof_spec.rb
+rdoc_options: 
+- --main
+- README
+- --inline-source
+- --line-numbers
+extra_rdoc_files: 
+- README
+- CHANGES
+executables: []
+
+extensions: []
+
+requirements: []
+
+dependencies: []
+