daemonizer 0.0.7 → 0.0.8

data/README.md

@@ -0,0 +1,111 @@
+Daemonizer: Simple framework for creating daemons with Ruby
+====================================
+
+**Homepage**:     [http://daemonizer.org](http://daemonizer.org)   
+**Git**:          [http://github.com/glebpom/daemonizer](http://github.com/glebpom/daemonizer)   
+**Author**:       Gleb Pomykalov    
+**Copyright**:    2010    
+**License**:      MIT License    
+**Status**:       alpha    
+
+Synopsis
+--------
+
+Daemonizer is a simple ruby framework to create custom daemons. It is fully 
+compatible with EventMachine, Rails and any other Ruby frameworks. Two workers
+type supported - forked and threaded.
+
+
+Feature List
+------------
+                                                                              
+**1. Demfile (similar to Gemfile, Rakefile)** as a configuration file. It is 
+possible to describe different background pools there.
+
+**2. Two engines**: :thread and :fork. (thread is currently broken)
+                                                                              
+**3. Monitoring**: If child is found dead it will be immediately 
+restored
+                                                                              
+**4. Logging** (via [http://log4r.rubyforge.org/]log4r)
+
+Installing
+----------
+
+To install Daemonizer, use the following command:
+
+    $ gem install daemonizer
+    
+(Add `sudo` if you're installing under a POSIX system as root)                                                                              
+
+Usage
+-----
+
+**Demfile example:**
+
+    engine :fork 
+    workers 2
+
+    pool :daemonizer do
+      workers 4
+      poll_period 5
+      log_file "log/daemonizer.log" #relative to Demfile
+  
+      before_init do |logger, block|
+        block.call
+      end
+  
+      after_init do |logger, worker_id, workers_count|
+        logger.info "Started #{worker_id} from #{workers_count}"
+    
+        exit = false
+    
+        stop = proc {
+          exit = true
+        }
+
+        trap('TERM', stop)
+        trap('INT', stop)
+        trap('EXIT', stop)
+    
+        loop do
+          break if exit
+          logger.info "Ping #{worker_id}"
+          sleep 10
+        end
+    
+        true
+      end
+    end
+
+    pool :new_daemonizer do
+      workers 4
+      poll_period 5
+      log_file "log/daemonizer.log" #relative to Demfile
+
+      handler ::MyBackgroundSolution::DaemonizerHandler
+  
+      set_option :queue, lambda { |worker_id, worker_count| "queue_#{worker_id}"}
+    end
+
+
+**Handler example**
+
+    module MyBackgroundSolution
+      class DaemonizerHandler < Daemonizer::Handler
+        def before_init(block)
+          require File.join(Daemonizer.root, '/config/environment') #Require rails
+          require 'my_background_solution/worker' #Require our code
+          super #now we are ready to fork
+        end
+
+        def after_init 
+          #we are in worker process
+          logger.info "Starting cycle. We are number #{worker_id} from #{workers_count}"
+          logger.info "Options - #{option(:queue)}" #We can get option :queue, which is set with set_option in pool configuration
+          worker = Worker.new
+          worker.run
+          logger.info "Ending cycle"
+        end
+      end
+    end

data/VERSION

@@ -1 +1 @@
-0.0.7
+0.0.8

data/daemonizer.gemspec

@@ -5,7 +5,7 @@
 
 Gem::Specification.new do |s|
   s.name = %q{daemonizer}
-  s.version = "0.0.7"
+  s.version = "0.0.8"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Gleb Pomykalov"]
@@ -15,10 +15,10 @@ Gem::Specification.new do |s|
   s.email = %q{glebpom@gmail.com}
   s.executables = ["daemonizer"]
   s.extra_rdoc_files = [
-    "README"
+    "README.md"
   ]
   s.files = [
-    "README",
+    "README.md",
      "Rakefile",
      "VERSION",
      "bin/daemonizer",

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: daemonizer
 version: !ruby/object:Gem::Version 
-  hash: 17
+  hash: 15
   prerelease: false
   segments: 
   - 0
   - 0
-  - 7
-  version: 0.0.7
+  - 8
+  version: 0.0.8
 platform: ruby
 authors: 
 - Gleb Pomykalov
@@ -57,9 +57,9 @@ executables:
 extensions: []
 
 extra_rdoc_files: 
-- README
+- README.md
 files: 
-- README
+- README.md
 - Rakefile
 - VERSION
 - bin/daemonizer

data/README

@@ -1,44 +0,0 @@
-engine :fork 
-workers 2
-
-pool :daemonizer do
-  workers 4
-  poll_period 5
-  log_file "log/daemonizer.log" #relative to Demfile
-  
-  before_init do |logger, block|
-    block.call
-  end
-  
-  after_init do |logger, worker_id, workers_count|
-    logger.info "Started #{worker_id} from #{workers_count}"
-    
-    exit = false
-    
-    stop = proc {
-      exit = true
-    }
-
-    trap('TERM', stop)
-    trap('INT', stop)
-    trap('EXIT', stop)
-    
-    loop do
-      break if exit
-      logger.info "Ping #{worker_id}"
-      sleep 10
-    end
-    
-    true
-  end
-end
-
-pool :new_daemonizer do
-  workers 4
-  poll_period 5
-  log_file "log/daemonizer.log" #relative to Demfile
-
-  handler ::AsyncObserver::DaemonizerHandler
-  
-  set_option :queue, lambda { |worker_id, worker_count| "queue_#{worker_id}"}
-end