billymeltdown-looper 0.0.1

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.seconds - 1
+    while (@run) do
+      now = Time.now
+      if last_run + run_every.seconds < 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,17 @@
+Gem::Specification.new do |s|
+  s.name     = "looper"
+  s.version  = "0.0.1"
+  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.test_files = [ ]
+  s.rdoc_options = [ ]
+  s.extra_rdoc_files = [ ]
+end

metadata

@@ -0,0 +1,56 @@
+--- !ruby/object:Gem::Specification 
+name: billymeltdown-looper
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Billy Gray
+- Stephen Lombardo
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-01-21 00:00:00 -08: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.2.0
+signing_key: 
+specification_version: 2
+summary: Module for really simple daemons
+test_files: []
+