daemonz 0.3.0

data/MIT-LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 Victor Costan
+
+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.textile

@@ -0,0 +1,68 @@
+h1. Daemonz
+
+bq. Automatically starts and stops the daemons in a Rails application.
+
+h2. Installation
+
+Install with:
+<pre>
+script/plugin install git://github.com/costan/daemonz.git
+</pre>
+
+You don't need to do anything in your code for daemonz to work. It will start
+the daemons when your server starts, and stop them when your server exits. It
+does work with multiple servers.
+
+h2. Configuration
+
+The main configuration file is config/daemonz.yml. Daemons are configured by
+individual files in the config/daemonz directory. Configuration files are ran
+through Erb, so you can go crazy. 
+
+Daemonz comes with a few configuration examples that can also be used as they
+are, by removing the <code>:disabled: true</code> line. Please contribute your
+configuration if you think others could use it.
+
+h2. Daemon Generator
+
+Daemonz includes a generator for a daemon intended to do background processing
+inside a Rails environment. If you're writing your first daemon, give it a try.
+The scaffolded code includes the configuration file, a daemon skeleton using the 
+<code>simple-daemon</code> gem, and an integration test skeleton.
+
+<pre>
+script/generate daemon YourDaemonName
+</pre>
+
+h2. Testing
+
+You can test your daemonz configuration with rake, as shown below. Keep in mind
+that the Rake tasks are only provided for testing, and you should not use them
+while your Rails application is running. Nothing bad should happen if you run
+the tasks by mistake, but things may go astray if you mix the Rake tasks with
+application starts and stops.
+<pre>
+rake daemons:start # Starts your daemons (for testing only)
+rake daemons:stop  # Stops your daemons (for testing only)
+</pre>
+
+Using the default configuration, daemons are not running during tests. The
+snippet below shows how you can have daemons running during a specific test.
+<notextile>
+<pre>
+class DaemonsTest < ActionController::IntegrationTest
+  # If this isn't here, Rails runs the entire test in a transaction, so daemons'
+  # database changes aren't visible. Also, if you share the database with
+  # daemons, sqlite won't cut it.
+  self.use_transactional_fixtures = false
+
+  test "something needing daemons" do
+    Daemonz.with_daemons do
+      # daemons will be alive while this code is executed
+    end
+  end
+end
+</pre>
+</notextile>
+
+p. Copyright (c) 2008 Victor Costan, released under the MIT license

data/Rakefile

@@ -0,0 +1,22 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+
+desc 'Default: run unit tests.'
+task :default => :test
+
+desc 'Test the daemonz plugin.'
+Rake::TestTask.new(:test) do |t|
+  t.libs << 'lib'
+  t.pattern = 'test/**/*_test.rb'
+  t.verbose = true
+end
+
+desc 'Generate documentation for the daemonz plugin.'
+Rake::RDocTask.new(:rdoc) do |rdoc|
+  rdoc.rdoc_dir = 'rdoc'
+  rdoc.title    = 'Daemonz'
+  rdoc.options << '--line-numbers' << '--inline-source'
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('lib/**/*.rb')
+end

data/config_template.yml

@@ -0,0 +1,87 @@
+# Configuration file for the daemonz plugin.
+#
+# For documentation and examples, refer to the original template in
+# vendor/daemonz/config_template.yml
+
+---
+# Descriptions of the daemons to be managed by daemonz.
+#
+# daemonz starts the daemons according to the alphabetic order of their names.
+# start_order can be used to override this order. Daemons will be stored in the
+# reverse order of their starting order.
+#
+# daemonz likes to ensure that multiple instances of a daemon don't run at the
+# same time, as this can be fatal for daemons with on-disk state, like ferret.
+# So daemonz ensures that a daemon is dead before starting it, and right after
+# stopping it. This is achieved using the following means:
+#   * Stop commands: first, daemonz uses the stop command supplied in the daemon
+#                    configuration
+#   * PID files: if the daemon has .pid files, daemonz tries to read the file
+#                and find the corresponding processes, then tree-kills them
+#   * Process table: if possible, daemonz dumps the process table, looks for the 
+#                    processes that look like the daemon, and tree-kills them
+#   * Pattern matching: processes whose command lines have the same arguments as
+#                       those given to daemon "look like" that daemon
+#   * Tree killing: a daemon is killed by killing its main process, together
+#                   with all processes descending from that process; a process
+#                   is first sent SIGTERM and, if it's still alive after a
+#                   couple of seconds, it's sent a SIGKILL
+:daemons: 
+  # Example: configuring ferret.
+  ferret:
+    # Ferret uses different binaries to be started and stopped. 
+    :start_binary: script/ferret_server
+    :stop_binary: script/ferret_server
+    # The arguments to be given to the start and stop commands.
+    # Note that this file is processed with Erb, like your views.
+    :start_args: -e <%= RAILS_ENV %> start
+    :stop_args: -e <%= RAILS_ENV %> stop
+    # Time to wait after sending the stop command, before killing the daemon.
+    :delay_before_kill: 0.35
+    # Pattern for the PID file(s) used by the daemon.
+    :pids: tmp/pids/ferret*.pid
+    # daemonz will ignore this daemon configuration when this flag is true
+    :disabled: true
+  starling: 
+    # The same binary is used to start and stop starling.
+    :binary: starling
+    # The binary name will not be merged with root_path.
+    :absolute_binary: true
+    :start_args: -d -h 127.0.0.1 -p 16020 -P <%= RAILS_ROOT %>/tmp/pids/starling.pid -q <%= RAILS_ROOT %>/tmp -L <%= RAILS_ROOT %>/log/starling.log
+    # No arguments are needed to stop starling.
+    :stop_args: ''
+    # Pattern for the PID file(s) used by the daemon.
+    :pids: tmp/pids/starling*.pid
+    # Override for the patterns used to identify the daemon's processes.
+    :kill_patterns: <%= RAILS_ROOT %>/log/starling.log
+    # Time to wait after sending the stop command, before killing the daemon.
+    :delay_before_kill: 0.2
+    # Override the daemon startup order. Starling consumer daemons should have
+    # their start_order set to 2, so starling is running when they start.
+    :start_order: 1
+    # daemonz will ignore this daemon configuration when this flag is true
+    :disabled: true
+    
+# The base path for daemon binaries specified in binary, start_binary and
+# stop_binary.
+:root_path: <%= RAILS_ROOT %>
+
+# Where daemonz should log - set to stdout, stderr, or rails.
+:logger: stdout
+
+# Set to true to completely disable daemonz, and not load any plugins.
+:disabled: false
+
+# daemonz is loaded every time the Rails framework is loaded. Sometimes
+# (e.g. when performing migrations) daemons aren't required, so we shouldn't
+# have to wait for the few seconds it takes to start / stop daemons.
+
+# Daemons will not be started / stopped when the name of the binary that's
+# loading Rails ($0) is one of the following.
+:disabled_for: 
+- 'rake'
+- 'script/generate'
+
+# Daemons will not be started for the following environments. 
+:disabled_in:
+- 'test'

data/daemonz.gemspec

@@ -0,0 +1,57 @@
+# Generated by jeweler
+# DO NOT EDIT THIS FILE DIRECTLY
+# Instead, edit Jeweler::Tasks in Rakefile, and run the gemspec command
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{daemonz}
+  s.version = "0.3.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
+  s.authors = ["Victor Costan"]
+  s.date = %q{2010-04-18}
+  s.email = %q{victor@costan.us}
+  s.extra_rdoc_files = [
+    "README.textile"
+  ]
+  s.files = [
+    "MIT-LICENSE",
+     "README.textile",
+     "Rakefile",
+     "config_template.yml",
+     "daemonz.gemspec",
+     "init.rb",
+     "lib/daemonz.rb",
+     "lib/daemonz/config.rb",
+     "lib/daemonz/killer.rb",
+     "lib/daemonz/logging.rb",
+     "lib/daemonz/manage.rb",
+     "lib/daemonz/master.rb",
+     "lib/daemonz/process.rb"
+  ]
+  s.homepage = %q{http://github.com/costan/daemonz}
+  s.rdoc_options = ["--charset=UTF-8"]
+  s.require_paths = ["lib"]
+  s.rubygems_version = %q{1.3.6}
+  s.summary = %q{Automatically starts and stops the daemons in a Rails application}
+  s.test_files = [
+    "test/daemonz_test.rb"
+  ]
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+      s.add_runtime_dependency(%q<simple-daemon>, [">= 0"])
+      s.add_runtime_dependency(%q<zerg_support>, [">= 0"])
+    else
+      s.add_dependency(%q<simple-daemon>, [">= 0"])
+      s.add_dependency(%q<zerg_support>, [">= 0"])
+    end
+  else
+    s.add_dependency(%q<simple-daemon>, [">= 0"])
+    s.add_dependency(%q<zerg_support>, [">= 0"])
+  end
+end
+

data/init.rb

@@ -0,0 +1,6 @@
+require 'daemonz'
+
+Daemonz.safe_start
+at_exit do
+  Daemonz.safe_stop unless Daemonz.keep_daemons_at_exit
+end

data/lib/daemonz/config.rb

@@ -0,0 +1,163 @@
+require 'erb'
+require 'yaml'
+
+module Daemonz
+  class << self
+    attr_reader :config
+    
+    # Set by the rake tasks.
+    attr_accessor :keep_daemons_at_exit
+  end
+
+  # compute whether daemonz should be enabled or not
+  def self.disabled?
+    return config[:cached_disabled] if config.has_key? :cached_disabled
+    config[:cached_disabled] = disabled_without_cache!
+  end
+  
+  def self.disabled_without_cache!
+    return true if config[:disabled]
+    return true if config[:disabled_in].include? RAILS_ENV
+    config[:disabled_for].any? do |suffix|
+      suffix == $0[-suffix.length, suffix.length]
+    end
+  end
+  
+  # figure out the plugin's configuration 
+  def self.configure(config_file, options = {})
+    load_configuration config_file
+    
+    config[:root_path] ||= RAILS_ROOT
+    if options[:force_enabled]
+      config[:disabled] = false
+      config[:disabled_for] = []
+      config[:disabled_in] = []
+    else
+      config[:disabled] ||= false
+      config[:disabled_for] ||= ['rake', 'script/generate']
+      config[:disabled_in] ||= ['test']
+    end
+    config[:disabled] = false if config[:disabled] == 'false'
+    config[:master_file] ||= File.join RAILS_ROOT, "tmp", "pids", "daemonz.master.pid"
+    
+    config[:logger] &&= options[:override_logger]
+    self.configure_logger
+
+    if self.disabled?
+      config[:is_master] = false
+    else
+      config[:is_master] = Daemonz.claim_master
+    end
+  end
+    
+  # load and parse the config file
+  def self.load_configuration(config_file)
+    if File.exist? config_file
+      file_contents = File.read config_file
+      erb_result = ERB.new(file_contents).result
+      @config = YAML.load erb_result
+      @config[:daemons] ||= {}
+      
+      config_dir = File.join(File.dirname(config_file), 'daemonz')
+      if File.exist? config_dir
+        Dir.entries(config_dir).each do |entry|
+          daemons_file = File.join(config_dir, entry) 
+          next unless File.file? daemons_file
+          
+          file_contents = File.read daemons_file
+          erb_result = ERB.new(file_contents).result          
+          daemons = YAML.load erb_result
+          daemons.keys.each do |daemon|
+            if @config[:daemons].has_key? daemon
+              logger.warn "Daemonz daemon file #{entry} overwrites daemon #{daemon} defined in daemonz.yml"
+            end
+            @config[:daemons][daemon] = daemons[daemon]
+          end
+        end
+      end
+    else
+      logger.warn "Daemonz configuration not found - #{config_file}"
+      @config = {}
+    end
+  end
+  
+  class << self
+    attr_reader :daemons
+  end
+  
+  # process the daemon configuration
+  def self.configure_daemons    
+    @daemons = []
+    config[:daemons].each do |name, daemon_config|
+      next if daemon_config[:disabled]
+      daemon = { :name => name }
+            
+      # compute the daemon startup / stop commands 
+      ['start', 'stop'].each do |command|
+        daemon_binary = daemon_config[:binary] || daemon_config["#{command}_binary".to_sym]
+        if daemon_config[:absolute_binary]
+          daemon_path = `which #{daemon_binary}`.strip
+          unless daemon_config[:kill_patterns]
+            logger.error "Daemonz ignoring #{name}; using an absolute binary path but no custom process kill patterns"
+            break
+          end
+        else
+          daemon_path = File.join config[:root_path], daemon_binary || ''
+        end
+        unless daemon_binary and File.exists? daemon_path
+          logger.error "Daemonz ignoring #{name}; the #{command} file is missing"
+          break
+        end
+        
+        unless daemon_config[:absolute_binary]
+          begin
+            binary_perms = File.stat(daemon_path).mode
+            if binary_perms != (binary_perms | 0111)
+              File.chmod(binary_perms | 0111, daemon_path)
+            end
+          rescue Exception => e
+            # chmod might fail due to lack of permissions
+            logger.error "Daemonz failed to make #{name} binary executable - #{e.class.name}: #{e}\n"
+            logger.info e.backtrace.join("\n") + "\n"
+          end
+        end
+        
+        daemon_args = daemon_config[:args] || daemon_config["#{command}_args".to_sym]
+        daemon_cmdline = "#{daemon_path} #{daemon_args}"
+        daemon[command.to_sym] = {:path => daemon_path, :cmdline => daemon_cmdline}
+      end
+      next unless daemon[:stop]
+      
+      # kill patterns
+      daemon[:kill_patterns] = daemon_config[:kill_patterns] || [daemon[:start][:path]]
+      
+      # pass-through params
+      daemon[:pids] = daemon_config[:pids]
+      unless daemon[:pids]
+        logger.error "Daemonz ignoring #{name}; no pid file pattern specified"
+        next
+      end
+      daemon[:delay_before_kill] = daemon_config[:delay_before_kill] || 0.2
+      daemon[:start_order] = daemon_config[:start_order]
+      
+      @daemons << daemon
+    end
+    
+    # sort by start_order, then by name
+    @daemons.sort! do |a, b|
+      if a[:start_order]
+        if b[:start_order]
+          if a[:start_order] != b[:start_order]
+            next a[:start_order] <=> b[:start_order]
+          else
+            next a[:name] <=> b[:name]
+          end
+        else
+          next 1
+        end
+      else
+        next a[:name] <=> b[:name]
+      end
+    end
+  end
+end

data/lib/daemonz/killer.rb

@@ -0,0 +1,64 @@
+require 'English'
+
+module Daemonz
+  # Complex procedure for killing a process or a bunch of process replicas
+  # kill_command is the script that's supposed to kill the process / processes (tried first)
+  # pid_patters are globs identifying PID files (a file can match any of the patterns)
+  # process_patterns are strings that should show on a command line (a process must match all)  
+  # options:
+  #   :verbose - log what gets killed
+  #   :script_delay - the amount of seconds to sleep after launching the kill script
+  #   :force_script - the kill script is executed even if there are no PID files
+  def self.kill_process_set(kill_script, pid_patterns, process_patterns, options = {})
+    # Phase 1: kill order (only if there's a PID file)
+    pid_patterns = [pid_patterns] unless pid_patterns.kind_of? Enumerable
+    unless options[:force_script]
+      pid_files = pid_patterns.map { |pattern| Dir.glob(pattern) }.flatten
+    end
+    if options[:force_script] or !(pid_files.empty? or kill_script.nil?)
+      logger.info "Issuing kill order: #{kill_script}\n" if options[:verbose]
+      success = Kernel.system kill_script unless kill_script.nil?
+      if !success and options[:verbose]
+        logger.warn "Kill order failed with exit code #{$CHILD_STATUS.exitstatus}"
+      end
+
+      deadline_time = Time.now + (options[:script_delay] || 0.5)
+      while Time.now < deadline_time
+        pid_files = pid_patterns.map { |pattern| Dir.glob(pattern) }.flatten
+        break if pid_files.empty?
+        sleep 0.05
+      end
+    end
+    
+    # Phase 2: look through PID files and issue kill orders
+    pinfo = process_info()
+    pid_files = pid_patterns.map { |pattern| Dir.glob(pattern) }.flatten
+    pid_files.each do |fname|
+      begin
+        pid = File.open(fname, 'r') { |f| f.read.strip! }
+        process_cmdline = pinfo[pid][:cmdline]
+        # avoid killing innocent victims
+        if pinfo[pid].nil? or process_patterns.all? { |pattern| process_cmdline.index pattern } 
+          logger.warn "Killing #{pid}: #{process_cmdline}" if options[:verbose]
+          Process.kill 'TERM', pid.to_i
+        end
+      rescue
+        # just in case the file gets wiped before we see it
+      end
+      begin
+        logger.warn "Deleting #{fname}" if options[:verbose]
+        File.delete fname if File.exists? fname
+      rescue
+        # prevents crashing if the file is wiped after we call exists?
+      end
+    end
+    
+    # Phase 3: look through the process table and kill anything that looks good
+    pinfo = process_info()
+    pinfo.each do |pid, info|
+      next unless process_patterns.all? { |pattern| info[:cmdline].index pattern }
+      logger.warn "Killing #{pid}: #{pinfo[pid][:cmdline]}" if options[:verbose]
+      Process.kill 'TERM', pid.to_i
+    end
+  end
+end

data/lib/daemonz/logging.rb

@@ -0,0 +1,19 @@
+module Daemonz
+  @logger = RAILS_DEFAULT_LOGGER
+  class <<self
+    attr_reader :logger
+  end
+  
+  def self.configure_logger
+    case config[:logger]
+    when 'stdout'
+      @logger = Logger.new(STDOUT)
+      @logger.level = Logger::DEBUG
+    when 'stderr'
+      @logger = Logger.new(STDERR)
+      @logger.level = Logger::DEBUG
+    when 'rails'
+      @logger = RAILS_DEFAULT_LOGGER
+    end
+  end
+end

data/lib/daemonz/manage.rb

@@ -0,0 +1,69 @@
+require 'English'
+
+module Daemonz
+  # Starts daemons, yields, stops daemons. Intended for tests.
+  def self.with_daemons(logger = 'rails')
+    begin
+      safe_start :force_enabled => true, :override_logger => logger
+      yield
+    ensure
+      safe_stop :force_enabled => true
+    end
+  end
+  
+  # Complete startup used by rake:start and at Rails plug-in startup.
+  def self.safe_start(options = {})
+    daemonz_config = File.join(RAILS_ROOT, 'config', 'daemonz.yml')
+    Daemonz.configure daemonz_config, options
+    
+    if Daemonz.config[:is_master]
+      Daemonz.configure_daemons
+      Daemonz.start_daemons!
+    end    
+  end
+  
+  # Complete shutdown used by rake:start and at Rails application exit.
+  def self.safe_stop(options = {})
+    if options[:configure]
+      daemonz_config = File.join(RAILS_ROOT, 'config', 'daemonz.yml')
+      Daemonz.configure daemonz_config, options
+    end
+    if Daemonz.config[:is_master]
+      if options[:configure]
+        Daemonz.configure_daemons
+      end
+      Daemonz.stop_daemons!
+      Daemonz.release_master_lock
+    end
+  end
+    
+  def self.start_daemons!
+    @daemons.each { |daemon| start_daemon! daemon }
+  end
+  
+  def self.stop_daemons!
+    @daemons.reverse.each { |daemon| stop_daemon! daemon }
+  end
+  
+  def self.start_daemon!(daemon)
+    # cleanup before we start
+    kill_process_set daemon[:stop][:cmdline], daemon[:pids],
+                     daemon[:kill_patterns],
+                     :script_delay => daemon[:delay_before_kill],
+                     :verbose => true, :force_script => false
+      
+    logger.info "Daemonz starting #{daemon[:name]}: #{daemon[:start][:cmdline]}"
+    success = Kernel.system daemon[:start][:cmdline]
+    unless success
+      logger.warn "Daemonz start script for #{daemon[:name]} failed " +
+                  "with code #{$CHILD_STATUS.exitstatus}"
+    end
+  end
+  
+  def self.stop_daemon!(daemon)
+    kill_process_set daemon[:stop][:cmdline], daemon[:pids],
+                     daemon[:kill_patterns],
+                     :script_delay => daemon[:delay_before_kill],
+                     :verbose => true, :force_script => true
+  end  
+end

data/lib/daemonz/master.rb

@@ -0,0 +1,59 @@
+require 'English'
+
+module Daemonz
+  def self.release_master_lock
+    if File.exist? config[:master_file]
+      File.delete config[:master_file]
+    else
+      logger.warn "Master lock removed by someone else"
+    end
+  end
+  
+  def self.grab_master_lock
+    loop do
+      File.open(config[:master_file], File::CREAT | File::RDWR) do |f|
+        if f.flock File::LOCK_EX
+          lock_data = f.read
+          lock_data = lock_data[lock_data.index(/\d/), lock_data.length] if lock_data.index /\d/          
+          master = lock_data.split("\n", 2)
+          
+          if master.length == 2
+            master_pid = master[0].to_i            
+            master_cmdline = master[1]
+            if master_pid != 0
+              master_pinfo = process_info(master_pid)
+              return master_pid if master_pinfo and master_pinfo[:cmdline] == master_cmdline
+             
+              logger.info "Old master (PID #{master_pid}) died; breaking master lock"            
+            end            
+          end
+          
+          f.truncate 0
+          f.write "#{$PID}\n#{process_info($PID)[:cmdline]}"
+          f.flush
+          return nil
+        end
+      end
+    end
+  end
+  
+  # attempts to claim the master lock
+  def self.claim_master
+    loop do
+      begin
+        # try to grab that lock
+        master_pid = grab_master_lock
+        if master_pid
+          logger.info "Daemonz in slave mode; PID #{master_pid} has master lock"
+          return false
+        else
+          logger.info "Daemonz grabbed master lock"
+          return true
+        end        
+      #rescue Exception => e
+      #  logger.warn "Daemonz mastering failed: #{e.class.name} - #{e}"
+      #  logger.info "Retrying daemonz mastering"
+      end
+    end
+  end
+end

data/lib/daemonz/process.rb

@@ -0,0 +1,74 @@
+# Mocks the sys-proctable gem using ps.
+#
+# This is useful even if sys-proctable is available, because it may fail for
+# random reasons.
+module Daemonz::ProcTable
+  class ProcInfo
+    def initialize(pid, cmdline)
+      @pid = pid
+      @cmdline = cmdline
+    end
+    attr_reader :pid, :cmdline
+  end
+
+  def self.ps_emulation
+    retval = []
+    ps_output = `ps ax`
+    ps_output.each_line do |pline|
+      pdata = pline.split(nil, 5)
+      pinfo = ProcInfo.new(pdata[0].strip, pdata[4].strip)
+      retval << pinfo
+    end
+    return retval
+  end
+end
+
+begin
+  require 'sys/proctable'
+  if Sys::ProcTable::VERSION == '0.7.6'
+    raise LoadError, 'Buggy sys/proctable, emulate'
+  end
+  
+  module Daemonz::ProcTable
+    def self.ps
+      # We don't use ps_emulation all the time because sys-proctable is
+      # faster. We only pay the performance penalty when sys-proctable fails.
+      begin
+        Sys::ProcTable.ps
+      rescue Exception
+        self.ps_emulation
+      end
+    end
+  end
+rescue LoadError
+  # The accelerated version is not available, use the slow version all the time.
+  
+  module Daemonz::ProcTable
+    def self.ps
+      self.ps_emulation
+    end
+  end
+end
+
+module Daemonz 
+  # returns information about a process or all the running processes
+  def self.process_info(pid = nil)
+    info = Hash.new
+    
+    Daemonz::ProcTable.ps.each do |process|
+      item = { :cmdline => process.cmdline, :pid => process.pid.to_s }
+
+      if pid.nil?
+        info[process.pid.to_s] = item
+      else
+        return item if item[:pid].to_s == pid.to_s
+      end
+    end
+    
+    if pid.nil?
+      return info
+    else
+      return nil
+    end
+  end
+end

data/lib/daemonz.rb

@@ -0,0 +1,10 @@
+module Daemonz
+  
+end
+
+require 'daemonz/config.rb'
+require 'daemonz/killer.rb'
+require 'daemonz/logging.rb'
+require 'daemonz/manage.rb'
+require 'daemonz/master.rb'
+require 'daemonz/process.rb'

data/test/daemonz_test.rb

@@ -0,0 +1,8 @@
+require 'test/unit'
+
+class DaemonzTest < Test::Unit::TestCase
+  # Replace this with your real tests.
+  def test_this_plugin
+    flunk
+  end
+end

metadata

@@ -0,0 +1,97 @@
+--- !ruby/object:Gem::Specification 
+name: daemonz
+version: !ruby/object:Gem::Version 
+  prerelease: false
+  segments: 
+  - 0
+  - 3
+  - 0
+  version: 0.3.0
+platform: ruby
+authors: 
+- Victor Costan
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2010-04-18 00:00:00 -04:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: simple-daemon
+  prerelease: false
+  requirement: &id001 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id001
+- !ruby/object:Gem::Dependency 
+  name: zerg_support
+  prerelease: false
+  requirement: &id002 !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        segments: 
+        - 0
+        version: "0"
+  type: :runtime
+  version_requirements: *id002
+description: 
+email: victor@costan.us
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.textile
+files: 
+- MIT-LICENSE
+- README.textile
+- Rakefile
+- config_template.yml
+- daemonz.gemspec
+- init.rb
+- lib/daemonz.rb
+- lib/daemonz/config.rb
+- lib/daemonz/killer.rb
+- lib/daemonz/logging.rb
+- lib/daemonz/manage.rb
+- lib/daemonz/master.rb
+- lib/daemonz/process.rb
+has_rdoc: true
+homepage: http://github.com/costan/daemonz
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --charset=UTF-8
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      segments: 
+      - 0
+      version: "0"
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.6
+signing_key: 
+specification_version: 3
+summary: Automatically starts and stops the daemons in a Rails application
+test_files: 
+- test/daemonz_test.rb