thin_async 0.0.1 → 0.1.0

data/README.md

@@ -11,14 +11,19 @@ will prevent the EventMachine event loop from running and block all other reques
 ## 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
+    response = Thin::AsyncResponse.new(env)
+    response.status = 201
+    response.headers["X-Muffin-Mode"] = "ACTIVATED!"
+    
+    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
+    
+    response.finish
 
 See example/ dir for more.
 

data/example/headers.ru

@@ -0,0 +1,23 @@
+require File.dirname(__FILE__) + "/../lib/thin/async"
+
+class Headers
+  def call(env)
+    response = Thin::AsyncResponse.new(env)
+    
+    EM.add_timer(1) do
+      response.status = 201
+      response.headers["X-Muffin-Mode"] = "ACTIVATED!"
+      
+      # Headers are sent automatically the first time you call response#<<
+      # and can't be modified afterwards.
+      response.send_headers
+      
+      response << "done"
+      response.done
+    end
+    
+    response.finish
+  end
+end
+
+run Headers.new

data/lib/thin/async.rb

@@ -38,14 +38,15 @@ module Thin
     
     Marker = [-1, {}, []].freeze
     
-    attr_reader :headers
+    attr_reader :headers, :callback
     attr_accessor :status
     
-    def initialize(env)
+    def initialize(env, status=200, headers={})
       @callback = env['async.callback']
       @body = DeferrableBody.new
-      @status = 200
-      @headers = {}
+      @status = status
+      @headers = headers
+      @headers_sent = false
       
       if block_given?
         yield self
@@ -53,19 +54,27 @@ module Thin
       end
     end
     
+    def send_headers
+      return if @headers_sent
+      @callback.call [@status, @headers, @body]
+      @headers_sent = true
+    end
+    
     def write(body)
+      send_headers
       @body.call(body.respond_to?(:each) ? body : [body])
     end
     alias :<< :write
     
+    # Tell Thin the response is complete and the connection can be closed.
     def done
-      EM.next_tick do
-        @body.succeed
-      end
+      send_headers
+      EM.next_tick { @body.succeed }
     end
     
+    # Tell Thin the response is gonna be sent asynchronously.
+    # The status code of -1 is the magic trick here.
     def finish
-      @callback.call [@status, @headers, @body]
       Marker
     end
   end

data/thin_async.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |s|
   s.name = "thin_async"
-  s.version = "0.0.1"
+  s.version = "0.1.0"
   s.summary = "A nice wrapper to send response body asynchronously with Thin"
  
   s.author = "Marc-Andre Cournoyer"

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification 
 name: thin_async
 version: !ruby/object:Gem::Version 
-  version: 0.0.1
+  version: 0.1.0
 platform: ruby
 authors: 
 - Marc-Andre Cournoyer
@@ -9,7 +9,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2009-12-13 00:00:00 -05:00
+date: 2010-03-08 00:00:00 -05:00
 default_executable: 
 dependencies: 
 - !ruby/object:Gem::Dependency 
@@ -31,10 +31,10 @@ extensions: []
 extra_rdoc_files: []
 
 files: 
+- example/headers.ru
 - 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