daemon-kit 0.1.7.7 → 0.1.7.8

data/History.txt

@@ -1,3 +1,16 @@
+== 0.1.7.8 2009-06-22
+
+* Optional logging of all exceptions when the daemon process dies
+  unexpectedly
+* Update generated environment.rb to reflect new backtraces option
+
+== 0.1.7.7 2009-06-22
+
+* Fixed compatibility with rufus-scheduler-2.0.0 (or newer) in cron
+  generator
+* Started central eventmachine reactor management code
+* Now depends on eventmachine
+
 == 0.1.7.6 (Not released)
 
 * Support for cucumber

data/README.rdoc

@@ -53,6 +53,7 @@ The AMQP generator creates a simple daemon that has all the stub code and config
 == Requirements
 
 * Ruby 1.8.6
+* eventmachine-0.12.8[http://rubyeventmachine.com]
 * rspec (for writing/running your specs)
 
 == Generator Requirements

data/app_generators/daemon_kit/templates/config/environment.rb

@@ -11,12 +11,12 @@ DaemonKit::Initializer.run do |config|
   # The name of the daemon as reported by process monitoring tools
   config.daemon_name = '<%= daemon_name %>'
 
-  # Uncomment to allow multiple instances to run
-  # config.mulitple = true
-
   # Force the daemon to be killed after X seconds from asking it to
   # config.force_kill_wait = 30
 
+  # Log backraces when a thread/daemon dies (Recommended)
+  # config.backtraces = true
+
   # Configure the safety net (see DaemonKit::Safety)
   # config.safety_net.handler = :mail # (or :hoptoad )
   # config.safety_net.mail.host = 'localhost'

data/app_generators/daemon_kit/templates/config/environments/development.rb

@@ -0,0 +1,2 @@
+# This is the same context as the environment.rb file, it is only
+# loaded afterwards and only in the development environment

data/app_generators/daemon_kit/templates/config/environments/production.rb

@@ -0,0 +1,2 @@
+# This is the same context as the environment.rb file, it is only
+# loaded afterwards and only in the production environment

data/app_generators/daemon_kit/templates/config/environments/test.rb

@@ -0,0 +1,2 @@
+# This is the same context as the environment.rb file, it is only
+# loaded afterwards and only in the test environment

data/lib/daemon_kit.rb

@@ -9,7 +9,7 @@ $:.unshift( File.dirname(__FILE__).to_absolute_path ) unless
   $:.include?( File.dirname(__FILE__).to_absolute_path )
 
 module DaemonKit
-  VERSION = '0.1.7.7'
+  VERSION = '0.1.7.8'
 
   autoload :Initializer,    'daemon_kit/initializer'
   autoload :Application,    'daemon_kit/application'

data/lib/daemon_kit/application.rb

@@ -79,7 +79,11 @@ module DaemonKit
           end
         end
 
-        @pid_file.cleanup
+        if @pid_file.running?
+          puts "Process still running, leaving pidfile behind! Consider using configuration.force_kill_wait."
+        else
+          @pid_file.cleanup
+        end
       end
 
       # Call this from inside a daemonized process to complete the

data/lib/daemon_kit/initializer.rb

@@ -61,6 +61,10 @@ module DaemonKit
     end
 
     def self.shutdown
+      DaemonKit.logger.info "Running shutdown hooks"
+
+      log_exceptions if DaemonKit.configuration.backtraces
+
       DaemonKit.logger.warn "Shutting down #{DaemonKit.configuration.daemon_name}"
       exit
     end
@@ -85,6 +89,7 @@ module DaemonKit
 
       include_core_lib
       load_postdaemonize_configs
+      configure_backtraces
 
       set_process_name
 
@@ -160,6 +165,7 @@ module DaemonKit
       term_proc = Proc.new { DaemonKit::Initializer.shutdown }
       configuration.trap( 'INT', term_proc )
       configuration.trap( 'TERM', term_proc )
+      at_exit { DaemonKit::Initializer.shutdown }
     end
 
     def include_core_lib
@@ -168,9 +174,38 @@ module DaemonKit
       end
     end
 
+    def configure_backtraces
+      Thread.abort_on_exception = configuration.backtraces
+    end
+
     def set_process_name
       $0 = configuration.daemon_name
     end
+
+    def self.log_exceptions
+      trace_file = File.join( DaemonKit.root, "backtrace-#{Time.now.strftime('%Y%m%d%H%M%S')}-#{Process.pid}.log" )
+      trace_log = Logger.new( trace_file )
+
+      # Find the last exception
+      e = nil
+      ObjectSpace.each_object {|o|
+        if ::Exception === o
+          e = o
+        end
+      }
+
+      trace_log.info "*** Below you'll find the most recent exception thrown, this will likely (but not certainly) be the exception that made #{DaemonKit.configuration.daemon_name} exit abnormally ***"
+      trace_log.error e
+
+      trace_log.info "*** Below you'll find all the exception objects in memory, some of them may have been thrown in your application, others may just be in memory because they are standard exceptions ***"
+      ObjectSpace.each_object {|o|
+        if ::Exception === o
+          trace_log.error o
+        end
+      }
+
+      trace_log.close
+    end
   end
 
   # Holds our various configuration values
@@ -203,7 +238,10 @@ module DaemonKit
     configurable :daemon_name, :locked => true
 
     # Use the force kill patch? Give the number of seconds
-    attr_accessor :force_kill_wait
+    configurable :force_kill_wait
+
+    # Should be log backtraces
+    configurable :backtraces, false
 
     # Collection of signal traps
     attr_reader :signal_traps

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: daemon-kit
 version: !ruby/object:Gem::Version 
-  version: 0.1.7.7
+  version: 0.1.7.8
 platform: ruby
 authors: 
 - Kenneth Kalmer