threadless 0.1.0

data/Manifest

@@ -0,0 +1,4 @@
+README.rdoc
+Rakefile
+lib/threadless.rb
+Manifest

data/README.rdoc

@@ -0,0 +1,17 @@
+We all know that rails has a rocky history regarding threads, to say the least. 
+Sadly, that seems also include the Rails port of one of my favourite Merb features: [run_later](http://github.com/mattmatt/run_later).
+
+Basically run_later takes a block, turns it into a Proc, and sends it to a worker threads for later execution. That way the request processing is not hindered in any way. Say, you want to send a "you have just signed-up" email to your users: this is a perfect solution: easy to use, lightweight (you don't need extra middle ware), and semi reliable (no fallback when your system breaks down).
+
+However, I ran into few problems using mattmatt's solution in, at least, development mode: 
+
+- the app regularly ran into class (un)loading issues, and
+- Rails' mysql adapter apparently didn't disposed of used database connections, refusing new connections
+
+While all of the above can be explained as some of the quirks of the development environment it didn't increase the "trust level" into that solution (and I have to point out here, that markmark's code looks pretty good to me, and that these problems more likely arise from the somewhat idiosyncratic behaviour of Rails towards threads)
+
+That made me thinking: why use threads in the first place? After all, what we need is a defined point during request processing that gives us a handle to yield of some piece of code, and which occurs after the request's response has been sent back to the client. And, yes, thanks to metal, I found one.
+
+So here is a solution. It is not as feature complete as markmark's, tests are still missing, and it blocks the server process until the run_later block is finished. (But you have more than one server process running, haven't you?)
+
+Someone out there wants to help move that into a regular plugin?

data/Rakefile

@@ -0,0 +1,14 @@
+require 'rubygems'  
+require 'rake'  
+require 'echoe'  
+
+Echoe.new('threadless', '0.1.0') do |p|  
+  p.description     = "run_later without threads"  
+  p.url             = "http://github.com/pboy/threadless"  
+  p.author          = "pboy"  
+  p.email           = "eno-pboy@open-lab.org"  
+  p.ignore_pattern  = ["tmp/*", "script/*"]  
+  p.development_dependencies = []  
+end  
+
+Dir["#{File.dirname(__FILE__)}/tasks/*.rake"].sort.each { |ext| load ext }

data/lib/threadless.rb

@@ -0,0 +1,85 @@
+#
+# A single threaded runlater implementation
+class Threadless
+  ENV_KEY = "rack.threadless.run_later"
+  
+  module InstanceMethods 
+    def threadless
+      @threadless ||= Adapter.new(request)
+    end
+  end
+  
+  #
+  # The adapter; use it as
+  #
+  #     threadless.run_later do ... end
+  #
+  # from within a controller or a view. 
+  #
+  class Adapter
+    def initialize(request)
+      @request = request
+    end
+    
+    def run_later(run_later = true)
+      if run_later
+        @request.env[ENV_KEY] ||= []
+        @request.env[ENV_KEY].push Proc.new
+      else
+        yield 
+      end
+    end
+  end
+  
+  #
+  # This replaces the metal body piece. It intercepts all messages and
+  # adjusts "close" in such a way that close closes the original body, 
+  # and then executes all the procs that are passed into the c'tor.
+  class Executor
+    def method_missing(sym, *args, &block)
+      @body.__send__ sym, *args, &block
+    end
+    
+    def initialize(body, procs)
+      @body, @procs = body, procs
+    end
+    
+    def close
+      return if @closed
+      @closed = true
+      
+      @body.close if @body.respond_to?(:close)
+
+      @procs.each do |proc| 
+        proc.call
+      end
+    end
+  end
+  
+  #
+  # The metal interface: initializing
+  def initialize(app)
+    @app = app
+  end
+
+  #
+  # The metal interface: call
+  def call(env)
+    status, headers, body = *@app.call(env)
+    
+    body = Executor.new(body, env[ENV_KEY]) if env[ENV_KEY]
+    
+    [ status, headers, body ]
+  end
+end
+
+#
+# -- activate instance methods and middleware, on Rails
+
+if defined?(ActionController)
+  ActionController::Base.send(:include, Threadless::InstanceMethods)
+  ActionController::Base.send(:helper, Threadless::InstanceMethods)
+
+  middleware = ActionController::MiddlewareStack::Middleware.new(self)
+  ActionController::Dispatcher.middleware.push middleware
+end

data/threadless.gemspec

@@ -0,0 +1,30 @@
+# -*- encoding: utf-8 -*-
+
+Gem::Specification.new do |s|
+  s.name = %q{threadless}
+  s.version = "0.1.0"
+
+  s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
+  s.authors = ["pboy"]
+  s.date = %q{2009-12-12}
+  s.description = %q{run_later without threads}
+  s.email = %q{eno-pboy@open-lab.org}
+  s.extra_rdoc_files = ["README.rdoc", "lib/threadless.rb"]
+  s.files = ["README.rdoc", "Rakefile", "lib/threadless.rb", "Manifest", "threadless.gemspec"]
+  s.homepage = %q{http://github.com/pboy/threadless}
+  s.rdoc_options = ["--line-numbers", "--inline-source", "--title", "Threadless", "--main", "README.mdown"]
+  s.require_paths = ["lib"]
+  s.rubyforge_project = %q{threadless}
+  s.rubygems_version = %q{1.3.5}
+  s.summary = %q{run_later without threads}
+
+  if s.respond_to? :specification_version then
+    current_version = Gem::Specification::CURRENT_SPECIFICATION_VERSION
+    s.specification_version = 3
+
+    if Gem::Version.new(Gem::RubyGemsVersion) >= Gem::Version.new('1.2.0') then
+    else
+    end
+  else
+  end
+end

metadata

@@ -0,0 +1,65 @@
+--- !ruby/object:Gem::Specification 
+name: threadless
+version: !ruby/object:Gem::Version 
+  version: 0.1.0
+platform: ruby
+authors: 
+- pboy
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-12 00:00:00 +01:00
+default_executable: 
+dependencies: []
+
+description: run_later without threads
+email: eno-pboy@open-lab.org
+executables: []
+
+extensions: []
+
+extra_rdoc_files: 
+- README.rdoc
+- lib/threadless.rb
+files: 
+- README.rdoc
+- Rakefile
+- lib/threadless.rb
+- Manifest
+- threadless.gemspec
+has_rdoc: true
+homepage: http://github.com/pboy/threadless
+licenses: []
+
+post_install_message: 
+rdoc_options: 
+- --line-numbers
+- --inline-source
+- --title
+- Threadless
+- --main
+- README.mdown
+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: "1.2"
+  version: 
+requirements: []
+
+rubyforge_project: threadless
+rubygems_version: 1.3.5
+signing_key: 
+specification_version: 3
+summary: run_later without threads
+test_files: []
+