KeeperPat-feedupdater 0.2.6

data/lib/feed_updater/vendor/daemons/daemonize.rb

@@ -0,0 +1,265 @@
+#--
+###############################################################################
+# daemonize.rb is a slightly modified version of daemonize.rb was             #
+# from the Daemonize Library written by Travis Whitton                        #
+# for details, read the notice below                                          #
+###############################################################################
+#++
+#
+#
+# =Daemonize Library
+# 
+# February. 4, 2005 Travis Whitton <whitton@atlantic.net>
+# 
+# Daemonize allows you to easily modify any existing Ruby program to run
+# as a daemon. See README.rdoc for more details.
+# 
+# == How to install
+# 1. su to root
+# 2. ruby install.rb
+# build the docs if you want to
+# 3. rdoc --main README.rdoc daemonize.rb README.rdoc
+# 
+# == Copying
+# The Daemonize extension module is copywrited free software by Travis Whitton
+# <whitton@atlantic.net>. You can redistribute it under the terms specified in
+# the COPYING file of the Ruby distribution.
+# 
+# == WARRANTY
+# THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+# IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+# WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR
+# PURPOSE.
+#
+#
+# ----
+#
+# == Purpose
+# 
+# Daemonize is a module derived from Perl's Proc::Daemon module. This module
+# allows you to easily modify any existing Ruby program to run as a daemon.
+# A daemon is a process that runs in the background with no controlling terminal.
+# Generally servers (like FTP and HTTP servers) run as daemon processes.
+# Note, do not make the mistake that a daemon == server. Converting a program
+# to a daemon by hand is a relatively simple process; however, this module will
+# save you the effort of repeatedly looking up the procedure, and it will also
+# insure that your programs are daemonized in the safest and most corrects
+# fashion possible.
+# 
+# == Procedure
+# 
+# The Daemonize module does the following:
+# 
+# Forks a child and exits the parent process.
+# 
+# Becomes a session leader (which detaches the program from
+# the controlling terminal).
+# 
+# Forks another child process and exits first child. This prevents
+# the potential of acquiring a controlling terminal.
+# 
+# Changes the current working directory to "/".
+# 
+# Clears the file creation mask.
+# 
+# Closes file descriptors.
+# 
+# == Example usage
+# 
+# Using the Daemonize module is extremely simple:
+# 
+#     require 'daemonize'
+# 
+#     class TestDaemon
+#       include Daemonize
+# 
+#       def initialize
+#         daemonize()
+#         loop do
+#           # do some work here
+#         end
+#       end
+#     end
+# 
+# == Credits
+# 
+# Daemonize was written by Travis Whitton and is based on Perl's
+# Proc::Daemonize, which was written by Earl Hood. The above documentation
+# is also partially borrowed from the Proc::Daemonize POD documentation.
+
+
+
+module Daemonize
+  VERSION = "0.1.1m"
+
+  # Try to fork if at all possible retrying every 5 sec if the
+  # maximum process limit for the system has been reached
+  def safefork
+    tryagain = true
+
+    while tryagain
+      tryagain = false
+      begin
+        if pid = fork
+          return pid
+        end
+      rescue Errno::EWOULDBLOCK
+        sleep 5
+        tryagain = true
+      end
+    end
+  end
+  module_function :safefork
+  
+  
+  def simulate(logfile_name = nil)
+    # NOTE: STDOUT and STDERR will not be redirected to the logfile!
+    
+    Dir.chdir "/"   # Release old working directory
+    File.umask 0000 # Insure sensible umask
+
+    # Make sure all file descriptors are closed
+    ObjectSpace.each_object(IO) do |io|
+      unless [STDIN, STDOUT, STDERR].include?(io)
+        begin
+          unless io.closed?
+            io.close
+          end
+        rescue ::Exception
+        end
+      end
+    end
+
+    # Free file descriptors and
+    # point them somewhere sensible
+    # STDOUT/STDERR should go to a logfile
+    
+    STDIN.reopen "/dev/null" rescue nil       
+  end
+  module_function :simulate
+  
+  
+  def call_as_daemon(block, logfile_name = nil, oldmode = 0)
+    rd, wr = IO.pipe
+    
+    if tmppid = safefork
+      # parent
+      wr.close
+      pid = rd.read.to_i
+      rd.close
+      
+      Process.waitpid(tmppid)
+      
+      return pid
+    else
+      rd.close
+      
+      # Detach from the controlling terminal
+      unless sess_id = Process.setsid
+        raise Daemons.RuntimeException.new('cannot detach from controlling terminal')
+      end
+  
+      # Prevent the possibility of acquiring a controlling terminal
+      if oldmode.zero?
+        trap 'SIGHUP', 'IGNORE'
+        exit if pid = safefork
+      end
+  
+      wr.write Process.pid
+      wr.close
+      
+      Dir.chdir "/"   # Release old working directory
+      File.umask 0000 # Insure sensible umask
+  
+      # Make sure all file descriptors are closed
+      ObjectSpace.each_object(IO) do |io|
+        unless [STDIN, STDOUT, STDERR].include?(io)
+          begin
+            unless io.closed?
+              io.close
+            end
+          rescue ::Exception
+          end
+        end
+      end
+  
+      # Free file descriptors and
+      # point them somewhere sensible
+      # STDOUT/STDERR should go to a logfile
+      
+      STDIN.reopen "/dev/null" rescue nil       
+      
+      if logfile_name
+        begin
+          STDOUT.reopen logfile_name, "a" 
+        rescue ::Exception
+          STDOUT.reopen "/dev/null" rescue nil
+        end
+      else
+        STDOUT.reopen "/dev/null" rescue nil
+      end
+      
+      STDERR.reopen STDOUT rescue nil    
+    
+      block.call
+      
+      exit
+    end
+  end
+  module_function :call_as_daemon
+  
+  
+  # This method causes the current running process to become a daemon
+  def daemonize(logfile_name = nil, oldmode=0)
+    srand # Split rand streams between spawning and daemonized process
+    safefork and exit # Fork and exit from the parent
+
+    # Detach from the controlling terminal
+    unless sess_id = Process.setsid
+      raise Daemons.RuntimeException.new('cannot detach from controlling terminal')
+    end
+
+    # Prevent the possibility of acquiring a controlling terminal
+    if oldmode.zero?
+      trap 'SIGHUP', 'IGNORE'
+      exit if pid = safefork
+    end
+
+    Dir.chdir "/"   # Release old working directory
+    File.umask 0000 # Insure sensible umask
+
+    # Make sure all file descriptors are closed
+    ObjectSpace.each_object(IO) do |io|
+      unless [STDIN, STDOUT, STDERR].include?(io)
+        begin
+          unless io.closed?
+            io.close
+          end
+        rescue ::Exception
+        end
+      end
+    end
+
+    # Free file descriptors and
+    # point them somewhere sensible
+    # STDOUT/STDERR should go to a logfile
+    
+    STDIN.reopen "/dev/null" rescue nil       
+    
+    if logfile_name
+      begin
+        STDOUT.reopen logfile_name, "a" 
+      rescue ::Exception
+        STDOUT.reopen "/dev/null" rescue nil
+      end
+    else
+      STDOUT.reopen "/dev/null" rescue nil
+    end
+     
+    STDERR.reopen STDOUT rescue nil           
+    
+    return oldmode ? sess_id : 0   # Return value is mostly irrelevant
+  end
+  module_function :daemonize
+  
+end

data/lib/feed_updater/vendor/daemons/exceptions.rb

@@ -0,0 +1,28 @@
+
+module Daemons
+
+  class Exception < ::RuntimeError
+  end
+  
+  class RuntimeException < Exception
+  end
+  
+  class CmdException < Exception
+  end
+  
+  class Error < Exception
+  end
+  
+  class SystemError < Error
+  
+    attr_reader :system_error
+    
+    def initialize(msg, system_error)
+      super(msg)
+      
+      @system_error = system_error
+    end
+    
+  end
+  
+end

data/lib/feed_updater/vendor/daemons/monitor.rb

@@ -0,0 +1,126 @@
+
+module Daemons
+
+  require 'daemons/daemonize'
+   
+  class Monitor
+    
+    def self.find(dir, app_name)
+      pid = PidFile.find_files(dir, app_name)[0]
+      
+      if pid
+        pid = PidFile.existing(pid)
+        
+        unless PidFile.running?(pid.pid)
+          pid.cleanup rescue nil
+          return
+        end
+        
+        monitor = self.allocate
+      
+        monitor.instance_variable_set(:@pid, pid)
+        
+        return monitor
+      end
+      
+      return nil
+    end
+    
+    
+    def initialize(an_app)
+      if an_app.pidfile_dir
+        @pid = PidFile.new(an_app.pidfile_dir, an_app.group.app_name + '_monitor', false)
+      else
+        @pid = PidMem.new
+      end
+    end
+    
+    def watch(applications)
+      sleep(30)
+      
+      loop do
+        applications.each {|a|
+          sleep(10)
+          
+          unless a.running?
+            a.zap!
+            
+            Process.detach(fork { a.start })
+            
+            sleep(10)
+          end
+        }
+        
+        sleep(30)
+      end
+    end
+    private :watch
+    
+    
+    def start_with_pidfile(applications)
+      fork do
+        Daemonize.daemonize
+        
+        begin  
+          @pid.pid = Process.pid
+          
+  #         at_exit {
+  #           @pid.cleanup rescue nil
+  #         }
+          
+          # This part is needed to remove the pid-file if the application is killed by 
+          # daemons or manually by the user.
+          # Note that the applications is not supposed to overwrite the signal handler for
+          # 'TERM'.
+          #
+  #         trap('TERM') {
+  #           @pid.cleanup rescue nil
+  #           exit
+  #         }
+          
+          watch(applications)
+        rescue ::Exception => e
+          begin
+            File.open(File.join(@pid.dir, @pid.progname + '.log'), 'a') {|f|
+              f.puts Time.now
+              f.puts e
+              f.puts e.backtrace.inspect
+            }
+          ensure 
+            @pid.cleanup rescue nil
+            exit!
+          end
+        end
+      end
+    end
+    private :start_with_pidfile
+    
+    def start_without_pidfile(applications)
+      Thread.new { watch(applications) }
+    end
+    private :start_without_pidfile
+    
+    
+    
+    def start(applications)
+      return if applications.empty?
+      
+      if @pid.kind_of?(PidFile)
+        start_with_pidfile(applications)
+      else
+        start_without_pidfile(applications)
+      end
+    end
+    
+    
+    def stop
+      Process.kill('TERM', @pid.pid) rescue nil
+      
+      # We try to remove the pid-files by ourselves, in case the application
+      # didn't clean it up.
+      @pid.cleanup rescue nil
+    end
+    
+  end
+  
+end

data/lib/feed_updater/vendor/daemons/pid.rb

@@ -0,0 +1,61 @@
+
+module Daemons
+
+  class Pid
+  
+    def Pid.running?(pid, additional = nil)
+      output = `ps ax`
+      return (/#{pid} / =~ output and (additional ? /#{additional}/ =~ output : true))
+    end
+    
+    
+    # Returns the directory that should be used to write the pid file to
+    # depending on the given mode.
+    # 
+    # Some modes may require an additionaly hint, others may determine 
+    # the directory automatically.
+    #
+    # If no valid directory is found, returns nil.
+    #
+    def Pid.dir(dir_mode, dir, script)
+      # nil script parameter is allowed so long as dir_mode is not :script
+      return nil if dir_mode == :script && script.nil?                         
+      
+      case dir_mode
+        when :normal
+          return File.expand_path(dir)
+        when :script
+          return File.expand_path(File.join(File.split(script)[0],dir))
+        when :system  
+          return '/var/run'
+        else
+          raise Error.new("pid file mode '#{dir_mode}' not implemented")
+      end
+    end
+    
+    # Initialization method
+    def initialize
+    end
+    
+    
+    # Get method
+    def pid
+    end
+    
+    # Set method
+    def pid=(p)
+    end
+    
+    # Cleanup method
+    def cleanup
+    end
+    
+    # Exists? method
+    def exists?
+      true
+    end
+    
+  end  
+  
+  
+end

data/lib/feed_updater/vendor/daemons/pidfile.rb

@@ -0,0 +1,99 @@
+require 'daemons/pid'
+
+
+module Daemons
+
+  # === What is a Pid-File?
+  # A <i>Pid-File</i> is a file containing the <i>process identification number</i>
+  # (pid) that is stored in a well-defined location of the filesystem thus allowing other
+  # programs to find out the pid of a running script.
+  #
+  # Daemons needs the pid of the scripts that are currently running in the background
+  # to send them so called _signals_. Daemons uses the +TERM+ signal to tell the script
+  # to exit when you issue a +stop+ command.
+  #
+  # === How does a Pid-File look like?
+  #
+  # Pid-Files generated by Daemons have to following format:
+  #   <scriptname>.rb<number>.pid
+  # (Note that <tt><number></tt> is omitted if only one instance of the script can
+  # run at any time)
+  #
+  # Each file just contains one line with the pid as string (for example <tt>6432</tt>).
+  #  
+  # === Where are Pid-Files stored?
+  # 
+  # Daemons is configurable to store the Pid-Files relative to three different locations:
+  # 1.  in a directory relative to the directory where the script (the one that is supposed to run
+  #     as a daemon) resides
+  # 2.  in a directory relative to the current directory or the filesystem root
+  # 3.  in the preconfigured directory <tt>/var/run</tt>
+  #
+  class PidFile < Pid
+
+    attr_reader :dir, :progname, :multiple, :number
+
+    def PidFile.find_files(dir, progname)
+      files = Dir[File.join(dir, "#{progname}*.pid")]
+      
+      files.delete_if {|f| not (File.file?(f) and File.readable?(f))}
+      
+      return files
+    end
+    
+    def PidFile.existing(path)
+      new_instance = PidFile.allocate
+      
+      new_instance.instance_variable_set(:@path, path)
+      
+      def new_instance.filename
+        return @path
+      end
+      
+      return new_instance
+    end
+    
+    def initialize(dir, progname, multiple = false)
+      @dir = File.expand_path(dir)
+      @progname = progname
+      @multiple = multiple
+      @number = 0 if multiple
+    end
+    
+    def filename
+      File.join(@dir, "#{@progname}#{ @number or '' }.pid")
+    end
+    
+    def exists?
+      File.exists? filename
+    end
+    
+    def pid=(p)
+      if multiple
+        while File.exists?(filename) and @number < 1024
+          @number += 1
+        end
+        
+        if @number == 1024
+          raise RuntimeException('cannot run more than 1024 instances of the application')
+        end
+      end
+      
+      File.open(filename, 'w') {|f|
+        f.puts p   #Process.pid
+      }
+    end
+
+    def cleanup
+      File.delete(filename)
+    end
+
+    def pid
+      File.open(filename) {|f|
+        return f.gets.to_i
+      }
+    end
+
+  end
+  
+end

data/lib/feed_updater/vendor/daemons/pidmem.rb

@@ -0,0 +1,10 @@
+require 'daemons/pid'
+
+
+module Daemons
+
+  class PidMem < Pid
+    attr_accessor :pid
+  end
+
+end