JaredKuolt-robustthread 0.2

data/lib/robustthread.rb

@@ -0,0 +1,68 @@
+# This module allows for the creation of a thread that will not simply die when
+# the process dies. Instead, it joins all RobustThreads in Ruby's exit handler.
+#
+# Author:: Jared Kuolt (mailto:me@superjared.com)
+# Copyright:: Copyright (c) 2009 Jared Kuolt
+# License:: MIT License
+
+class RobustThread
+  # The Thread object, brah
+  attr_reader :thread
+  # If the Thread takes a poopie...
+  attr_reader :exception
+  @@exit_handler_initialized = false
+  @@exception_handler = nil
+  # Usage:
+  #
+  #   rt = RobustThread.new(args) do |x, y|
+  #     do_something(x, y)
+  #   end
+  #
+  # If necessary, you can access the actual thread from the +RobustThread+
+  # object via its +thread+ attribute.
+  #
+  #   rt.thread
+  #   => #<Thread:0x7fa1ea57ff88 run>
+  def initialize(*args, &block)
+    RobustThread.init_exit_handler
+    @thread = Thread.new(*args) do |*targs|
+      begin
+        block.call(*targs)
+      rescue => e
+        @exception = e
+        RobustThread.handle_exception(e)
+      end
+    end
+    @thread[:real_ultimate_power] = true
+  end
+
+  # Set exception handler:
+  #
+  #   RobustThread.exception_handler do |exception|
+  #     handle_exception(exception)
+  #   end
+  def RobustThread.exception_handler(&block)
+    unless block.arity == 1
+      raise ArgumentError, "Bad arity for exception handler. It may only accept a single argument"
+    end
+    @@exception_handler = block
+  end
+
+  private
+  # Sets up the exit_handler unless @@exit_handler_initialized
+  def RobustThread.init_exit_handler
+    return if @@exit_handler_initialized
+    at_exit do
+      Thread.list.each do |thread|
+        thread.join if thread[:real_ultimate_power]
+      end
+    end
+    @@exit_handler_initialized = true
+  end
+
+  # Calls exception handler if set (see RobustThread.exception_handler)
+  def RobustThread.handle_exception(exception)
+    return unless @@exception_handler
+    @@exception_handler.call(exception)
+  end
+end

metadata

@@ -0,0 +1,53 @@
+--- !ruby/object:Gem::Specification 
+name: JaredKuolt-robustthread
+version: !ruby/object:Gem::Version 
+  version: "0.2"
+platform: ruby
+authors: 
+- Jared Kuolt
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-05-16 00:00:00 -07:00
+default_executable: 
+dependencies: []
+
+description: Trivial module that allows you to create threads that are not killed if the process exits cleanly
+email: me@superjared.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- lib/robustthread.rb
+has_rdoc: true
+homepage: http://github.com/JaredKuolt/robustthread/tree/master
+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: robustthread
+rubygems_version: 1.2.0
+signing_key: 
+specification_version: 2
+summary: Threads that stay alive
+test_files: []
+