light-daemon 0.9.5 → 0.9.6

data/README

@@ -0,0 +1,57 @@
+light-daemon is a ruby gem. It could help developers quickly build a daemon which prefok worker processes and monitor them.
+The usage is very simple:
+
+    #---------------------------------------------------------------------------------------------
+    require 'rubygems'
+    require 'light_daemon'
+
+    class Client
+      def initialize
+      end
+    
+      def call
+        `echo "process: #{Process.pid}" >> /tmp/light-daemon.txt`
+        sleep 3
+        true
+      end
+    end
+    
+    LightDaemon::Daemon.start(Client.new, :children=> 2, :pid_file => "/tmp/light-daemon.pid" )
+    #---------------------------------------------------------------------------------------------
+
+What you need to do is:
+1. Create your worker class. Define a method "call" and put the real work into it. 
+2. The method "call" needs to return true for the daemon to continuously call it.
+3. You need to tell the daemon how many worker processes you want and a filename for daemon to store
+   the PID of the daemon process.
+4. If the method "call" returns false, the daemon will kill this work process and create a new one. 
+   This would be very helpful if your code might have memory leaking and you want it to restart after 
+   certain criteria is met. An example is as following:
+
+    #---------------------------------------------------------------------------------------------
+    require 'rubygems'
+    require 'light_daemon'
+
+    class Client
+      def initialize
+        @count = 0
+      end
+    
+      def call
+        `echo "process: #{Process.pid}" >> /tmp/light-daemon.txt`
+        sleep 3
+        @count +=1
+        (@count < 100)? true : false
+      end
+    end
+    
+    LightDaemon::Daemon.start(Client.new, :children=> 2, :pid_file => "/tmp/light-daemon.pid" )
+    #---------------------------------------------------------------------------------------------
+
+
+
+
+Yi Zhang
+yzhang[dot]wa[at]gmail[dot]com
+3/11/2012
+

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: light-daemon
 version: !ruby/object:Gem::Version 
-  hash: 49
+  hash: 55
   prerelease: 
   segments: 
   - 0
   - 9
-  - 5
-  version: 0.9.5
+  - 6
+  version: 0.9.6
 platform: ruby
 authors: 
 - Yi Zhang
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2012-03-10 00:00:00 -08:00
+date: 2012-03-11 00:00:00 -08:00
 default_executable: 
 dependencies: []
 
@@ -28,9 +28,10 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- README
 - lib/light_daemon.rb
 has_rdoc: true
-homepage: http://rubygems.org/gems/light_daemon
+homepage: http://rubygems.org/gems/light_daemon://github.com/yzhanginwa/light-daemon
 licenses: []
 
 post_install_message: 
@@ -62,6 +63,6 @@ rubyforge_project:
 rubygems_version: 1.6.2
 signing_key: 
 specification_version: 3
-summary: Light Daemon!
+summary: Light Daemon is awesome!
 test_files: []