thin_async 0.0.1

data/README.md

@@ -0,0 +1,25 @@
+# Thin Asynchronous Response API
+A nice wrapper around Thin's obscure async callback used to send response body asynchronously.
+Which means you can send the response in chunks while allowing Thin to process other requests.
+
+Crazy delicious with em-http-request for file upload, image processing, proxying, etc.
+
+## _WARNING_
+You should not use long blocking operations (Net::HTTP or slow shell calls) with this as it
+will prevent the EventMachine event loop from running and block all other requests.
+
+## Usage
+Inside your Rack app #call(env):
+
+    Thin::AsyncResponse.new(env) do |response|
+      response << "this is ... "
+      EM.add_timer(1) do
+        # This will be sent to the client 1 sec later without blocking other requests.
+        response << "async!"
+        response.done
+      end
+    end
+
+See example/ dir for more.
+
+(c) macournoyer

data/example/simple.ru

@@ -0,0 +1,19 @@
+require File.dirname(__FILE__) + "/../lib/thin/async"
+
+class Simple
+  def call(env)
+    response = Thin::AsyncResponse.new(env)
+    
+    response << " " * 1024
+    
+    response << "this is ... "
+    EM.add_timer(1) do
+      response << "async stuff!"
+      response.done
+    end
+    
+    response.finish
+  end
+end
+
+run Simple.new

data/lib/thin/async.rb

@@ -0,0 +1,72 @@
+module Thin
+  unless defined?(DeferrableBody)
+    # Based on version from James Tucker <raggi@rubyforge.org>
+    class DeferrableBody
+      include EM::Deferrable
+
+      def initialize
+        @queue = []
+      end
+
+      def call(body)
+        @queue << body
+        schedule_dequeue
+      end
+
+      def each(&blk)
+        @body_callback = blk
+        schedule_dequeue
+      end
+  
+      private
+        def schedule_dequeue
+          return unless @body_callback
+          EM.next_tick do
+            next unless body = @queue.shift
+            body.each do |chunk|
+              @body_callback.call(chunk)
+            end
+            schedule_dequeue unless @queue.empty?
+          end
+        end
+    end
+  end
+  
+  # Response whos body is sent asynchronously.
+  class AsyncResponse
+    include Rack::Response::Helpers
+    
+    Marker = [-1, {}, []].freeze
+    
+    attr_reader :headers
+    attr_accessor :status
+    
+    def initialize(env)
+      @callback = env['async.callback']
+      @body = DeferrableBody.new
+      @status = 200
+      @headers = {}
+      
+      if block_given?
+        yield self
+        finish
+      end
+    end
+    
+    def write(body)
+      @body.call(body.respond_to?(:each) ? body : [body])
+    end
+    alias :<< :write
+    
+    def done
+      EM.next_tick do
+        @body.succeed
+      end
+    end
+    
+    def finish
+      @callback.call [@status, @headers, @body]
+      Marker
+    end
+  end
+end

data/thin_async.gemspec

@@ -0,0 +1,13 @@
+Gem::Specification.new do |s|
+  s.name = "thin_async"
+  s.version = "0.0.1"
+  s.summary = "A nice wrapper to send response body asynchronously with Thin"
+ 
+  s.author = "Marc-Andre Cournoyer"
+  s.email = "macournoyer@gmail.com"
+  s.files = Dir["**/*"]
+  s.homepage = "http://github.com/macournoyer/thin_async"
+  s.require_paths = ["lib"]
+ 
+  s.add_dependency "thin", ">= 1.2.1"
+end

metadata

@@ -0,0 +1,68 @@
+--- !ruby/object:Gem::Specification 
+name: thin_async
+version: !ruby/object:Gem::Version 
+  version: 0.0.1
+platform: ruby
+authors: 
+- Marc-Andre Cournoyer
+autorequire: 
+bindir: bin
+cert_chain: []
+
+date: 2009-12-13 00:00:00 -05:00
+default_executable: 
+dependencies: 
+- !ruby/object:Gem::Dependency 
+  name: thin
+  type: :runtime
+  version_requirement: 
+  version_requirements: !ruby/object:Gem::Requirement 
+    requirements: 
+    - - ">="
+      - !ruby/object:Gem::Version 
+        version: 1.2.1
+    version: 
+description: 
+email: macournoyer@gmail.com
+executables: []
+
+extensions: []
+
+extra_rdoc_files: []
+
+files: 
+- example/simple.ru
+- lib/thin/async.rb
+- README.md
+- thin_async-0.0.1.gem
+- thin_async.gemspec
+has_rdoc: true
+homepage: http://github.com/macournoyer/thin_async
+licenses: []
+
+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.5
+signing_key: 
+specification_version: 3
+summary: A nice wrapper to send response body asynchronously with Thin
+test_files: []
+