blue-daemons 1.1.11

data/TODO

@@ -0,0 +1,2 @@
+* put TODOS here
+

data/daemons.gemspec

@@ -0,0 +1,27 @@
+# coding: utf-8
+lib = File.expand_path('../lib', __FILE__)
+$LOAD_PATH.unshift(lib) unless $LOAD_PATH.include?(lib)
+require 'daemons/version'
+
+Gem::Specification.new do |spec|
+  spec.name              = "blue-daemons"
+  spec.version           = Daemons::VERSION
+
+  spec.authors           = ["Thomas Uehlinger"]
+  spec.autorequire       = %q{daemons}
+  spec.description       = %q{Daemons provides an easy way to wrap existing ruby scripts (for example a self-written server)  to be run as a daemon and to be controlled by simple start/stop/restart commands.  You can also call blocks as daemons and control them from the parent or just daemonize the current process.  Besides this basic functionality, daemons offers many advanced features like exception  backtracing and logging (in case your ruby script crashes) and monitoring and automatic restarting of your processes if they crash.}
+  spec.email             = %q{th.uehlinger@gmx.ch}
+  spec.has_rdoc          = true
+  spec.homepage          = %q{http://daemons.rubyforge.org}
+  spec.rubyforge_project = %q{daemons}
+  spec.summary           = %q{A toolkit to create and control daemons in different ways}
+
+  spec.files             = `git ls-files`.split($/)
+  spec.executables       = spec.files.grep(%r{^bin/}) { |f| File.basename(f) }
+  spec.test_files        = spec.files.grep(%r{^(test|spec|features)/})
+  spec.require_paths     = ["lib"]
+
+  spec.add_development_dependency "bundler", ">= 1.0"
+  spec.add_development_dependency "rake"
+  spec.add_development_dependency "rspec"
+end

data/examples/call/call.rb

@@ -0,0 +1,57 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+
+require 'daemons'
+
+testfile = File.expand_path(__FILE__) + '.log'
+
+
+# On the first call to <tt<call</tt>, an application group (accessible by <tt>Daemons.group</tt>)
+# will be created an the options will be kept within, so you only have to specify
+# <tt>:multiple</tt> once.
+#
+
+options = {
+  :app_name => 'mytask',
+#  :ontop => true,
+  :multiple => true
+}
+
+
+Daemons.call(options) do
+  File.open(testfile, 'w') {|f|
+    f.puts "test"
+  }
+
+  loop { puts "1"; sleep 5 }
+end
+puts "first task started"
+
+Daemons.call do
+  loop { puts "2"; sleep 4 }
+end
+puts "second task started"
+
+# NOTE: this process will exit after 5 seconds
+Daemons.call do
+  puts "3"
+  sleep 5
+end
+puts "third task started"
+
+puts "waiting 20 seconds..."
+sleep(20)
+
+# This call would result in an exception as it will try to kill the third process 
+# which has already terminated by that time; but using the 'true' parameter forces the
+# stop_all procedure.
+puts "trying to stop all tasks..."
+Daemons.group.stop_all(true)
+
+puts "done"

data/examples/call/call.rb.log

@@ -0,0 +1 @@
+test

data/examples/call/call_monitor.rb

@@ -0,0 +1,55 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+
+require 'daemons'
+
+testfile = File.expand_path(__FILE__) + '.log'
+
+
+# On the first call to <tt<call</tt>, an application group (accessible by <tt>Daemons.group</tt>)
+# will be created an the options will be kept within, so you only have to specify
+# <tt>:multiple</tt> once.
+#
+
+options = {
+#  :ontop => true,
+  :multiple => true,
+  :monitor => true
+}
+
+
+Daemons.call(options) do
+  loop { puts "1"; sleep 20 }
+end
+puts "first task started"
+
+
+# NOTE: this process will exit after 5 seconds
+Daemons.call do
+  File.open(testfile, 'a') {|f|
+    f.puts "started..."
+    puts "2"
+  
+    sleep 5
+
+    f.puts "...exit"
+  }
+end
+puts "second task started"
+
+puts "waiting 100 seconds..."
+sleep(100)
+
+# This call would result in an exception as it will try to kill the third process 
+# which has already terminated by that time; but using the 'true' parameter forces the
+# stop_all procedure.
+puts "trying to stop all tasks..."
+Daemons.group.stop_all(true)
+
+puts "done"

data/examples/daemonize/daemonize.rb

@@ -0,0 +1,27 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+
+
+require 'daemons'
+
+
+options = {
+  :log_output => true
+}
+
+
+testfile = File.expand_path(__FILE__) + '.txt'
+
+Daemons.daemonize(options)
+
+puts "some output..."
+
+File.open(testfile, 'w') {|f|
+  f.write("test")
+}

data/examples/run/ctrl_crash.rb

@@ -0,0 +1,17 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :log_output => true,
+  :backtrace => true
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver_crashing.rb'), options)

data/examples/run/ctrl_exec.rb

@@ -0,0 +1,16 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :mode => :exec
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver.rb'), options)

data/examples/run/ctrl_exit.rb

@@ -0,0 +1,15 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver_exiting.rb'), options)

data/examples/run/ctrl_hanging.rb

@@ -0,0 +1,19 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+options = {
+  #:mode => :exec,
+  :multiple => true,
+  :no_pidfiles => true,
+  :force_kill_waittime => 5
+  #:force_kill_waittime => -1    # do not wait before killing -9
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver_hanging.rb'), options)

data/examples/run/ctrl_keep_pid_files.rb

@@ -0,0 +1,17 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :keep_pid_files => true
+}
+
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver.rb'), options)

data/examples/run/ctrl_monitor.rb

@@ -0,0 +1,16 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :monitor => true
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver_crashing.rb'), options)

data/examples/run/ctrl_monitor_multiple.rb

@@ -0,0 +1,18 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :multiple => true,
+  :monitor => true,
+  :log_output => true,
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver_crashing.rb'), options)

data/examples/run/ctrl_multiple.rb

@@ -0,0 +1,16 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :multiple => true
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver.rb'), options)

data/examples/run/ctrl_normal.rb

@@ -0,0 +1,11 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver.rb'))

data/examples/run/ctrl_ontop.rb

@@ -0,0 +1,16 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+  :ontop => true
+}
+
+Daemons.run(File.join(File.dirname(__FILE__), 'myserver.rb'), options)

data/examples/run/ctrl_optionparser.rb

@@ -0,0 +1,43 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+require 'optparse'
+require 'logger'
+require 'ostruct'
+
+
+class MyApp < Logger::Application
+  def initialize(args)
+    super(self.class)
+    @options = OpenStruct.new(:daemonize => true)
+    opts = OptionParser.new do |opts|
+      opts.banner = 'Usage: myapp [options]'
+      opts.separator ''
+      opts.on('-N','--no-daemonize',"Don't run as a daemon") do
+        @options.daemonize = false
+      end
+    end
+    @args = opts.parse!(args)
+  end
+  
+  def run
+    Daemons.run_proc('myapp',{:ARGV => @args, :ontop => !@options.daemonize}) do
+      puts "@options.daemonize: #{@options.daemonize}"
+      STDOUT.sync = true
+      loop do
+        print '.'
+        sleep(2)
+      end
+    end
+  end
+end
+
+
+myapp = MyApp.new(ARGV)
+myapp.run

data/examples/run/ctrl_proc.rb

@@ -0,0 +1,25 @@
+lib_dir = File.expand_path(File.join(File.dirname(__FILE__), '../../lib'))
+
+if File.exist?(File.join(lib_dir, 'daemons.rb'))
+  $LOAD_PATH.unshift lib_dir
+else
+  begin; require 'rubygems'; rescue ::Exception; end
+end
+
+require 'daemons'
+
+
+options = {
+             :multiple   => false,
+             :ontop      => false,
+             :backtrace  => true,
+             :log_output => true,
+             :monitor    => true
+           }
+           
+Daemons.run_proc('ctrl_proc.rb', options) do
+  loop do
+    puts 'ping from proc!'
+    sleep(3)
+  end
+end

data/examples/run/ctrl_proc.rb.output

@@ -0,0 +1,121 @@
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ping from proc!
+ctrl_proc.rb: process with pid 3187 started.
+ping from proc!
+ping from proc!
+ping from proc!
+ctrl_proc.rb: process with pid 1659 started.
+ping from proc!
+ping from proc!
+ctrl_proc.rb: process with pid 17561 started.
+ping from proc!
+ping from proc!
+ctrl_proc.rb: process with pid 18362 started.
+ping from proc!
+ping from proc!