demon 0.0.666

data/README.md

@@ -0,0 +1,108 @@
+### NAME
+
+  demon.rb - the ruby daemon library you've been waiting for
+
+### SYNOPSIS
+
+  a small, flexible, powerful ruby daemon library
+
+### DESCRIPTION
+
+  demon.rb aims to make it simple to construct extremely well behaved daemon
+  programs in no time.
+
+  it supports both a DSL and object oriented interface to sound unix daemon
+  code.  unlike some daemon libraries, it makes zero assumptions about how you
+  want to organize your code - although some sane defaults exists to help you
+  along if you don't what to think about this at all.
+
+### INSTALL
+
+  gem 'demon'
+
+### USAGE
+
+simple usage is simple...
+
+````ruby
+
+#! /usr/bin/env ruby
+
+# file: a.rb
+
+Demon do
+  loop do
+    stuff_as_a_daemon
+  end
+end
+
+
+````
+
+````bash
+
+  ./a.rb help 
+
+````
+
+````yaml
+
+  ---
+  start: start in daemon mode
+  run: run in the foreground, but otherwise like a daemon
+  stop: stop any currently running daemon
+  restart: restart any currently running daemon, or start a new one
+  pid: print the pid of the running daemon, iff any
+  ping: ensure a daemon is running, start one iff not
+  signal: hit the daemon, if any, with SIGUSR2
+  tail: tail -F all auxillary files (lock files, logs, etc)
+  fuser: report the fuser of any auxillary files (lock files, logs, etc)
+  log: display the location of the log file
+  root: display the location of the root daemon dir (lock files, logs, etc)
+  modes: print all modes, even those without "help"
+  help: this message
+
+
+````
+
+a few things to notice about the above daemon:
+
+* daemons are *expected* to run for a long time.  demon.rb will run the supplied block over and over (aka. it is an implied loop)
+* if the supplied block blows up the error will be logged, and the block retried.  we assume you mean to keep your daemon up.
+* the actual script being run must be know to demon.rb.  you can let it know by passing a block, or supplying __FILE__ as the first arugment
+
+````ruby
+
+Demon __FILE__ do
+  # stuff
+end
+
+````
+
+
+of course, you can have much more find grained control over your daemons
+
+
+````ruby
+  class MyProgram 
+    def run
+      loop do
+        teh_awesome
+      end
+    end
+
+    def daemonize!
+      program = self
+
+      demon.start{ program.run }
+    end
+
+    def pid 
+      demon.run(:pid)
+    end
+
+    def demon
+      @demon ||= Demon.new(__FILE__, :root => '~/.my_progarm/')
+    end
+  end
+````

data/Rakefile

@@ -0,0 +1,374 @@
+This.rubyforge_project = 'codeforpeople'
+This.author = "Ara T. Howard"
+This.email = "ara.t.howard@gmail.com"
+This.homepage = "https://github.com/ahoward/#{ This.lib }"
+
+task :license do
+  open('LICENSE', 'w'){|fd| fd.puts "same as ruby's"}
+end
+
+task :default do
+  puts((Rake::Task.tasks.map{|task| task.name.gsub(/::/,':')} - ['default']).sort)
+end
+
+task :test do
+  run_tests!
+end
+
+namespace :test do
+  task(:unit){ run_tests!(:unit) }
+  task(:functional){ run_tests!(:functional) }
+  task(:integration){ run_tests!(:integration) }
+end
+
+def run_tests!(which = nil)
+  which ||= '**'
+  test_dir = File.join(This.dir, "test")
+  test_glob ||= File.join(test_dir, "#{ which }/**_test.rb")
+  test_rbs = Dir.glob(test_glob).sort
+        
+  div = ('=' * 119)
+  line = ('-' * 119)
+
+  test_rbs.each_with_index do |test_rb, index|
+    testno = index + 1
+    command = "#{ This.ruby } -w -I ./lib -I ./test/lib #{ test_rb }"
+
+    puts
+    say(div, :color => :cyan, :bold => true)
+    say("@#{ testno } => ", :bold => true, :method => :print)
+    say(command, :color => :cyan, :bold => true)
+    say(line, :color => :cyan, :bold => true)
+
+    system(command)
+
+    say(line, :color => :cyan, :bold => true)
+
+    status = $?.exitstatus
+
+    if status.zero? 
+      say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      say("SUCCESS", :color => :green, :bold => true)
+    else
+      say("@#{ testno } <= ", :bold => true, :color => :white, :method => :print)
+      say("FAILURE", :color => :red, :bold => true)
+    end
+    say(line, :color => :cyan, :bold => true)
+
+    exit(status) unless status.zero?
+  end
+end
+
+
+task :gemspec do
+  ignore_extensions = ['git', 'svn', 'tmp', /sw./, 'bak', 'gem']
+  ignore_directories = ['pkg']
+  ignore_files = ['test/log']
+
+  shiteless = 
+    lambda do |list|
+      list.delete_if do |entry|
+        next unless test(?e, entry)
+        extension = File.basename(entry).split(%r/[.]/).last
+        ignore_extensions.any?{|ext| ext === extension}
+      end
+      list.delete_if do |entry|
+        next unless test(?d, entry)
+        dirname = File.expand_path(entry)
+        ignore_directories.any?{|dir| File.expand_path(dir) == dirname}
+      end
+      list.delete_if do |entry|
+        next unless test(?f, entry)
+        filename = File.expand_path(entry)
+        ignore_files.any?{|file| File.expand_path(file) == filename}
+      end
+    end
+
+  lib         = This.lib
+  object      = This.object
+  version     = This.version
+  files       = shiteless[Dir::glob("**/**")]
+  executables = shiteless[Dir::glob("bin/*")].map{|exe| File.basename(exe)}
+  #has_rdoc    = true #File.exist?('doc')
+  test_files  = "test/#{ lib }.rb" if File.file?("test/#{ lib }.rb")
+  summary     = object.respond_to?(:summary) ? object.summary : "summary: #{ lib } kicks the ass"
+  description = object.respond_to?(:description) ? object.description : "description: #{ lib } kicks the ass"
+
+  if This.extensions.nil?
+    This.extensions = []
+    extensions = This.extensions
+    %w( Makefile configure extconf.rb ).each do |ext|
+      extensions << ext if File.exists?(ext)
+    end
+  end
+  extensions = [extensions].flatten.compact
+
+  template = 
+    if test(?e, 'gemspec.erb')
+      Template{ IO.read('gemspec.erb') }
+    else
+      Template {
+        <<-__
+          ## #{ lib }.gemspec
+          #
+
+          Gem::Specification::new do |spec|
+            spec.name = #{ lib.inspect }
+            spec.version = #{ version.inspect }
+            spec.platform = Gem::Platform::RUBY
+            spec.summary = #{ lib.inspect }
+            spec.description = #{ description.inspect }
+
+            spec.files =\n#{ files.sort.pretty_inspect }
+            spec.executables = #{ executables.inspect }
+            
+            spec.require_path = "lib"
+
+            spec.test_files = #{ test_files.inspect }
+
+          ### spec.add_dependency 'lib', '>= version'
+          #### spec.add_dependency 'map'
+
+            spec.extensions.push(*#{ extensions.inspect })
+
+            spec.rubyforge_project = #{ This.rubyforge_project.inspect }
+            spec.author = #{ This.author.inspect }
+            spec.email = #{ This.email.inspect }
+            spec.homepage = #{ This.homepage.inspect }
+          end
+        __
+      }
+    end
+
+  Fu.mkdir_p(This.pkgdir)
+  gemspec = "#{ lib }.gemspec"
+  open(gemspec, "w"){|fd| fd.puts(template)}
+  This.gemspec = gemspec
+end
+
+task :gem => [:clean, :gemspec] do
+  Fu.mkdir_p(This.pkgdir)
+  before = Dir['*.gem']
+  cmd = "gem build #{ This.gemspec }"
+  `#{ cmd }`
+  after = Dir['*.gem']
+  gem = ((after - before).first || after.first) or abort('no gem!')
+  Fu.mv(gem, This.pkgdir)
+  This.gem = File.join(This.pkgdir, File.basename(gem))
+end
+
+task :readme do
+  samples = ''
+  prompt = '~ > '
+  lib = This.lib
+  version = This.version
+
+  Dir['sample*/*'].sort.each do |sample|
+    samples << "\n" << "  <========< #{ sample } >========>" << "\n\n"
+
+    cmd = "cat #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+    samples << Util.indent(`#{ cmd }`, 4) << "\n"
+
+    cmd = "ruby #{ sample }"
+    samples << Util.indent(prompt + cmd, 2) << "\n\n"
+
+    cmd = "ruby -e'STDOUT.sync=true; exec %(ruby -I ./lib #{ sample })'"
+    samples << Util.indent(`#{ cmd } 2>&1`, 4) << "\n"
+  end
+
+  template = 
+    if test(?e, 'readme.erb')
+      Template{ IO.read('readme.erb') }
+    else
+      Template {
+        <<-__
+          NAME
+            #{ lib }
+
+          DESCRIPTION
+
+          INSTALL
+            gem install #{ lib }
+
+          SAMPLES
+            #{ samples }
+        __
+      }
+    end
+
+  open("README", "w"){|fd| fd.puts template}
+end
+
+
+task :clean do
+  Dir[File.join(This.pkgdir, '**/**')].each{|entry| Fu.rm_rf(entry)}
+end
+
+
+task :release => [:clean, :gemspec, :gem] do
+  gems = Dir[File.join(This.pkgdir, '*.gem')].flatten
+  raise "which one? : #{ gems.inspect }" if gems.size > 1
+  raise "no gems?" if gems.size < 1
+
+  cmd = "gem push #{ This.gem }"
+  puts cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+
+  cmd = "rubyforge login && rubyforge add_release #{ This.rubyforge_project } #{ This.lib } #{ This.version } #{ This.gem }"
+  puts cmd
+  puts
+  system(cmd)
+  abort("cmd(#{ cmd }) failed with (#{ $?.inspect })") unless $?.exitstatus.zero?
+end
+
+
+
+
+
+BEGIN {
+# support for this rakefile
+#
+  $VERBOSE = nil
+
+  require 'ostruct'
+  require 'erb'
+  require 'fileutils'
+  require 'rbconfig'
+  require 'pp'
+
+# fu shortcut
+#
+  Fu = FileUtils
+
+# cache a bunch of stuff about this rakefile/environment
+#
+  This = OpenStruct.new
+
+  This.file = File.expand_path(__FILE__)
+  This.dir = File.dirname(This.file)
+  This.pkgdir = File.join(This.dir, 'pkg')
+
+# grok lib
+#
+  lib = ENV['LIB']
+  unless lib
+    lib = File.basename(Dir.pwd).sub(/[-].*$/, '')
+  end
+  This.lib = lib
+
+# grok version
+#
+  version = ENV['VERSION']
+  unless version
+    require "./lib/#{ This.lib }"
+    This.name = lib.capitalize
+    This.object = eval(This.name)
+    version = This.object.send(:version)
+  end
+  This.version = version
+
+# we need to know the name of the lib an it's version
+#
+  abort('no lib') unless This.lib
+  abort('no version') unless This.version
+
+# discover full path to this ruby executable
+#
+  c = Config::CONFIG
+  bindir = c["bindir"] || c['BINDIR']
+  ruby_install_name = c['ruby_install_name'] || c['RUBY_INSTALL_NAME'] || 'ruby'
+  ruby_ext = c['EXEEXT'] || ''
+  ruby = File.join(bindir, (ruby_install_name + ruby_ext))
+  This.ruby = ruby
+
+# some utils
+#
+  module Util
+    def indent(s, n = 2)
+      s = unindent(s)
+      ws = ' ' * n
+      s.gsub(%r/^/, ws)
+    end
+
+    def unindent(s)
+      indent = nil
+      s.each_line do |line|
+      next if line =~ %r/^\s*$/
+      indent = line[%r/^\s*/] and break
+    end
+    indent ? s.gsub(%r/^#{ indent }/, "") : s
+  end
+    extend self
+  end
+
+# template support
+#
+  class Template
+    def initialize(&block)
+      @block = block
+      @template = block.call.to_s
+    end
+    def expand(b=nil)
+      ERB.new(Util.unindent(@template)).result((b||@block).binding)
+    end
+    alias_method 'to_s', 'expand'
+  end
+  def Template(*args, &block) Template.new(*args, &block) end
+
+# colored console output support
+#
+  This.ansi = {
+    :clear      => "\e[0m",
+    :reset      => "\e[0m",
+    :erase_line => "\e[K",
+    :erase_char => "\e[P",
+    :bold       => "\e[1m",
+    :dark       => "\e[2m",
+    :underline  => "\e[4m",
+    :underscore => "\e[4m",
+    :blink      => "\e[5m",
+    :reverse    => "\e[7m",
+    :concealed  => "\e[8m",
+    :black      => "\e[30m",
+    :red        => "\e[31m",
+    :green      => "\e[32m",
+    :yellow     => "\e[33m",
+    :blue       => "\e[34m",
+    :magenta    => "\e[35m",
+    :cyan       => "\e[36m",
+    :white      => "\e[37m",
+    :on_black   => "\e[40m",
+    :on_red     => "\e[41m",
+    :on_green   => "\e[42m",
+    :on_yellow  => "\e[43m",
+    :on_blue    => "\e[44m",
+    :on_magenta => "\e[45m",
+    :on_cyan    => "\e[46m",
+    :on_white   => "\e[47m"
+  }
+  def say(phrase, *args)
+    options = args.last.is_a?(Hash) ? args.pop : {}
+    options[:color] = args.shift.to_s.to_sym unless args.empty?
+    keys = options.keys
+    keys.each{|key| options[key.to_s.to_sym] = options.delete(key)}
+
+    color = options[:color]
+    bold = options.has_key?(:bold)
+
+    parts = [phrase]
+    parts.unshift(This.ansi[color]) if color
+    parts.unshift(This.ansi[:bold]) if bold
+    parts.push(This.ansi[:clear]) if parts.size > 1
+
+    method = options[:method] || :puts
+
+    Kernel.send(method, parts.join)
+  end
+
+# always run out of the project dir
+#
+  Dir.chdir(This.dir)
+}

data/demon.gemspec

@@ -0,0 +1,29 @@
+## demon.gemspec
+#
+
+Gem::Specification::new do |spec|
+  spec.name = "demon"
+  spec.version = "0.0.666"
+  spec.platform = Gem::Platform::RUBY
+  spec.summary = "demon"
+  spec.description = "description: demon kicks the ass"
+
+  spec.files =
+["README.md", "Rakefile", "demon.gemspec", "lib", "lib/demon.rb"]
+
+  spec.executables = []
+  
+  spec.require_path = "lib"
+
+  spec.test_files = nil
+
+### spec.add_dependency 'lib', '>= version'
+#### spec.add_dependency 'map'
+
+  spec.extensions.push(*[])
+
+  spec.rubyforge_project = "codeforpeople"
+  spec.author = "Ara T. Howard"
+  spec.email = "ara.t.howard@gmail.com"
+  spec.homepage = "https://github.com/ahoward/demon"
+end

data/lib/demon.rb

@@ -0,0 +1,786 @@
+# -*- encoding : utf-8 -*-
+ 
+class Demon
+  Version = '0.0.666' unless defined?(Version)
+  Load = Kernel.method(:load) unless defined?(Load)
+
+  class << Demon
+    def version
+      Demon::Version
+    end
+
+    def libdir(*args, &block)
+      @libdir ||= File.expand_path(__FILE__).sub(/\.rb$/,'')
+      libdir = args.empty? ? @libdir : File.join(@libdir, *args.map{|arg| arg.to_s})
+    ensure
+      if block
+        begin
+          $LOAD_PATH.unshift(libdir) unless $LOAD_PATH.first==libdir
+          module_eval(&block)
+        ensure
+          $LOAD_PATH.shift() if $LOAD_PATH.first==libdir
+        end
+      end
+    end
+
+    def load(*args, &block)
+      libdir{ Load.call(*args, &block) }
+    end
+
+    def dependencies
+      {
+        'map'               => [ 'map'               , ' >= 6.0.0' ]
+      }
+    end
+  end
+
+  begin
+    require 'rubygems'
+  rescue LoadError
+    nil
+  end
+
+  begin
+    require 'logging'
+  rescue LoadError
+    nil
+  end
+
+  if defined?(gem)
+    Demon.dependencies.each do |lib, dependency|
+      gem(*dependency)
+      require(lib)
+    end
+  end
+
+  require 'fileutils'
+  require 'ostruct'
+  require 'rbconfig'
+  require 'pathname'
+  require 'logger'
+  require 'yaml'
+end
+
+
+class Demon
+  def initialize(*args, &block)
+  #
+    @options =  Map.extract_options!(args)
+
+  #
+    @__file__ = (
+      @options[:script] or
+      @options[:file] or
+      @options[:__file__] or
+      args.shift or
+      (block ? eval('File.expand_path(__FILE__)', block.binding) : nil)
+    )
+    raise("no __FILE__ groked!") unless @__file__
+
+    @root = @options[:root]
+
+    @mode = @options[:mode]
+
+  #
+    @script = File.expand_path(@__file__)
+    raise("no script groked!") unless test(?s, @script)
+
+  #
+    @cmdline = generate_cmdline
+
+    @dirname = File.expand_path(File.dirname(@script))
+    @basename = File.basename(@script)
+
+    @script_root = File.expand_path(File.dirname(@script))
+
+  #
+    rails_root = @script_root
+    seems_to_be_a_rails_app = false
+
+    42.times do
+      seems_to_be_a_rails_app =
+        %w( app/controllers app/models app/views config Rakefile ).all? do |subdir|
+          test(?e, File.join(rails_root, subdir))
+        end
+
+      if seems_to_be_a_rails_app or rails_root == '/'
+        break
+      end
+
+      rails_root = File.expand_path(File.dirname(rails_root))
+    end
+
+    if seems_to_be_a_rails_app
+      @rails_root = rails_root
+
+      @demon_dir = File.join(@rails_root, 'log', 'demon')
+      @restart_txt = File.join(@rails_root, 'tmp', 'restart.txt')
+
+      self.prefix = File.join(@demon_dir, @basename)
+
+      @root = @rails_root
+    else
+      @rails_root = false
+
+      @demon_dir = @root || "#{ @script }.demon"
+      @restart_txt = File.join(@demon_dir, 'restart.txt')
+
+      self.prefix = @demon_dir
+
+      @root = @demon_dir
+    end
+
+  #
+    @signals    = []
+    @started_at = Time.now
+    @sleeping   = false
+    @ppid       = Process.pid
+
+  #
+    STDOUT.sync = true
+    STDERR.sync = true
+
+    self
+  end
+
+  def prefix
+    @prefix
+  end
+
+  def prefix=(prefix)
+    @prefix = File.expand_path(prefix.to_s)
+
+    @lock_file    = File.join(@prefix, 'lock')
+    @log_file     = File.join(@prefix, 'log')
+    @pid_file     = File.join(@prefix, 'pid')
+    @cmdline_file = File.join(@prefix, 'cmdline')
+    @stdin_file   = File.join(@prefix, 'stdin')
+    @stdout_file  = File.join(@prefix, 'stdout')
+    @stderr_file  = File.join(@prefix, 'stderr')
+
+    FileUtils.mkdir_p(@prefix)
+
+    %w( lock log pid cmdline stdin stdout stderr ).each do |which|
+      file = instance_variable_get("@#{ which }_file")
+      FileUtils.touch(file)
+    end
+
+    @prefix
+  end
+
+  %w(
+
+    script
+    mode
+    dirname
+    basename
+    root
+    script_root
+    rails_root
+    prefix
+    basename_dir
+    lock_file
+    log_file
+    pid_file
+    cmdline_file
+    restart_txt
+    started_at
+    signals
+
+  ).each{|a| attr(a)}
+
+  def start(which = :start, &block)
+    mode = "mode_#{ which }".downcase
+    send(mode) if respond_to?(mode)
+    run_forever_handling_signals_and_logging_errors!(&block)
+  end
+
+  def Demon.start(*args, &block)
+    new(*args).tap{|demon| demon.start(&block)}
+  end
+
+  def run(which = :run, &block)
+    mode = "mode_#{ which }".downcase
+    send(mode) if respond_to?(mode)
+    run_forever_handling_signals_and_logging_errors!(&block)
+  end
+
+  def Demon.run(*args, &block)
+    new(*args).tap{|demon| demon.run(&block)}
+  end
+
+  module ::Kernel
+    def Demon(*args, &block)
+      demon = ::Demon.new(*args, &block)
+      mode = demon.mode || ARGV[0] || :run
+      demon.run(mode, &block)
+    end
+  end
+
+  def run_forever_handling_signals_and_logging_errors!(&block)
+    loop do
+      catch(:signals) do
+        process_signals
+
+        begin
+          block.call() if block
+        rescue => e
+          logger.error(e)
+        ensure
+          wait(420) unless $! # NOTE: signals wake this up!
+        end
+      end
+    end
+  end
+
+  def Demon.modes
+    instance_methods.grep(/mode_(.*)/).map{|mode| mode.to_s.split('_').last}
+  end
+
+  def mode_modes
+    puts Demon.modes.join('|')
+    exit(42)
+  end
+
+  def Demon.help
+    {
+      'start'   => 'start in daemon mode',
+      'run'     => 'run in the foreground, but otherwise like a daemon',
+      'stop'    => 'stop any currently running daemon',
+      'restart' => 'restart any currently running daemon, or start a new one',
+      'pid'     => 'print the pid of the running daemon, iff any',
+      'ping'    => 'ensure a daemon is running, start one iff not',
+      'signal'  => 'hit the daemon, if any, with SIGUSR2',
+      'tail'    => 'tail -F all auxillary files (lock files, logs, etc)',
+      'fuser'   => 'report the fuser of any auxillary files (lock files, logs, etc)',
+      'log'     => 'display the location of the log file',
+      'root'    => 'display the location of the root daemon dir (lock files, logs, etc)',
+      'modes'   => 'print all modes, even those without "help"',
+      'help'    => 'this message'
+    }
+  end
+
+  def mode_help
+    puts(Demon.help.to_yaml)
+    exit(42)
+  end
+
+  def mode_ping
+    pid = Integer(IO.read(@pid_file)) rescue nil
+
+    if pid
+      signaled = false
+
+      begin
+        Process.kill('SIGALRM', pid)
+        signaled = true
+      rescue Object
+        nil
+      end
+
+      if signaled
+        STDOUT.puts(pid)
+        exit
+      end
+    end
+
+    Kernel.exec("#{ @script } start")
+  end
+
+  def mode_run
+    lock!(:complain => true)
+
+    pid!
+
+    cmdline!
+
+    trap!
+
+    boot!
+
+    logging!
+
+    log!
+  end
+
+  def mode_start
+    lock!(:complain => true)
+
+    daemonize!{|pid| puts(pid)}
+
+    redirect_io!
+
+    pid!
+
+    cmdline!
+
+    trap!
+
+    boot!
+
+    logging!
+
+    signal_if_redeployed!
+
+    log!
+  end
+
+  def mode_restart
+    begin
+      pid = Integer(IO.read(@pid_file)) rescue nil
+      Process.kill('HUP', pid)
+      puts "Process #{pid} signaled to restart"
+      exit(0)
+    rescue
+      puts "No running process found. Starting a new one."
+      mode_start
+    end
+  end
+
+  def mode_pid
+    pid = Integer(IO.read(@pid_file)) rescue nil
+    if pid
+      begin
+        Process.kill(0, pid)
+        puts(pid)
+        exit(0)
+      rescue Errno::ESRCH
+        exit(1)
+      end
+    else
+      exit(1)
+    end
+    exit(1)
+  end
+
+  def mode_fuser
+    exec("fuser #{ @lock_file.inspect }")
+  end
+
+  def mode_stop
+    pid = Integer(IO.read(@pid_file)) rescue nil
+    if pid
+      alive = true
+
+      %w( QUIT TERM ).each do |signal|
+        begin
+          Process.kill(signal, pid)
+        rescue Errno::ESRCH
+          nil
+        end
+
+        42.times do
+          begin
+            Process.kill(0, pid)
+            sleep(rand)
+          rescue Errno::ESRCH
+            alive = false
+            puts(pid)
+            exit(0)
+          end
+        end
+      end
+
+      if alive
+        begin
+          Process.kill(-9, pid)
+          sleep(rand)
+        rescue Errno::ESRCH
+          nil
+        end
+
+        begin
+          Process.kill(0, pid)
+        rescue Errno::ESRCH
+          puts(pid)
+          exit(0)
+        end
+      end
+    end
+    exit(1)
+  end
+
+  def mode_signal(signal = 'SIGUSR2')
+    pid = Integer(IO.read(@pid_file)) rescue nil
+    if pid
+      Process.kill(signal, pid)
+      puts(pid)
+      exit(0)
+    end
+    exit(42)
+  end
+
+  def mode_log
+    puts(@log_file)
+    exit(42)
+  end
+
+  def mode_root
+    puts(@root)
+    exit(42)
+  end
+
+  def mode_tail
+    system("tail -F #{ @stdout_file.inspect } #{ @stderr_file.inspect } #{ @log_file.inspect }")
+    exit(42)
+  end
+
+
+  def process_signals
+    if signaled?
+      signals.uniq.each do |signal|
+        case signal.to_s
+          when /HUP/i
+            logger.info('RESTART - signal')
+            restart!
+          when /USR1/i
+            logger.info('RESTART - deploy')
+            restart!
+          when /USR2/i
+            nil
+          when /ALRM/i
+            nil
+        end
+      end
+      signals.clear
+    end
+  end
+
+  def wait(seconds)
+    begin
+      @sleeping = true
+      Kernel.sleep(seconds)
+    ensure
+      @sleeping = false
+    end
+  end
+
+  def restart!
+    exit!(0) if fork
+
+    logger.info('CMD - %s' % Array(@cmdline).join(' '))
+
+    unlock!
+
+    keep_ios(STDIN, STDOUT, STDERR)
+
+    Kernel.exec(*@cmdline)
+  end
+
+  def boot!
+    if @rails_root
+      Dir.chdir(@rails_root)
+      require File.join(@rails_root, 'config', 'boot')
+      require File.join(@rails_root, 'config', 'environment')
+    end
+  end
+
+  def lock!(options = {})
+    complain = options['complain'] || options[:complain]
+    fd = open(@lock_file, 'r+')
+    status = fd.flock(File::LOCK_EX|File::LOCK_NB)
+
+    unless status == 0
+      if complain
+        pid = Integer(IO.read(@pid_file)) rescue '?'
+        warn("instance(#{ pid }) is already running!")
+      end
+      exit(42)
+    end
+    @lock = fd # prevent garbage collection from closing the file!
+    at_exit{ unlock! }
+  end
+
+  def unlock!
+    @lock.flock(File::LOCK_UN|File::LOCK_NB) if @lock
+  end
+
+  def pid!
+    open(@pid_file, 'w+') do |fd|
+      fd.puts(Process.pid)
+    end
+    at_exit{ FileUtils.rm_f(@pid_file) }
+  end
+
+  def cmdline!
+    open(@cmdline_file, 'w+') do |fd|
+      fd.puts(Array(@cmdline).join(' '))
+    end
+  end
+
+  def trap!
+    %w( SIGHUP SIGALRM SIGUSR1 SIGUSR2 ).each do |signal|
+      trap(signal) do |sig|
+        signals.push(signal)
+        logger.debug("SIGNAL - #{ signal }")
+        throw(:signals, signal) if sleeping?
+      end
+    end
+
+    trap('SIGQUIT'){ exit(42) }
+    trap('SIGTERM'){ exit(42) }
+    trap('SIGINT'){ exit(42) }
+  end
+
+  def signal_if_redeployed!
+    seconds = production? ? 10 : 1
+
+    Thread.new do
+      Thread.current.abort_on_exception = true
+      loop do
+        Kernel.sleep(seconds)
+        Process.kill(:USR1, Process.pid) if redeployed?
+      end
+    end
+  end
+
+  def log!
+    logger.info("START - #{ Process.pid }")
+    at_exit do
+      logger.info("STOP - #{ Process.pid }") rescue nil
+    end
+  end
+
+  def redeployed?
+    t = File.stat(current_path_for(@restart_txt)).mtime rescue @started_at
+    t > @started_at
+  end
+
+  def generate_cmdline
+    current_script = current_path_for(@script)
+    [which_ruby, current_script, 'start']
+  end
+
+  def current_path_for(path)
+    path.to_s.gsub(%r|\breleases/\d+\b|, 'current')
+  end
+
+  def which_ruby
+    c = ::RbConfig::CONFIG
+    ruby = File::join(c['bindir'], c['ruby_install_name']) << c['EXEEXT']
+    raise "ruby @ #{ ruby } not executable!?" unless test(?e, ruby)
+    ruby
+  end
+
+  def cap?(&block)
+    realpath = proc do |path|
+      begin
+        (path.is_a?(Pathname) ? path : Pathname.new(path.to_s)).realpath.to_s
+      rescue Errno::ENOENT
+        nil
+      end
+    end
+
+    cap_root = realpath[@rails_root || @root]
+
+    shared_path = File.expand_path('../../shared', cap_root)
+    cap_path = File.dirname(shared_path)
+    shared_public_system_path = File.expand_path('../../shared/system')
+    public_path = File.join(cap_root, 'public')
+
+    public_system_path = File.join(public_path.to_s, 'system')
+ 
+    is_cap_deploy =
+      test(?e, shared_public_system_path) and
+      test(?l, public_system_path) and
+      realpath[shared_public_system_path] == realpath[public_system_path]
+
+    return false unless is_cap_deploy
+
+    args = 
+      if block
+        [cap_path].slice(block.arity > 0 ? (0 ... block.arity) : (0 .. -1))
+      else
+        []
+      end
+    block ? block.call(*args) : cap_path
+  end
+
+  def production?
+    if defined?(Rails.env)
+      Rails.env.production?
+    else
+      true
+    end
+  end
+
+  def sleeping?(&block)
+    if block
+      block.call if @sleeping
+    else
+      @sleeping == true
+    end
+  end
+
+  def signaled?
+    !signals.empty?
+  end
+
+  def logger
+    @logger ||= (
+      require 'logger' unless defined?(Logger)
+      Logger.new(STDERR)
+    )
+  end
+
+  def logger=(logger)
+    @logger = logger
+  end
+
+  def logging_errors(&block)
+    begin
+      block.call()
+    rescue SignalException => e
+      logger.info(e)
+      exit(0)
+    rescue => e
+      logger.error(e)
+    end
+  end
+
+
+# daemonize{|pid| puts "the pid of the daemon is #{ pid }"}
+#
+
+  def daemonize!(options = {}, &block)
+  # optional directory and umask
+  #
+    chdir = options[:chdir] || options['chdir'] || '.'
+    umask = options[:umask] || options['umask'] || 0
+
+  # drop to the background avoiding the possibility of zombies..
+  #
+    detach!(&block)
+
+  # close all open io handles *except* these ones
+  #
+    keep_ios(STDIN, STDOUT, STDERR, @lock)
+
+  # sane directory and umask
+  #
+    Dir::chdir(chdir)
+    File::umask(umask)
+
+  # global daemon flag
+  #
+    $DAEMON = true
+  end
+
+  def detach!(&block)
+  # setup a pipe to relay the grandchild pid through
+  #
+    a, b = IO.pipe
+
+  # in the parent we wait for the pid, wait on our child to avoid zombies, and
+  # then exit
+  #
+    if fork
+      b.close
+      pid = Integer(a.read.strip)
+      a.close
+      block.call(pid) if block
+      Process.waitall
+      exit!
+    end
+
+  # the child simply exits so it can be reaped - avoiding zombies.  the pipes
+  # are inherited in the grandchild
+  #
+    if fork
+      exit!
+    end
+
+  # finally, the grandchild sends it's pid back up the pipe to the parent is
+  # aware of the pid
+  #
+    a.close
+    b.puts(Process.pid)
+    b.close
+
+  # might as well nohup too...
+  #
+    Process::setsid rescue nil
+  end
+
+  def redirect_io!(options = {})
+    stdin = options[:stdin] || @stdin_file
+    stdout = options[:stdout] || @stdout_file
+    stderr = options[:stderr] || @stderr_file
+
+    {
+      STDIN => stdin, STDOUT => stdout, STDERR => stderr
+    }.each do |io, file|
+      opened = false
+
+      fd =
+        case
+          when file.is_a?(IO)
+            file
+          when file.to_s == 'null'
+            opened = true
+            open('/dev/null', 'ab+')
+          else
+            opened = true
+            open(file, 'ab+')
+        end
+
+      begin
+        fd.sync = true rescue nil
+        fd.truncate(0) rescue nil
+        io.reopen(fd)
+      ensure
+        fd.close rescue nil if opened
+      end
+    end
+  end
+
+  def logging!
+    number_rolled = 7
+    megabytes     = 2 ** 20
+    max_size      = 42 * megabytes
+
+    @logger =
+      if STDIN.tty?
+        if defined?(Logging)
+          ::Logging.logger(STDERR)
+        else
+          ::Logger.new(STDERR)
+        end
+      else
+        if defined?(Logging)
+          options = defined?(Lockfile) ? {:safe => true} : {}
+          ::Logging.logger(@log_file, number_rolled, max_size, options)
+        else
+          ::Logger.new(@log_file, number_rolled, max_size)
+        end
+      end
+
+    @logger.level = ::Logger::INFO rescue nil if production?
+    @logger.level = ::Logger::DEBUG if STDERR.tty?
+
+    @logger
+  end
+
+  def keep_ios(*ios)
+    filenos = []
+
+    ios.flatten.compact.each do |io|
+      begin
+        fileno = io.respond_to?(:fileno) ? io.fileno : Integer(io)
+        filenos.push(fileno)
+      rescue Object
+        next
+      end
+    end
+
+    ObjectSpace.each_object(IO) do |io|
+      begin
+        fileno = io.fileno
+        next if filenos.include?(fileno)
+        io.close unless io.closed?
+      rescue Object
+        next
+      end
+    end
+  end
+end

metadata

@@ -0,0 +1,48 @@
+--- !ruby/object:Gem::Specification
+name: demon
+version: !ruby/object:Gem::Version
+  version: 0.0.666
+  prerelease: 
+platform: ruby
+authors:
+- Ara T. Howard
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2013-07-02 00:00:00.000000000 Z
+dependencies: []
+description: ! 'description: demon kicks the ass'
+email: ara.t.howard@gmail.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- demon.gemspec
+- lib/demon.rb
+homepage: https://github.com/ahoward/demon
+licenses: []
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: codeforpeople
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: demon
+test_files: []