looper 0.0.3

data/README.textile

@@ -0,0 +1,46 @@
+Looper is a dead simple Ruby module for daemonizing your code, meant for use with Rails' script/runner. No forking involved, no detaching, simply running a nice healthy loop, but allowing your code to bail out of it, and making it responsive to signals.
+
+You implement a class like "DoSomething" that checks for new message objects and then does something to them. This class will include @Looper@ in order to easily loop, respond to shutdown signals, and it can then be run via script/runner as a daemon.
+
+The loop handles sleeping between runs, and will catch any unhandled exceptions that bubble up and keep on truckin'. Thus, if you want to exit on a particular exception, you've got to rescue it in your code and set @@run@ to @false@.
+
+Here's an example usage:
+
+<pre>
+require 'looper'
+
+class DoSomething
+  include Looper
+  
+  attr_accessor :run
+  
+  def initialize(config)
+    @run = true
+    # do config stuff, etc...
+    @sleep = config[:sleep].nil? ? 60 : config[:sleep]
+  end # initialize
+  
+  def run
+    loopme(@sleep) do
+      begin
+        # this is where the meat of your code goes...
+        messages = twitter.direct_messages({:since => since.strftime("%a, %d %b %Y %H:%M:%S %Z")})
+      rescue Twitter::EpicFailure => e
+        puts "bailing out, dude!"
+        # set run to false to put the kabosh on the next run
+        @run = false
+      end
+    end
+  end
+end
+
+# and here's how we kick it off:
+DoSomething.new( { :sleep => 10 } ).run
+
+</pre>
+
+Now we can just kick that off any way we like and background the process, but we tend to use it with script/runner in our Rails environments to have access to our models and such. It boils down to:
+
+@$ nohup script/runner -e RAILS_ENV /path/to/DoSomething.rb@
+
+And then looking up the PID by matching on /path/to/DoSomething.rb via grep and use kill to send the term signal. 

data/lib/looper.rb

@@ -0,0 +1,71 @@
+# Copyright (c) 2008 Zetetic LLC
+
+# Permission is hereby granted, free of charge, to any person
+# obtaining a copy of this software and associated documentation
+# files (the "Software"), to deal in the Software without
+# restriction, including without limitation the rights to use,
+# copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the
+# Software is furnished to do so, subject to the following
+# conditions:
+
+# The above copyright notice and this permission notice shall be
+# included in all copies or substantial portions of the Software.
+
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+# EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES
+# OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+# NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT
+# HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+# WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
+# OTHER DEALINGS IN THE SOFTWARE.
+
+module Looper
+  
+  def trap_signals
+    sigtrap = proc { 
+      puts "caught trapped signal, shutting down"
+      @run = false 
+    }
+    ["SIGTERM", "SIGINT", "SIGHUP"].each do |signal|
+      trap signal, sigtrap
+    end
+  end
+
+  def loopme(run_every = 10)
+    # we don't want to delay output to sdtout until the program stops, we want feedback!
+    $stdout.sync=true
+    
+    trap_signals
+    
+    @run = true
+    
+    puts "#{Time.now} process started with #{run_every} loop. kill #{Process.pid} to stop"
+    
+    last_run = Time.now - run_every - 1
+    while (@run) do
+      now = Time.now
+      if last_run + run_every < now
+        begin
+          yield
+        rescue Exception => e
+          puts "Uncaught exception bubbled up: \n#{e.class}: #{e.message}\n\t#{e.backtrace.join("\n\t")} "
+        end
+        last_run = now
+      end  
+      sleep(2)
+    end
+    puts "#{Time.now} shutting down"
+  end
+  
+  def write_pid(filename, pid)
+    file = File.new(filename, "w")
+    file.print pid.to_s
+    file.close
+  end
+  
+  def exit_loop
+    @run = false
+  end
+end

data/looper.gemspec

@@ -0,0 +1,18 @@
+Gem::Specification.new do |s|
+  s.name     = "looper"
+  s.version  = "0.0.3"
+  s.date     = "2009-01-21"
+  s.summary  = "Module for really simple daemons"
+  s.email    = "wgray@zetetic.net"
+  s.homepage = "http://github.com/billymeltdown/looper"
+  s.description = "Looper is a module that your class can use to become a really, really simple daemon"
+  s.has_rdoc = false
+  s.authors  = ["Billy Gray", "Stephen Lombardo"]
+  s.files    = [ "README.textile", 
+		"looper.gemspec", 
+		"lib/looper.rb" ]
+	s.require_paths = ["lib"]
+  s.test_files = [ ]
+  s.rdoc_options = [ ]
+  s.extra_rdoc_files = [ ]
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+name: looper
+version: !ruby/object:Gem::Version 
+  version: 0.0.3
+platform: ruby
+authors: 
+- Billy Gray
+- Stephen Lombardo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-21 00:00:00 -05:00
+default_executable: 
+dependencies: []
+
+description: Looper is a module that your class can use to become a really, really simple daemon
+email: wgray@zetetic.net
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- README.textile
+- looper.gemspec
+- lib/looper.rb
+has_rdoc: false
+homepage: http://github.com/billymeltdown/looper
+post_install_message: 
+rdoc_options: []
+
+require_paths: 
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements: 
+  - - ">="
+    - !ruby/object:Gem::Version 
+      version: "0"
+  version: 
+requirements: []
+
+rubyforge_project: 
+rubygems_version: 1.3.1
+signing_key: 
+specification_version: 2
+summary: Module for really simple daemons
+test_files: []
+