puma 0.9.2 → 0.9.3

data/README.md

@@ -2,28 +2,24 @@
 
 ## Description
 
-Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications.  It is designed for running rack apps only.
+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.
 
-What makes Puma so fast is the careful use of an Ragel extension to provide fast, accurate HTTP 1.1 protocol parsing. This makes the server scream without too many portability issues.
+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!
 
-## License
+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.
 
-Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.
+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).
 
 ## Quick Start
 
-The easiest way to get started with Puma is to install it via RubyGems and then run a Ruby on Rails application. You can do this easily:
+The easiest way to get started with Puma is to install it via RubyGems. You can do this easily:
 
     $ gem install puma
 
-Now you should have the puma command available in your PATH, so just do the following:
+Now you should have the puma command available in your PATH, so just do the following in the root folder of your Rack application:
 
     $ puma app.ru
 
-## Install
-
-    $ gem install puma
-
 ## Advanced Setup
 
 ### Sinatra
@@ -58,3 +54,29 @@ You can pass it as an option to `rackup`:
 Alternatively, you can modify your `config.ru` to choose Puma by default, by adding the following as the first line:
 
     #\ -s puma
+
+## Configuration
+
+Puma provides numerous options for controlling the operation of the server. Consult `puma -h` (or `puma --help`) for a full list.
+
+### Thread Pool
+
+Puma utilizes a dynamic thread pool which you can modify. You can set the minimum and maximum number of threads that are available in the pool with the `-t` (or `--threads`) flag:
+
+    $ puma -t 8:32
+    
+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).
+
+### 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:
+
+    $ puma -b tcp://127.0.0.1:9292
+
+Want to use UNIX Sockets instead of TCP (which can provide a 5-10% performance boost)? No problem!
+
+    $ puma -b unix:///var/run/puma.sock
+
+## License
+
+Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.

data/Rakefile

@@ -1,90 +1,98 @@
-require 'rubygems'
-
-require 'hoe'
+require "hoe"
+require "rake/extensiontask"
+require "rake/javaextensiontask"
 
 IS_JRUBY = defined?(RUBY_ENGINE) ? RUBY_ENGINE == "jruby" : false
 
-HOE = Hoe.spec 'puma' do
+HOE = Hoe.spec "puma" do
   self.rubyforge_name = 'puma'
-  self.readme_file = "README.md"
+  self.readme_file    = "README.md"
+
   developer 'Evan Phoenix', 'evan@phx.io'
 
-  spec_extras[:extensions] = ["ext/puma_http11/extconf.rb"]
+  spec_extras[:extensions]  = ["ext/puma_http11/extconf.rb"]
   spec_extras[:executables] = ['puma', 'pumactl']
 
-  dependency 'rack', '~> 1.2'
+  require_ruby_version ">= 1.8.7"
 
-  extra_dev_deps << ['rake-compiler', "~> 0.7.0"]
+  dependency "rack", "~> 1.2"
 
-  clean_globs.push('test_*.log', 'log')
+  extra_dev_deps << ["rake-compiler", "~> 0.8.0"]
 end
 
-task :test => [:compile]
-
 # hoe/test and rake-compiler don't seem to play well together, so disable
 # hoe/test's .gemtest touch file thingy for now
 HOE.spec.files -= [".gemtest"]
 
+# puma.gemspec
+
 file "#{HOE.spec.name}.gemspec" => ['Rakefile'] do |t|
   puts "Generating #{t.name}"
-  File.open(t.name, 'w') { |f| f.puts HOE.spec.to_ruby }
+  File.open(t.name, 'wb') { |f| f.write HOE.spec.to_ruby }
 end
 
 desc "Generate or update the standalone gemspec file for the project"
 task :gemspec => ["#{HOE.spec.name}.gemspec"]
 
-# the following tasks ease the build of C file from Ragel one
+# generate extension code using Ragel (C and Java)
+desc "Generate extension code (C and Java) using Ragel"
+task :ragel
 
 file 'ext/puma_http11/http11_parser.c' => ['ext/puma_http11/http11_parser.rl'] do |t|
   begin
-    sh "ragel #{t.prerequisites.last} -C -G2 -o #{t.name}"
+    sh "ragel #{t.prerequisites.last} -C -G2 -I ext/puma_http11 -o #{t.name}"
   rescue
     fail "Could not build wrapper using Ragel (it failed or not installed?)"
   end
 end
+task :ragel => ['ext/puma_http11/http11_parser.c']
 
 file 'ext/puma_http11/org/jruby/puma/Http11Parser.java' => ['ext/puma_http11/http11_parser.java.rl'] do |t|
   begin
-    sh "ragel #{t.prerequisites.last} -J -G2 -o #{t.name}"
+    sh "ragel #{t.prerequisites.last} -J -G2 -I ext/puma_http11 -o #{t.name}"
   rescue
     fail "Could not build wrapper using Ragel (it failed or not installed?)"
   end
 end
+task :ragel => ['ext/puma_http11/org/jruby/puma/Http11Parser.java']
+
+# compile extensions using rake-compiler
+# C (MRI, Rubinius)
+Rake::ExtensionTask.new("puma_http11", HOE.spec) do |ext|
+  # place extension inside namespace
+  ext.lib_dir = "lib/puma"
+
+  ext.cross_compile = !!ENV['CROSS']
+  ext.cross_platform = ['i386-mswin32-60', 'i386-mingw32']
+  ext.cross_compiling do |spec|
+    # add fat-binary stub only when cross compiling
+    spec.files << "lib/puma/puma_http11.rb"
+  end
 
-if IS_JRUBY
-  require 'rake/javaextensiontask'
-
-  # build http11 java extension
-  Rake::JavaExtensionTask.new('puma_http11', HOE.spec)
+  CLEAN.include "lib/puma/{1.8,1.9}"
+  CLEAN.include "lib/puma/puma_http11.rb"
+end
 
-  task :ragel => 'ext/puma_http11/org/jruby/puma/Http11Parser.java'
-else
-  # use rake-compiler for building the extension
-  require 'rake/extensiontask'
-  
-  # build http11 C extension
-  Rake::ExtensionTask.new('puma_http11', HOE.spec) do |ext|
-    # define target for extension (supporting fat binaries)
-    if RUBY_PLATFORM =~ /mingw|mswin/ then
-      RUBY_VERSION =~ /(\d+\.\d+)/
-      ext.lib_dir = "lib/#{$1}"
-    elsif ENV['CROSS']
-      # define cross-compilation tasks when not on Windows.
-      ext.cross_compile = true
-      ext.cross_platform = ['i386-mswin32', 'i386-mingw32']
-    end
-  
-    # cleanup versioned library directory
-    CLEAN.include 'lib/{1.8,1.9}'
+# Java (JRuby)
+if defined? JRUBY_VERSION
+  Rake::JavaExtensionTask.new("puma_http11", HOE.spec) do |ext|
+    ext.lib_dir = "lib/puma"
   end
-
-  task :ragel => 'ext/puma_http11/http11_parser.c'
 end
 
-task :ext_clean do
-  sh "rm -rf lib/puma_http11.bundle"
-  sh "rm -rf lib/puma_http11.jar"
-  sh "rm -rf lib/puma_http11.so"
+# the following is a fat-binary stub that will be used when
+# require 'puma/puma_http11' and will use either 1.8 or 1.9 version depending
+# on RUBY_VERSION
+file "lib/puma/puma_http11.rb" do |t|
+  File.open(t.name, "w") do |f|
+    f.puts "RUBY_VERSION =~ /(\d+.\d+)/"
+    f.puts 'require "puma/#{$1}/puma_http11"'
+  end
 end
 
-task :clean => :ext_clean
+# tests require extension be compiled, but depend on the platform
+if IS_JRUBY
+  task :test => [:java]
+else
+  task :test => [:compile]
+end

data/ext/puma_http11/extconf.rb

@@ -2,4 +2,4 @@ require 'mkmf'
 
 dir_config("puma_http11")
 
-create_makefile("puma_http11")
+create_makefile("puma/puma_http11")

data/ext/puma_http11/puma_http11.c

@@ -268,7 +268,7 @@ void HttpParser_free(void *data) {
   TRACE();
 
   if(data) {
-    free(data);
+    xfree(data);
   }
 }
 

data/lib/puma.rb

@@ -1,4 +1,3 @@
-
 # Standard libraries
 require 'socket'
 require 'tempfile'

data/lib/puma/const.rb

@@ -1,4 +1,3 @@
-
 module Puma
 
   # Every standard HTTP code mapped to the appropriate message.  These are
@@ -44,6 +43,11 @@ module Puma
     505  => 'HTTP Version not supported'
   }
 
+  # For some HTTP status codes the client only expects headers.
+  STATUS_WITH_NO_ENTITY_BODY = {
+    204 => true, 205 => true, 304 => true
+  }
+
   # Frequently used constants when constructing requests or responses.  Many times
   # the constant just refers to a string with the same contents.  Using these constants
   # gave about a 3% to 10% performance improvement over using the strings directly.
@@ -71,7 +75,7 @@ module Puma
 
     PATH_INFO = 'PATH_INFO'.freeze
 
-    PUMA_VERSION = VERSION = "0.9.2".freeze
+    PUMA_VERSION = VERSION = "0.9.3".freeze
 
     PUMA_TMP_BASE = "puma".freeze
 

data/lib/puma/control_cli.rb

@@ -46,7 +46,7 @@ module Puma
 
       @parser.parse! @argv
 
-      @state = YAML.load_file(@path)
+      @state = YAML.load File.read(@path)
       @config = @state['config']
 
       cmd = @argv.shift

data/lib/puma/server.rb

@@ -1,4 +1,3 @@
-require 'rubygems'
 require 'rack'
 require 'stringio'
 
@@ -7,7 +6,7 @@ require 'puma/const'
 require 'puma/events'
 require 'puma/null_io'
 
-require 'puma_http11'
+require 'puma/puma_http11'
 
 require 'socket'
 
@@ -194,6 +193,7 @@ module Puma
     #
     def process_client(client)
       parser = HttpParser.new
+      close_socket = true
 
       begin
         while true
@@ -214,7 +214,13 @@ module Puma
             if parser.finished?
               cl = env[CONTENT_LENGTH]
 
-              return unless handle_request(env, client, parser.body, cl)
+              case handle_request(env, client, parser.body, cl)
+              when false
+                return
+              when :async
+                close_socket = false
+                return
+              end
 
               nparsed += parser.body.size if cl
 
@@ -258,7 +264,7 @@ module Puma
 
       ensure
         begin
-          client.close
+          client.close if close_socket
         rescue IOError, SystemCallError
           # Already closed
         rescue StandardError => e
@@ -336,11 +342,20 @@ module Puma
       begin
         begin
           status, headers, res_body = @app.call(env)
+
+          if status == -1
+            unless headers.empty? and res_body == []
+              raise "async response must have empty headers and body"
+            end
+
+            return :async
+          end
         rescue => e
           status, headers, res_body = lowlevel_error(e)
         end
 
         content_length = nil
+        no_body = false
 
         if res_body.kind_of? Array and res_body.size == 1
           content_length = res_body[0].size
@@ -365,6 +380,8 @@ module Puma
             client.write " "
             client.write HTTP_STATUS_CODES[status]
             client.write "\r\n"
+
+            no_body = status < 200 || STATUS_WITH_NO_ENTITY_BODY[status]
           end
         else
           allow_chunked = false
@@ -381,6 +398,8 @@ module Puma
             client.write " "
             client.write HTTP_STATUS_CODES[status]
             client.write "\r\n"
+
+            no_body = status < 200 || STATUS_WITH_NO_ENTITY_BODY[status]
           end
         end
 
@@ -395,6 +414,8 @@ module Puma
           when TRANSFER_ENCODING
             allow_chunked = false
             content_length = nil
+          when CONTENT_TYPE
+            next if no_body
           end
 
           vs.split(NEWLINE).each do |v|
@@ -405,6 +426,11 @@ module Puma
           end
         end
 
+        if no_body
+          client.write line_ending
+          return keep_alive
+        end
+
         if include_keepalive_header
           client.write CONNECTION_KEEP_ALIVE
         elsif !keep_alive

data/puma.gemspec

@@ -2,12 +2,12 @@
 
 Gem::Specification.new do |s|
   s.name = "puma"
-  s.version = "0.9.2"
+  s.version = "0.9.3"
 
   s.required_rubygems_version = Gem::Requirement.new(">= 0") if s.respond_to? :required_rubygems_version=
   s.authors = ["Evan Phoenix"]
-  s.date = "2011-12-19"
-  s.description = "Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications.  It is designed for running rack apps only.\n\nWhat makes Puma so fast is the careful use of an Ragel extension to provide fast, accurate HTTP 1.1 protocol parsing. This makes the server scream without too many portability issues."
+  s.date = "2012-01-09"
+  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.email = ["evan@phx.io"]
   s.executables = ["puma", "pumactl"]
   s.extensions = ["ext/puma_http11/extconf.rb"]
@@ -15,9 +15,10 @@ Gem::Specification.new do |s|
   s.files = ["COPYING", "Gemfile", "History.txt", "LICENSE", "Manifest.txt", "README.md", "Rakefile", "TODO", "bin/puma", "bin/pumactl", "examples/config.rb", "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/org/jruby/puma/Http11.java", "ext/puma_http11/org/jruby/puma/Http11Parser.java", "ext/puma_http11/puma_http11.c", "lib/puma.rb", "lib/puma/app/status.rb", "lib/puma/cli.rb", "lib/puma/configuration.rb", "lib/puma/const.rb", "lib/puma/control_cli.rb", "lib/puma/events.rb", "lib/puma/jruby_restart.rb", "lib/puma/null_io.rb", "lib/puma/rack_patch.rb", "lib/puma/server.rb", "lib/puma/thread_pool.rb", "lib/rack/handler/puma.rb", "puma.gemspec", "test/ab_rs.rb", "test/config/app.rb", "test/hello.ru", "test/lobster.ru", "test/mime.yaml", "test/slow.ru", "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_persistent.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", "test/testhelp.rb", "tools/trickletest.rb"]
   s.rdoc_options = ["--main", "README.md"]
   s.require_paths = ["lib"]
+  s.required_ruby_version = Gem::Requirement.new(">= 1.8.7")
   s.rubyforge_project = "puma"
-  s.rubygems_version = "1.8.12"
-  s.summary = "Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications"
+  s.rubygems_version = "1.8.15"
+  s.summary = "Puma is a simple, fast, and highly concurrent HTTP 1.1 server for Ruby web 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_persistent.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
@@ -25,19 +26,16 @@ Gem::Specification.new do |s|
 
     if Gem::Version.new(Gem::VERSION) >= Gem::Version.new('1.2.0') then
       s.add_runtime_dependency(%q<rack>, ["~> 1.2"])
-      s.add_development_dependency(%q<rake-compiler>, ["~> 0.7.0"])
+      s.add_development_dependency(%q<rake-compiler>, ["~> 0.8.0"])
       s.add_development_dependency(%q<hoe>, ["~> 2.12"])
-      s.add_development_dependency(%q<rdoc>, ["~> 3.10"])
     else
       s.add_dependency(%q<rack>, ["~> 1.2"])
-      s.add_dependency(%q<rake-compiler>, ["~> 0.7.0"])
+      s.add_dependency(%q<rake-compiler>, ["~> 0.8.0"])
       s.add_dependency(%q<hoe>, ["~> 2.12"])
-      s.add_dependency(%q<rdoc>, ["~> 3.10"])
     end
   else
     s.add_dependency(%q<rack>, ["~> 1.2"])
-    s.add_dependency(%q<rake-compiler>, ["~> 0.7.0"])
+    s.add_dependency(%q<rake-compiler>, ["~> 0.8.0"])
     s.add_dependency(%q<hoe>, ["~> 2.12"])
-    s.add_dependency(%q<rdoc>, ["~> 3.10"])
   end
 end

data/test/hello.ru

@@ -1 +1 @@
-run lambda { |env| [200, {}, ["Hello World"]] }
+run lambda { |env| [200, {"Content-Type" => "text/plain"}, ["Hello World"]] }

data/test/test_cli.rb

@@ -1,3 +1,4 @@
+require "rbconfig"
 require 'test/unit'
 require 'puma/cli'
 require 'tempfile'
@@ -27,7 +28,7 @@ class TestCLI < Test::Unit::TestCase
     assert_equal File.read(@tmp_path).strip.to_i, Process.pid
   end
 
-  unless defined? JRUBY_VERSION
+  unless defined?(JRUBY_VERSION) || RbConfig::CONFIG["host_os"] =~ /mingw|mswin/
   def test_control
     url = "unix://#{@tmp_path}"
 
@@ -85,7 +86,7 @@ class TestCLI < Test::Unit::TestCase
     cli.parse_options
     cli.write_state
 
-    data = YAML.load_file(@tmp_path)
+    data = YAML.load File.read(@tmp_path)
 
     assert_equal Process.pid, data["pid"]
 
@@ -95,7 +96,7 @@ class TestCLI < Test::Unit::TestCase
 
     assert m, "'#{url}' is not a URL"
   end
-  end
+  end # JRUBY or Windows
 
   def test_state
     url = "tcp://127.0.0.1:8232"
@@ -103,7 +104,7 @@ class TestCLI < Test::Unit::TestCase
     cli.parse_options
     cli.write_state
 
-    data = YAML.load_file(@tmp_path)
+    data = YAML.load File.read(@tmp_path)
 
     assert_equal Process.pid, data["pid"]
     assert_equal url, data["config"].options[:control_url]

data/test/test_integration.rb

@@ -1,5 +1,5 @@
+require "rbconfig"
 require 'test/unit'
-require 'rubygems'
 require 'socket'
 
 require 'puma/cli'
@@ -19,7 +19,7 @@ class TestIntegration < Test::Unit::TestCase
   end
 
   def test_stop_via_pumactl
-    if defined? JRUBY_VERSION
+    if defined?(JRUBY_VERSION) || RbConfig::CONFIG["host_os"] =~ /mingw|mswin/
       assert true
       return
     end

data/test/test_persistent.rb

@@ -10,6 +10,7 @@ class TestPersistent < Test::Unit::TestCase
     @keep_request = "GET / HTTP/1.0\r\nHost: test.com\r\nContent-Type: text/plain\r\nConnection: Keep-Alive\r\n\r\n"
 
     @valid_post = "POST / HTTP/1.1\r\nHost: test.com\r\nContent-Type: text/plain\r\nContent-Length: 5\r\n\r\nhello"
+    @valid_no_body = "GET / HTTP/1.1\r\nHost: test.com\r\nX-Status: 204\r\nContent-Type: text/plain\r\n\r\n"
 
     @headers = { "X-Header" => "Works" }
     @body = ["Hello"]
@@ -17,7 +18,8 @@ class TestPersistent < Test::Unit::TestCase
 
     @simple = lambda do |env|
       @inputs << env['rack.input']
-      [200, @headers, @body]
+      status = Integer(env['HTTP_X_STATUS'] || 200)
+      [status, @headers, @body]
     end
 
     @server = Puma::Server.new @simple
@@ -76,6 +78,17 @@ class TestPersistent < Test::Unit::TestCase
     assert_equal "Hello", @client.read(5)
   end
 
+  def test_no_body_then_get
+    @client << @valid_no_body
+    assert_equal "HTTP/1.1 204 No Content\r\nX-Header: Works\r\n\r\n", lines(3)
+
+    @client << @valid_request
+    sz = @body[0].size.to_s
+
+    assert_equal "HTTP/1.1 200 OK\r\nX-Header: Works\r\nContent-Length: #{sz}\r\n\r\n", lines(4)
+    assert_equal "Hello", @client.read(5)
+  end
+
   def test_chunked
     @body << "Chunked"
 

data/test/test_unix_socket.rb

@@ -1,10 +1,12 @@
+require "rbconfig"
 require 'test/unit'
 require 'puma/server'
 
 require 'socket'
 
 # UNIX sockets are not recommended on JRuby
-unless defined?(JRUBY_VERSION)
+# (or Windows)
+unless defined?(JRUBY_VERSION) || RbConfig::CONFIG["host_os"] =~ /mingw|mswin/
   class TestPumaUnixSocket < Test::Unit::TestCase
   
     App = lambda { |env| [200, {}, ["Works"]] }
@@ -34,4 +36,4 @@ unless defined?(JRUBY_VERSION)
       sock.close
     end
   end
-end
+end

data/test/testhelp.rb

@@ -2,8 +2,9 @@
 # Copyright (c) 2005 Zed A. Shaw 
 
 
-%w(lib ext bin test).each do |dir| 
-  $LOAD_PATH.unshift File.expand_path("../../#{dir}", __FILE__)
+%w(lib test).each do |d|
+  dir = File.expand_path("../../#{d}", __FILE__)
+  $LOAD_PATH.unshift dir unless $LOAD_PATH.include?(dir)
 end
 
 require 'rubygems'
@@ -18,7 +19,7 @@ require 'puma'
 def redirect_test_io
   yield
 end
-    
+
 # Either takes a string to do a get request against, or a tuple of [URI, HTTP] where
 # HTTP is some kind of Net::HTTP request object (POST, HEAD, etc.)
 def hit(uris)

metadata

@@ -1,13 +1,13 @@
 --- !ruby/object:Gem::Specification 
 name: puma
 version: !ruby/object:Gem::Version 
-  hash: 63
+  hash: 61
   prerelease: 
   segments: 
   - 0
   - 9
-  - 2
-  version: 0.9.2
+  - 3
+  version: 0.9.3
 platform: ruby
 authors: 
 - Evan Phoenix
@@ -15,7 +15,7 @@ autorequire:
 bindir: bin
 cert_chain: []
 
-date: 2011-12-19 00:00:00 Z
+date: 2012-01-09 00:00:00 Z
 dependencies: 
 - !ruby/object:Gem::Dependency 
   name: rack
@@ -40,12 +40,12 @@ dependencies:
     requirements: 
     - - ~>
       - !ruby/object:Gem::Version 
-        hash: 3
+        hash: 63
         segments: 
         - 0
-        - 7
+        - 8
         - 0
-        version: 0.7.0
+        version: 0.8.0
   type: :development
   version_requirements: *id002
 - !ruby/object:Gem::Dependency 
@@ -63,25 +63,14 @@ dependencies:
         version: "2.12"
   type: :development
   version_requirements: *id003
-- !ruby/object:Gem::Dependency 
-  name: rdoc
-  prerelease: false
-  requirement: &id004 !ruby/object:Gem::Requirement 
-    none: false
-    requirements: 
-    - - ~>
-      - !ruby/object:Gem::Version 
-        hash: 19
-        segments: 
-        - 3
-        - 10
-        version: "3.10"
-  type: :development
-  version_requirements: *id004
 description: |-
-  Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications.  It is designed for running rack apps only.
+  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.
   
-  What makes Puma so fast is the careful use of an Ragel extension to provide fast, accurate HTTP 1.1 protocol parsing. This makes the server scream without too many portability issues.
+  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: 
@@ -163,10 +152,12 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements: 
   - - ">="
     - !ruby/object:Gem::Version 
-      hash: 3
+      hash: 57
       segments: 
-      - 0
-      version: "0"
+      - 1
+      - 8
+      - 7
+      version: 1.8.7
 required_rubygems_version: !ruby/object:Gem::Requirement 
   none: false
   requirements: 
@@ -179,10 +170,10 @@ required_rubygems_version: !ruby/object:Gem::Requirement
 requirements: []
 
 rubyforge_project: puma
-rubygems_version: 1.8.12
+rubygems_version: 1.8.15
 signing_key: 
 specification_version: 3
-summary: Puma is a small library that provides a very fast and concurrent HTTP 1.1 server for Ruby web applications
+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