puma 2.0.1 → 2.1.0

data/Gemfile

@@ -5,4 +5,6 @@ gem "rdoc"
 gem "rake-compiler"
 gem "rack"
 
+gem 'minitest', '~> 4.0'
+
 gem "jruby-openssl", :platform => "jruby"

data/History.txt

@@ -1,3 +1,32 @@
+=== 2.1.0 / 2013-06-18
+
+* 3 minor features:
+  * Allow listening socket to be configured via Capistrano variable
+  * Output results from 'stat's command when using pumactl
+  * Support systemd socket activation
+
+* 15 bug fixes:
+  * Deal with pipes closing while stopping. Fixes #270
+  * Error out early if there is no app configured
+  * Handle ConnectionError rather than the lowlevel exceptions
+  * tune with `-C` config file and `on_worker_boot`
+  * use `-w`
+  * Fixed some typos in upstart scripts
+  * Make sure to use bytesize instead of size (MiniSSL write)
+  * Fix an error in puma-manager.conf
+  * fix: stop leaking sockets on restart (affects ruby 1.9.3 or before)
+  * Ignore errors on the cross-thread pipe. Fixes #246
+  * Ignore errors while uncorking the socket (it might already be closed)
+  * Ignore the body on a HEAD request. Fixes #278
+  * Handle all engine data when possible. Fixes #251.
+  * Handle all read exceptions properly. Fixes #252
+  * Handle errors from the server better
+
+* 3 doc changes:
+  * Add note about on_worker_boot hook
+  * Add some documentation for Clustered mode
+  * Added quotes to /etc/puma.conf
+
 === 2.0.1 / 2013-04-30
 
 * 1 bug fix:

data/README.md

@@ -4,6 +4,10 @@
 
 ## Description
 
+Puma is a simple, fast, threaded, and highly concurrent HTTP 1.1 server for Ruby/Rack applications. Puma is intended for use in both development and production environments. In order to get the best throughput, it is highly recommended that you use a  Ruby implementation with real threads like Rubinius or JRuby.
+
+## Built For Speed & Concurrency
+
 Puma is a simple, fast, and highly concurrent HTTP 1.1 server for Ruby web applications. It can be used with any application that supports Rack, and is considered the replacement for Webrick and Mongrel. It was designed to be the go-to server for [Rubinius](http://rubini.us), but also works well with JRuby and MRI. Puma is intended for use in both development and production environments.
 
 Under the hood, Puma processes requests using a C-optimized Ragel extension (inherited from Mongrel) that provides fast, accurate HTTP 1.1 protocol parsing in a portable way. Puma then serves the request in a thread from an internal thread pool (which you can control). This allows Puma to provide real concurrency for your web application!
@@ -69,6 +73,31 @@ Puma utilizes a dynamic thread pool which you can modify. You can set the minimu
 
 Puma will automatically scale the number of threads based on how much traffic is present. The current default is `0:16`. Feel free to experiment, but be careful not to set the number of maximum threads to a very large number, as you may exhaust resources on the system (or hit resource limits).
 
+### Clustered mode
+
+Puma 2 offers clustered mode, allowing you to use forked processes to handle multiple incoming requests concurrently, in addition to threads already provided. You can tune the number of workers with the `-w` (or `--workers`) flag:
+
+    $ puma -t 8:32 -w 3
+    
+On a ruby implementation that offers native threads, you should tune this number to match the number of cores available. 
+Note that threads are still used in clustered mode, and the `-t` thread flag setting is per worker, so `-w 2 -t 16:16` will be 32 threads.
+
+Additionally, you can specify a block in your configuration that will be run on boot of each worker:
+
+    # config/puma.rb
+    on_worker_boot do
+      # configuration here
+    end
+
+This code can be used to setup the process before booting the application, allowing 
+you to do some puma-specific things that you don't want to embed in your application. 
+For instance, you could fire a log notification that a worker booted or send something to statsd. 
+This can be called multiple times to add hooks.
+
+Be sure to specify the location of your configuration file:
+
+    $ puma -t 8:32 -w 3 -C config/puma.rb
+
 ### Binding TCP / Sockets
 
 In contrast to many other server configs which require multiple flags, Puma simply uses one URI parameter with the `-b` (or `--bind`) flag:
@@ -165,4 +194,4 @@ $ bundle exec cap puma:stop
 
 ## License
 
-Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.
+Puma is copyright 2013 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.

data/lib/puma/binder.rb

@@ -53,6 +53,24 @@ module Puma
           @inherited_fds[url] = fd.to_i
           remove << k
         end
+        if k =~ /LISTEN_FDS/ && ENV['LISTEN_PID'].to_i == $$
+          v.to_i.times do |num|
+            fd = num + 3
+            sock = TCPServer.for_fd(fd)
+            begin
+              url = "unix://" + Socket.unpack_sockaddr_un(sock.getsockname)
+            rescue ArgumentError
+              port, addr = Socket.unpack_sockaddr_in(sock.getsockname)
+              if addr =~ /\:/
+                addr = "[#{addr}]"
+              end
+              url = "tcp://#{addr}:#{port}"
+            end
+            @inherited_fds[url] = sock
+          end
+          ENV.delete k
+          ENV.delete 'LISTEN_PID'
+        end
       end
 
       remove.each do |k|
@@ -141,7 +159,12 @@ module Puma
         logger.log "* Closing unused inherited connection: #{str}"
 
         begin
-          IO.for_fd(fd).close
+          if fd.kind_of? TCPServer
+            fd.close
+          else
+            IO.for_fd(fd).close
+          end
+
         rescue SystemCallError
         end
 
@@ -244,7 +267,11 @@ module Puma
     def inherit_unix_listener(path, fd)
       @unix_paths << path
 
-      s = UNIXServer.for_fd fd
+      if fd.kind_of? TCPServer
+        s = fd
+      else
+        s = UNIXServer.for_fd fd
+      end
       @ios << s
 
       s

data/lib/puma/capistrano.rb

@@ -11,13 +11,14 @@ Capistrano::Configuration.instance.load do
   _cset(:puma_cmd) { "#{fetch(:bundle_cmd, 'bundle')} exec puma" }
   _cset(:pumactl_cmd) { "#{fetch(:bundle_cmd, 'bundle')} exec pumactl" }
   _cset(:puma_state) { "#{shared_path}/sockets/puma.state" }
+  _cset(:puma_socket) { "unix://#{shared_path}/sockets/puma.sock" }
   _cset(:puma_role) { :app }
 
   namespace :puma do
     desc 'Start puma'
     task :start, :roles => lambda { fetch(:puma_role) }, :on_no_matching_servers => :continue do
       puma_env = fetch(:rack_env, fetch(:rails_env, 'production'))
-      run "cd #{current_path} && #{fetch(:puma_cmd)} -q -d -e #{puma_env} -b 'unix://#{shared_path}/sockets/puma.sock' -S #{fetch(:puma_state)} --control 'unix://#{shared_path}/sockets/pumactl.sock'", :pty => false
+      run "cd #{current_path} && #{fetch(:puma_cmd)} -q -d -e #{puma_env} -b '#{fetch(:puma_socket)}' -S #{fetch(:puma_state)} --control 'unix://#{shared_path}/sockets/pumactl.sock'", :pty => false
     end
 
     desc 'Stop puma'

data/lib/puma/cli.rb

@@ -117,7 +117,7 @@ module Puma
         require 'puma/jruby_restart'
         JRubyRestart.chdir_exec(@restart_dir, @restart_argv)
       else
-        redirects = {}
+        redirects = {:close_others => true}
         @binder.listeners.each_with_index do |(l,io),i|
           ENV["PUMA_INHERIT_#{i}"] = "#{io.to_i}:#{l}"
           redirects[io.to_i] = io.to_i
@@ -419,6 +419,11 @@ module Puma
 
       @binder.parse @options[:binds], self
 
+      unless @config.app_configured?
+        error "No application configured, nothing to run"
+        exit 1
+      end
+
       if @options[:daemon]
         Process.daemon(true, @io_redirected)
       end
@@ -547,7 +552,12 @@ module Puma
         server.stop
       end
 
-      @worker_write << "b#{Process.pid}\n"
+      begin
+        @worker_write << "b#{Process.pid}\n"
+      rescue SystemCallError, IOError
+        STDERR.puts "Master seems to have exitted, exitting."
+        return
+      end
 
       server.run.join
 
@@ -643,6 +653,13 @@ module Puma
       end
     end
 
+    def wakeup!
+      begin
+        @wakeup.write "!" unless @wakeup.closed?
+      rescue SystemCallError, IOError
+      end
+    end
+
     def run_cluster
       log "Puma #{Puma::Const::PUMA_VERSION} starting in cluster mode..."
       log "* Process workers: #{@options[:workers]}"
@@ -651,10 +668,15 @@ module Puma
 
       @binder.parse @options[:binds], self
 
-      read, write = Puma::Util.pipe
+      unless @config.app_configured?
+        error "No application configured, nothing to run"
+        exit 1
+      end
+
+      read, @wakeup = Puma::Util.pipe
 
       Signal.trap "SIGCHLD" do
-        write.write "!"
+        wakeup!
       end
 
       stop = false
@@ -663,7 +685,7 @@ module Puma
         Signal.trap "SIGUSR2" do
           @restart = true
           stop = true
-          write.write "!"
+          wakeup!
         end
       rescue Exception
       end
@@ -672,7 +694,7 @@ module Puma
 
       begin
         Signal.trap "SIGTERM" do
-          # The worker installs there own SIGTERM when booted.
+          # The worker installs their own SIGTERM when booted.
           # Until then, this is run by the worker and the worker
           # should just exit if they get it.
           if Process.pid != master_pid
@@ -680,7 +702,7 @@ module Puma
             exit! 0
           else
             stop = true
-            write.write "!"
+            wakeup!
           end
         end
       rescue Exception
@@ -691,7 +713,7 @@ module Puma
       begin
         Signal.trap "SIGUSR1" do
           phased_restart = true
-          write.write "!"
+          wakeup!
         end
       rescue Exception
       end
@@ -715,12 +737,12 @@ module Puma
 
       write_state
 
-      @master_read, @worker_write = read, write
+      @master_read, @worker_write = read, @wakeup
       spawn_workers
 
       Signal.trap "SIGINT" do
         stop = true
-        write.write "!"
+        wakeup!
       end
 
       begin
@@ -761,7 +783,7 @@ module Puma
         @check_pipe.close
         @suicide_pipe.close
         read.close
-        write.close
+        @wakeup.close
       end
 
       if @restart

data/lib/puma/client.rb

@@ -16,6 +16,9 @@ if Puma::IS_JRUBY
 end
 
 module Puma
+
+  class ConnectionError < RuntimeError; end
+
   class Client
     include Puma::Const
 
@@ -139,6 +142,8 @@ module Puma
         data = @io.read_nonblock(CHUNK_SIZE)
       rescue Errno::EAGAIN
         return false
+      rescue SystemCallError, IOError
+        raise ConnectionError, "Connection error detected during read"
       end
 
       if @buffer
@@ -223,6 +228,8 @@ module Puma
         chunk = @io.read_nonblock(want)
       rescue Errno::EAGAIN
         return false
+      rescue SystemCallError, IOError
+        raise ConnectionError, "Connection error detected during read"
       end
 
       # No chunk means a closed socket

data/lib/puma/configuration.rb

@@ -67,6 +67,16 @@ module Puma
       end
     end
 
+    # Indicate if there is a properly configured app
+    #
+    def app_configured?
+      @options[:app] || File.exists?(rackup)
+    end
+
+    def rackup
+      @options[:rackup] || DefaultRackup
+    end
+
     # Load the specified rackup file, pull an options from
     # the rackup file, and set @app.
     #
@@ -74,13 +84,11 @@ module Puma
       app = @options[:app]
 
       unless app
-        path = @options[:rackup] || DefaultRackup
-
-        unless File.exists?(path)
-          raise "Missing rackup file '#{path}'"
+        unless File.exists?(rackup)
+          raise "Missing rackup file '#{rackup}'"
         end
 
-        app, options = Rack::Builder.parse_file path
+        app, options = Rack::Builder.parse_file rackup
         @options.merge! options
 
         options.each do |key,val|

data/lib/puma/const.rb

@@ -28,7 +28,7 @@ module Puma
   # too taxing on performance.
   module Const
 
-    PUMA_VERSION = VERSION = "2.0.1".freeze
+    PUMA_VERSION = VERSION = "2.1.0".freeze
 
     FAST_TRACK_KA_TIMEOUT = 0.2
 

data/lib/puma/control_cli.rb

@@ -138,7 +138,15 @@ module Puma
 
         @server << "GET #{url} HTTP/1.0\r\n\r\n"
 
-        response = @server.read.split("\r\n")
+        unless data = @server.read
+          raise "Server closed connection before responding"
+        end
+
+        response = data.split("\r\n")
+
+        if response.empty?
+          raise "Server sent empty response"
+        end
 
         (@http,@code,@message) = response.first.split(" ")
 
@@ -149,6 +157,7 @@ module Puma
         end
 
         message "Command #{@options[:command]} sent success"
+        message response.last if @options[:command] == "stats"
       end
       
       @server.close

data/lib/puma/minissl.rb

@@ -46,19 +46,20 @@ module Puma
       end
 
       def write(data)
-        need = data.size
+        need = data.bytesize
 
         while true
           wrote = @engine.write data
           enc = @engine.extract
 
-          if enc
-            @socket.syswrite enc
+          while enc
+            @socket.write enc
+            enc = @engine.extract
           end
 
           need -= wrote
 
-          return data.size if need == 0
+          return data.bytesize if need == 0
 
           data = data[need..-1]
         end

data/lib/puma/server.rb

@@ -94,7 +94,10 @@ module Puma
       end
 
       def uncork_socket(socket)
-        socket.setsockopt(6, 3, 0) if socket.kind_of? TCPSocket
+        begin
+          socket.setsockopt(6, 3, 0) if socket.kind_of? TCPSocket
+        rescue IOError
+        end
       end
     else
       def cork_socket(socket)
@@ -135,7 +138,7 @@ module Puma
           client.close
 
           @events.parse_error self, client.env, e
-        rescue IOError
+        rescue ConnectionError
           client.close
         else
           if process_now
@@ -259,7 +262,7 @@ module Puma
         end
 
       # The client disconnected while we were reading data
-      rescue IOError, SystemCallError => e
+      rescue ConnectionError
         # Swallow them. The ensure tries to close +client+ down
 
       # The client doesn't know HTTP well
@@ -351,6 +354,8 @@ module Puma
 
       body = req.body
 
+      head = env[REQUEST_METHOD] == HEAD
+
       env[RACK_INPUT] = body
       env[RACK_URL_SCHEME] =  env[HTTPS_KEY] ? HTTPS : HTTP
 
@@ -381,7 +386,7 @@ module Puma
         end
 
         content_length = nil
-        no_body = false
+        no_body = head
 
         if res_body.kind_of? Array and res_body.size == 1
           content_length = res_body[0].bytesize
@@ -407,7 +412,7 @@ module Puma
             lines.append "HTTP/1.1 ", status.to_s, " ",
                          HTTP_STATUS_CODES[status], line_ending
 
-            no_body = status < 200 || STATUS_WITH_NO_ENTITY_BODY[status]
+            no_body ||= status < 200 || STATUS_WITH_NO_ENTITY_BODY[status]
           end
         else
           allow_chunked = false
@@ -422,7 +427,7 @@ module Puma
             lines.append "HTTP/1.0 ", status.to_s, " ",
                          HTTP_STATUS_CODES[status], line_ending
 
-            no_body = status < 200 || STATUS_WITH_NO_ENTITY_BODY[status]
+            no_body ||= status < 200 || STATUS_WITH_NO_ENTITY_BODY[status]
           end
         end
 
@@ -579,19 +584,31 @@ module Puma
     # off the request queue before finally exiting.
     #
     def stop(sync=false)
-      @notify << STOP_COMMAND
+      begin
+        @notify << STOP_COMMAND
+      rescue IOError
+        # The server, in another thread, is shutting down
+      end
 
       @thread.join if @thread && sync
     end
 
     def halt(sync=false)
-      @notify << HALT_COMMAND
+      begin
+        @notify << HALT_COMMAND
+      rescue IOError
+        # The server, in another thread, is shutting down
+      end
 
       @thread.join if @thread && sync
     end
 
     def begin_restart
-      @notify << RESTART_COMMAND
+      begin
+        @notify << RESTART_COMMAND
+      rescue IOError
+        # The server, in another thread, is shutting down
+      end
     end
 
     def fast_write(io, str)

data/puma.gemspec

@@ -2,12 +2,12 @@
 
 Gem::Specification.new do |s|
   s.name = "puma"
-  s.version = "2.0.1"
+  s.version = "2.1.0"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Evan Phoenix"]
-  s.date = "2013-04-30"
-  s.description = "Puma is a simple, fast, and highly concurrent HTTP 1.1 server for Ruby web applications. It can be used with any application that supports Rack, and is considered the replacement for Webrick and Mongrel. It was designed to be the go-to server for [Rubinius](http://rubini.us), but also works well with JRuby and MRI. Puma is intended for use in both development and production environments.\n\nUnder the hood, Puma processes requests using a C-optimized Ragel extension (inherited from Mongrel) that provides fast, accurate HTTP 1.1 protocol parsing in a portable way. Puma then serves the request in a thread from an internal thread pool (which you can control). This allows Puma to provide real concurrency for your web application!\n\nWith Rubinius 2.0, Puma will utilize all cores on your CPU with real threads, meaning you won't have to spawn multiple processes to increase throughput. You can expect to see a similar benefit from JRuby.\n\nOn MRI, there is a Global Interpreter Lock (GIL) that ensures only one thread can be run at a time. But if you're doing a lot of blocking IO (such as HTTP calls to external APIs like Twitter), Puma still improves MRI's throughput by allowing blocking IO to be run concurrently (EventMachine-based servers such as Thin turn off this ability, requiring you to use special libraries). Your mileage may vary. In order to get the best throughput, it is highly recommended that you use a Ruby implementation with real threads like [Rubinius](http://rubini.us) or [JRuby](http://jruby.org)."
+  s.date = "2013-06-18"
+  s.description = "Puma is a simple, fast, threaded, and highly concurrent HTTP 1.1 server for Ruby/Rack applications. Puma is intended for use in both development and production environments. In order to get the best throughput, it is highly recommended that you use a  Ruby implementation with real threads like Rubinius or JRuby."
   s.email = ["evan@phx.io"]
   s.executables = ["puma", "pumactl"]
   s.extensions = ["ext/puma_http11/extconf.rb"]
@@ -19,7 +19,7 @@ Gem::Specification.new do |s|
   s.required_ruby_version = Gem::Requirement.new(">= 1.8.7")
   s.rubyforge_project = "puma"
   s.rubygems_version = "1.8.25"
-  s.summary = "Puma is a simple, fast, and highly concurrent HTTP 1.1 server for Ruby web applications"
+  s.summary = "Puma is a simple, fast, threaded, and highly concurrent HTTP 1.1 server for Ruby/Rack applications"
   s.test_files = ["test/test_app_status.rb", "test/test_cli.rb", "test/test_config.rb", "test/test_http10.rb", "test/test_http11.rb", "test/test_integration.rb", "test/test_iobuffer.rb", "test/test_minissl.rb", "test/test_null_io.rb", "test/test_persistent.rb", "test/test_puma_server.rb", "test/test_rack_handler.rb", "test/test_rack_server.rb", "test/test_thread_pool.rb", "test/test_unix_socket.rb", "test/test_ws.rb"]
 
   if s.respond_to? :specification_version then

data/test/test_app_status.rb

@@ -82,7 +82,7 @@ class TestAppStatus < Test::Unit::TestCase
   end
 
   def test_alternate_location
-    status, _ , app = lint('__alternatE_location_/stats')
+    status, _ , _ = lint('__alternatE_location_/stats')
     assert_equal 200, status
   end
 end

data/test/test_puma_server.rb

@@ -162,4 +162,46 @@ class TestPumaServer < Test::Unit::TestCase
 
     assert_equal "80", res.body
   end
+
+  def test_HEAD_has_no_body
+    @server.app = proc { |env| [200, {"Foo" => "Bar"}, ["hello"]] }
+
+    @server.add_tcp_listener @host, @port
+    @server.run
+
+    sock = TCPSocket.new @host, @port
+    sock << "HEAD / HTTP/1.0\r\n\r\n"
+
+    data = sock.read
+
+    assert_equal "HTTP/1.0 200 OK\r\nFoo: Bar\r\n\r\n", data
+  end
+
+  def test_GET_with_empty_body_has_sane_chunking
+    @server.app = proc { |env| [200, {}, [""]] }
+
+    @server.add_tcp_listener @host, @port
+    @server.run
+
+    sock = TCPSocket.new @host, @port
+    sock << "HEAD / HTTP/1.0\r\n\r\n"
+
+    data = sock.read
+
+    assert_equal "HTTP/1.0 200 OK\r\n\r\n", data
+  end
+
+  def test_GET_with_no_body_has_sane_chunking
+    @server.app = proc { |env| [200, {}, [""]] }
+
+    @server.add_tcp_listener @host, @port
+    @server.run
+
+    sock = TCPSocket.new @host, @port
+    sock << "HEAD / HTTP/1.0\r\n\r\n"
+
+    data = sock.read
+
+    assert_equal "HTTP/1.0 200 OK\r\n\r\n", data
+  end
 end

data/tools/jungle/upstart/puma-manager.conf

@@ -6,9 +6,9 @@
 #
 # See puma.conf for how to manage a single Puma instance.
 #
-# Use "stop workers" to stop all Puma instances.
-# Use "start workers" to start all instances.
-# Use "restart workers" to restart all instances.
+# Use "stop puma-manager" to stop all Puma instances.
+# Use "start puma-manager" to start all instances.
+# Use "restart puma-manager" to restart all instances.
 # Crazy, right?
 #
 
@@ -20,12 +20,12 @@ stop on runlevel [06]
 
 # Set this to the number of Puma processes you want
 # to run on this machine
-env PUMA_CONF=/etc/puma.conf
+env PUMA_CONF="/etc/puma.conf"
 
 pre-start script
   for i in `cat $PUMA_CONF`; do
     app=`echo $i | cut -d , -f 1`
-    logger -t "puma-manager" "Starting $app" 
+    logger -t "puma-manager" "Starting $app"
     start puma app=$app
   done
 end script

data/tools/jungle/upstart/puma.conf

@@ -6,7 +6,7 @@
 #
 # See workers.conf for how to manage all Puma instances at once.
 #
-# Save this config as /etc/init/puma.conf then mange puma with:
+# Save this config as /etc/init/puma.conf then manage puma with:
 #   sudo start puma index=0
 #   sudo stop puma index=0
 #   sudo status puma index=0
@@ -34,7 +34,7 @@ script
 # respawn as bash so we can source in rbenv/rvm
 exec /bin/bash <<EOT
   export HOME=/home/apps
-  
+
   # Pick your poison :) Or none if you're using a system wide installed Ruby.
   # rbenv
   # source /home/apps/.bash_profile

metadata

@@ -1,201 +1,218 @@
---- !ruby/object:Gem::Specification 
+--- !ruby/object:Gem::Specification
 name: puma
-version: !ruby/object:Gem::Version 
+version: !ruby/object:Gem::Version
+  version: 2.1.0
   prerelease: 
-  version: 2.0.1
 platform: ruby
-authors: 
-  - Evan Phoenix
+authors:
+- Evan Phoenix
 autorequire: 
 bindir: bin
 cert_chain: []
-
-date: 2013-04-30 00:00:00 Z
-dependencies: 
-  - !ruby/object:Gem::Dependency 
-    name: rack
-    version_requirements: &id001 !ruby/object:Gem::Requirement 
-      none: false
-      requirements: 
-        - - ">="
-          - !ruby/object:Gem::Version 
-            version: "1.1"
-        - - <
-          - !ruby/object:Gem::Version 
-            version: "2.0"
-    requirement: *id001
-    prerelease: false
-    type: :runtime
-  - !ruby/object:Gem::Dependency 
-    name: rdoc
-    version_requirements: &id002 !ruby/object:Gem::Requirement 
-      none: false
-      requirements: 
-        - - ~>
-          - !ruby/object:Gem::Version 
-            version: "3.10"
-    requirement: *id002
-    prerelease: false
-    type: :development
-  - !ruby/object:Gem::Dependency 
-    name: rake-compiler
-    version_requirements: &id003 !ruby/object:Gem::Requirement 
-      none: false
-      requirements: 
-        - - ~>
-          - !ruby/object:Gem::Version 
-            version: 0.8.0
-    requirement: *id003
-    prerelease: false
-    type: :development
-  - !ruby/object:Gem::Dependency 
-    name: hoe
-    version_requirements: &id004 !ruby/object:Gem::Requirement 
-      none: false
-      requirements: 
-        - - ~>
-          - !ruby/object:Gem::Version 
-            version: "3.5"
-    requirement: *id004
-    prerelease: false
-    type: :development
-description: |-
-  Puma is a simple, fast, and highly concurrent HTTP 1.1 server for Ruby web applications. It can be used with any application that supports Rack, and is considered the replacement for Webrick and Mongrel. It was designed to be the go-to server for [Rubinius](http://rubini.us), but also works well with JRuby and MRI. Puma is intended for use in both development and production environments.
-  
-  Under the hood, Puma processes requests using a C-optimized Ragel extension (inherited from Mongrel) that provides fast, accurate HTTP 1.1 protocol parsing in a portable way. Puma then serves the request in a thread from an internal thread pool (which you can control). This allows Puma to provide real concurrency for your web application!
-  
-  With Rubinius 2.0, Puma will utilize all cores on your CPU with real threads, meaning you won't have to spawn multiple processes to increase throughput. You can expect to see a similar benefit from JRuby.
-  
-  On MRI, there is a Global Interpreter Lock (GIL) that ensures only one thread can be run at a time. But if you're doing a lot of blocking IO (such as HTTP calls to external APIs like Twitter), Puma still improves MRI's throughput by allowing blocking IO to be run concurrently (EventMachine-based servers such as Thin turn off this ability, requiring you to use special libraries). Your mileage may vary. In order to get the best throughput, it is highly recommended that you use a Ruby implementation with real threads like [Rubinius](http://rubini.us) or [JRuby](http://jruby.org).
-email: 
-  - evan@phx.io
-executables: 
-  - puma
-  - pumactl
-extensions: 
-  - ext/puma_http11/extconf.rb
-extra_rdoc_files: 
-  - History.txt
-  - Manifest.txt
-files: 
-  - COPYING
-  - Gemfile
-  - History.txt
-  - LICENSE
-  - Manifest.txt
-  - README.md
-  - Rakefile
-  - TODO
-  - bin/puma
-  - bin/pumactl
-  - docs/config.md
-  - docs/nginx.md
-  - ext/puma_http11/PumaHttp11Service.java
-  - ext/puma_http11/ext_help.h
-  - ext/puma_http11/extconf.rb
-  - ext/puma_http11/http11_parser.c
-  - ext/puma_http11/http11_parser.h
-  - ext/puma_http11/http11_parser.java.rl
-  - ext/puma_http11/http11_parser.rl
-  - ext/puma_http11/http11_parser_common.rl
-  - ext/puma_http11/io_buffer.c
-  - ext/puma_http11/mini_ssl.c
-  - ext/puma_http11/org/jruby/puma/Http11.java
-  - ext/puma_http11/org/jruby/puma/Http11Parser.java
-  - ext/puma_http11/org/jruby/puma/MiniSSL.java
-  - ext/puma_http11/puma_http11.c
-  - lib/puma.rb
-  - lib/puma/accept_nonblock.rb
-  - lib/puma/app/status.rb
-  - lib/puma/binder.rb
-  - lib/puma/capistrano.rb
-  - lib/puma/cli.rb
-  - lib/puma/client.rb
-  - lib/puma/compat.rb
-  - lib/puma/configuration.rb
-  - lib/puma/const.rb
-  - lib/puma/control_cli.rb
-  - lib/puma/daemon_ext.rb
-  - lib/puma/delegation.rb
-  - lib/puma/detect.rb
-  - lib/puma/events.rb
-  - lib/puma/io_buffer.rb
-  - lib/puma/java_io_buffer.rb
-  - lib/puma/jruby_restart.rb
-  - lib/puma/minissl.rb
-  - lib/puma/null_io.rb
-  - lib/puma/rack_default.rb
-  - lib/puma/rack_patch.rb
-  - lib/puma/reactor.rb
-  - lib/puma/server.rb
-  - lib/puma/thread_pool.rb
-  - lib/puma/util.rb
-  - lib/rack/handler/puma.rb
-  - puma.gemspec
-  - tools/jungle/init.d/README.md
-  - tools/jungle/init.d/puma
-  - tools/jungle/init.d/run-puma
-  - tools/jungle/upstart/README.md
-  - tools/jungle/upstart/puma-manager.conf
-  - tools/jungle/upstart/puma.conf
-  - test/test_app_status.rb
-  - test/test_cli.rb
-  - test/test_config.rb
-  - test/test_http10.rb
-  - test/test_http11.rb
-  - test/test_integration.rb
-  - test/test_iobuffer.rb
-  - test/test_minissl.rb
-  - test/test_null_io.rb
-  - test/test_persistent.rb
-  - test/test_puma_server.rb
-  - test/test_rack_handler.rb
-  - test/test_rack_server.rb
-  - test/test_thread_pool.rb
-  - test/test_unix_socket.rb
-  - test/test_ws.rb
+date: 2013-06-18 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rack
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '1.1'
+    - - <
+      - !ruby/object:Gem::Version
+        version: '2.0'
+- !ruby/object:Gem::Dependency
+  name: rdoc
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.10'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.10'
+- !ruby/object:Gem::Dependency
+  name: rake-compiler
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: 0.8.0
+- !ruby/object:Gem::Dependency
+  name: hoe
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.5'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ~>
+      - !ruby/object:Gem::Version
+        version: '3.5'
+description: Puma is a simple, fast, threaded, and highly concurrent HTTP 1.1 server
+  for Ruby/Rack applications. Puma is intended for use in both development and production
+  environments. In order to get the best throughput, it is highly recommended that
+  you use a  Ruby implementation with real threads like Rubinius or JRuby.
+email:
+- evan@phx.io
+executables:
+- puma
+- pumactl
+extensions:
+- ext/puma_http11/extconf.rb
+extra_rdoc_files:
+- History.txt
+- Manifest.txt
+files:
+- COPYING
+- Gemfile
+- History.txt
+- LICENSE
+- Manifest.txt
+- README.md
+- Rakefile
+- TODO
+- bin/puma
+- bin/pumactl
+- docs/config.md
+- docs/nginx.md
+- ext/puma_http11/PumaHttp11Service.java
+- ext/puma_http11/ext_help.h
+- ext/puma_http11/extconf.rb
+- ext/puma_http11/http11_parser.c
+- ext/puma_http11/http11_parser.h
+- ext/puma_http11/http11_parser.java.rl
+- ext/puma_http11/http11_parser.rl
+- ext/puma_http11/http11_parser_common.rl
+- ext/puma_http11/io_buffer.c
+- ext/puma_http11/mini_ssl.c
+- ext/puma_http11/org/jruby/puma/Http11.java
+- ext/puma_http11/org/jruby/puma/Http11Parser.java
+- ext/puma_http11/org/jruby/puma/MiniSSL.java
+- ext/puma_http11/puma_http11.c
+- lib/puma.rb
+- lib/puma/accept_nonblock.rb
+- lib/puma/app/status.rb
+- lib/puma/binder.rb
+- lib/puma/capistrano.rb
+- lib/puma/cli.rb
+- lib/puma/client.rb
+- lib/puma/compat.rb
+- lib/puma/configuration.rb
+- lib/puma/const.rb
+- lib/puma/control_cli.rb
+- lib/puma/daemon_ext.rb
+- lib/puma/delegation.rb
+- lib/puma/detect.rb
+- lib/puma/events.rb
+- lib/puma/io_buffer.rb
+- lib/puma/java_io_buffer.rb
+- lib/puma/jruby_restart.rb
+- lib/puma/minissl.rb
+- lib/puma/null_io.rb
+- lib/puma/rack_default.rb
+- lib/puma/rack_patch.rb
+- lib/puma/reactor.rb
+- lib/puma/server.rb
+- lib/puma/thread_pool.rb
+- lib/puma/util.rb
+- lib/rack/handler/puma.rb
+- puma.gemspec
+- tools/jungle/init.d/README.md
+- tools/jungle/init.d/puma
+- tools/jungle/init.d/run-puma
+- tools/jungle/upstart/README.md
+- tools/jungle/upstart/puma-manager.conf
+- tools/jungle/upstart/puma.conf
+- test/test_app_status.rb
+- test/test_cli.rb
+- test/test_config.rb
+- test/test_http10.rb
+- test/test_http11.rb
+- test/test_integration.rb
+- test/test_iobuffer.rb
+- test/test_minissl.rb
+- test/test_null_io.rb
+- test/test_persistent.rb
+- test/test_puma_server.rb
+- test/test_rack_handler.rb
+- test/test_rack_server.rb
+- test/test_thread_pool.rb
+- test/test_unix_socket.rb
+- test/test_ws.rb
 homepage: http://puma.io
 licenses: []
-
 post_install_message: 
-rdoc_options: 
-  - --main
-  - README.md
-require_paths: 
-  - lib
-required_ruby_version: !ruby/object:Gem::Requirement 
+rdoc_options:
+- --main
+- README.md
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: 1.8.7
-required_rubygems_version: !ruby/object:Gem::Requirement 
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: 1.8.7
+required_rubygems_version: !ruby/object:Gem::Requirement
   none: false
-  requirements: 
-    - - ">="
-      - !ruby/object:Gem::Version 
-        version: "0"
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
 requirements: []
-
 rubyforge_project: puma
-rubygems_version: 1.8.24
+rubygems_version: 1.8.25
 signing_key: 
 specification_version: 3
-summary: Puma is a simple, fast, and highly concurrent HTTP 1.1 server for Ruby web applications
-test_files: 
-  - test/test_app_status.rb
-  - test/test_cli.rb
-  - test/test_config.rb
-  - test/test_http10.rb
-  - test/test_http11.rb
-  - test/test_integration.rb
-  - test/test_iobuffer.rb
-  - test/test_minissl.rb
-  - test/test_null_io.rb
-  - test/test_persistent.rb
-  - test/test_puma_server.rb
-  - test/test_rack_handler.rb
-  - test/test_rack_server.rb
-  - test/test_thread_pool.rb
-  - test/test_unix_socket.rb
-  - test/test_ws.rb
+summary: Puma is a simple, fast, threaded, and highly concurrent HTTP 1.1 server for
+  Ruby/Rack applications
+test_files:
+- test/test_app_status.rb
+- test/test_cli.rb
+- test/test_config.rb
+- test/test_http10.rb
+- test/test_http11.rb
+- test/test_integration.rb
+- test/test_iobuffer.rb
+- test/test_minissl.rb
+- test/test_null_io.rb
+- test/test_persistent.rb
+- test/test_puma_server.rb
+- test/test_rack_handler.rb
+- test/test_rack_server.rb
+- test/test_thread_pool.rb
+- test/test_unix_socket.rb
+- test/test_ws.rb