puma 0.8.0

data/COPYING

@@ -0,0 +1,55 @@
+Mongrel Web Server (Mongrel) is copyrighted free software by Zed A. Shaw
+<zedshaw at zedshaw dot com> You can redistribute it and/or modify it under
+either the terms of the GPL or the conditions below:
+
+1. You may make and give away verbatim copies of the source form of the
+   software without restriction, provided that you duplicate all of the
+   original copyright notices and associated disclaimers.
+
+2. You may modify your copy of the software in any way, provided that
+   you do at least ONE of the following:
+
+     a) place your modifications in the Public Domain or otherwise make them
+     Freely Available, such as by posting said modifications to Usenet or an
+     equivalent medium, or by allowing the author to include your
+     modifications in the software.
+
+     b) use the modified software only within your corporation or
+        organization.
+
+     c) rename any non-standard executables so the names do not conflict with
+     standard executables, which must also be provided.
+
+     d) make other distribution arrangements with the author.
+
+3. You may distribute the software in object code or executable
+   form, provided that you do at least ONE of the following:
+
+     a) distribute the executables and library files of the software,
+     together with instructions (in the manual page or equivalent) on where
+     to get the original distribution.
+
+     b) accompany the distribution with the machine-readable source of the
+     software.
+
+     c) give non-standard executables non-standard names, with
+        instructions on where to get the original software distribution.
+
+     d) make other distribution arrangements with the author.
+
+4. You may modify and include the part of the software into any other
+   software (possibly commercial).  But some files in the distribution
+   are not written by the author, so that they are not under this terms.
+
+5. The scripts and library files supplied as input to or produced as 
+   output from the software do not automatically fall under the
+   copyright of the software, but belong to whomever generated them, 
+   and may be sold commercially, and may be aggregated with this
+   software.
+
+6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+   IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+   WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+   PURPOSE.
+
+

data/History.txt

@@ -0,0 +1,69 @@
+=== 1.2.0.beta.1 / 2010-07-??
+
+Improvements:
+
+* Ruby 1.9 early compatbility: Merged commits form Eric Wong and Matt Aimonetti.
+* Better RubyGems support thanks to added env she-bang to mongrel_rails executable.
+* Smartly load http11 extension using fat-binary approach.
+* Better detection of Windows platform (usage of RbConfig::CONFIG instead of RUBY_PLATFORM)
+
+Bugfixes:
+
+* Fixed proper version reporting under 1.9
+* Consider MinGW as valid Windows platform.
+* Properly drop PID when daemonizing (EngineYard patched 1.1.5.1).
+
+Reorganization:
+
+* Rake task project reorganization and reformat using Hoe.
+* Compile extension using rake-compiler
+* Upgraded http11_parser to work with Ragel 6.2
+* Deprecated obsolete Windows service example scripts (from 2006!)
+* Relocate Http11 JRuby extension to share http11 C extension folder and name.
+
+=== 1.1.5 / 2008-05-22
+
+* Fix bug where num_processors is not actually set from mongrel_rails.
+
+
+=== 1.1.4 / 2008-02-29
+
+* Fix camping handler. Correct treatment of @throttle parameter.
+
+
+=== 1.1.3 / 2007-12-29
+
+* Fix security flaw of DirHandler; reported on mailing list.
+
+
+=== 1.1.2 /  2007-12-15
+
+* Fix worker termination bug; fix JRuby 1.0.3 load order issue; fix require issue on systems without Rubygems.
+
+
+=== 1.1.1 / 2007-11-12
+
+* Fix mongrel_rails restart bug; fix bug with Rack status codes.
+
+
+=== 1.1 / 2007-11-01
+
+* Pure Ruby URIClassifier.
+* More modular architecture.
+* JRuby support.
+* Move C URIClassifier into mongrel_experimental project.
+
+
+=== 1.0.4 / 2007-10-29
+
+* Backport fixes for versioning inconsistency, mongrel_rails bug, and DirHandler bug.
+
+
+=== 1.0.3
+
+* Fix user-switching bug; make people upgrade to the latest from the RC.
+
+
+=== 1.0.2
+
+* Signed gem; many minor bugfixes and patches.

data/LICENSE

@@ -0,0 +1,26 @@
+Some code copyright (c) 2005, Zed Shaw
+Copyright (c) 2011, Evan Phoenix
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without 
+modification, are permitted provided that the following conditions are met:
+
+* Redistributions of source code must retain the above copyright notice, this
+  list of conditions and the following disclaimer.
+* Redistributions in binary form must reproduce the above copyright notice
+  this list of conditions and the following disclaimer in the documentation
+  and/or other materials provided with the distribution.
+* Neither the name of the Evan Phoenix nor the names of its contributors 
+  may be used to endorse or promote products derived from this software 
+  without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" 
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE 
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE 
+DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE 
+FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL 
+DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR 
+SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER 
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, 
+OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE 
+OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

data/Manifest.txt

@@ -0,0 +1,57 @@
+COPYING
+History.txt
+LICENSE
+Manifest.txt
+README.md
+Rakefile
+TODO
+bin/puma
+examples/builder.rb
+examples/camping/README
+examples/camping/blog.rb
+examples/camping/tepee.rb
+examples/httpd.conf
+examples/mime.yaml
+examples/mongrel.conf
+examples/monitrc
+examples/random_thrash.rb
+examples/simpletest.rb
+examples/webrick_compare.rb
+ext/puma_http11/Http11Service.java
+ext/puma_http11/ext_help.h
+ext/puma_http11/extconf.rb
+ext/puma_http11/puma_http11.c
+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/mongrel/Http11.java
+ext/puma_http11/org/jruby/mongrel/Http11Parser.java
+lib/puma.rb
+lib/puma/cli.rb
+lib/puma/const.rb
+lib/puma/events.rb
+lib/puma/gems.rb
+lib/puma/mime_types.yml
+lib/puma/server.rb
+lib/puma/thread_pool.rb
+lib/puma/utils.rb
+lib/rack/handler/puma.rb
+puma.gemspec
+tasks/gem.rake
+tasks/java.rake
+tasks/native.rake
+tasks/ragel.rake
+test/lobster.ru
+test/mime.yaml
+test/test_http10.rb
+test/test_http11.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

data/README.md

@@ -0,0 +1,60 @@
+# Puma: A Ruby Web Server Built For Concurrency
+
+## 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.
+
+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.
+
+## License
+
+Puma is copyright 2011 Evan Phoenix and contributors. It is licensed under the BSD license. See the include LICENSE file for details.
+
+## 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:
+
+    $ gem install puma
+
+Now you should have the puma command available in your PATH, so just do the following:
+
+    $ puma app.ru
+
+## Install
+
+    $ gem install puma
+
+## Advanced Setup
+
+### Sinatra
+
+You can run your Sinatra application with Puma from the command line like this:
+
+    $ ruby app.rb -s Puma
+
+Or you can configure your application to always use Puma:
+
+    require 'sinatra'
+    configure { set :server, :puma }
+
+If you use Bundler, make sure you add Puma to your Gemfile (see below).
+
+### Rails
+
+First, make sure Puma is in your Gemfile:
+
+    gem 'puma'
+
+Then start your server with the `rails` command:
+
+    $ rails s puma
+
+### Rackup
+
+You can pass it as an option to `rackup`:
+
+    $ rackup -s puma
+
+Alternatively, you can modify your `config.ru` to choose Puma by default, by adding the following as the first line:
+
+    #\ -s puma

data/Rakefile

@@ -0,0 +1,10 @@
+#
+# NOTE: Keep this file clean.
+# Add your customizations inside tasks directory.
+# Thank You.
+#
+
+require 'rubygems'
+
+# load rakefile extensions (tasks)
+Dir['tasks/*.rake'].sort.each { |f| load f }

data/TODO

@@ -0,0 +1,5 @@
+
+v1.2. Rewrite and merge mongrel cluster and mongrel_rails into something small and maintainable. Remove gem_plugin entirely.
+
+v1.1.1. See if Java is setting the server version string in the request properly.
+

data/bin/puma

@@ -0,0 +1,15 @@
+#!/usr/bin/env ruby
+#
+# Copyright (c) 2011 Evan Phoenix
+#
+
+require 'puma/cli'
+
+cli = Puma::CLI.new ARGV
+
+begin
+  cli.run
+rescue => e
+  STDERR.puts e.message
+  exit 1
+end

data/examples/builder.rb

@@ -0,0 +1,29 @@
+require 'mongrel'
+
+class TestPlugin < GemPlugin::Plugin "/handlers"
+  include Mongrel::HttpHandlerPlugin
+
+  def process(request, response)
+    STDERR.puts "My options are: #{options.inspect}"
+    STDERR.puts "Request Was:"
+    STDERR.puts request.params.to_yaml
+  end
+end
+
+config = Mongrel::Configurator.new :host => "127.0.0.1" do
+  load_plugins :includes => ["mongrel"], :excludes => ["rails"]
+  daemonize :cwd => Dir.pwd, :log_file => "mongrel.log", :pid_file => "mongrel.pid"
+  
+  listener :port => 3000 do
+    uri "/app", :handler => plugin("/handlers/testplugin", :test => "that")
+    uri "/app", :handler => Mongrel::DirHandler.new(".")
+    load_plugins :includes => ["mongrel", "rails"]
+  end
+
+  trap("INT") { stop }
+  run
+end
+
+config.join
+
+

data/examples/camping/README

@@ -0,0 +1,3 @@
+To get these examples running, install Camping.
+
+Instructions here: http://code.whytheluckystiff.net/camping/

data/examples/camping/blog.rb

@@ -0,0 +1,294 @@
+#!/usr/bin/env ruby
+
+$:.unshift File.dirname(__FILE__) + "/../../lib"
+require 'rubygems'
+require_gem 'camping', '>=1.4'
+require 'camping/session'
+  
+Camping.goes :Blog
+
+module Blog
+    include Camping::Session
+end
+
+module Blog::Models
+    def self.schema(&block)
+        @@schema = block if block_given?
+        @@schema
+    end
+  
+    class Post < Base; belongs_to :user; end
+    class Comment < Base; belongs_to :user; end
+    class User < Base; end
+end
+
+Blog::Models.schema do
+    create_table :blog_posts, :force => true do |t|
+      t.column :id,       :integer, :null => false
+      t.column :user_id,  :integer, :null => false
+      t.column :title,    :string,  :limit => 255
+      t.column :body,     :text
+    end
+    create_table :blog_users, :force => true do |t|
+      t.column :id,       :integer, :null => false
+      t.column :username, :string
+      t.column :password, :string
+    end
+    create_table :blog_comments, :force => true do |t|
+      t.column :id,       :integer, :null => false
+      t.column :post_id,  :integer, :null => false
+      t.column :username, :string
+      t.column :body,     :text
+    end
+    execute "INSERT INTO blog_users (username, password) VALUES ('admin', 'camping')"
+end
+
+module Blog::Controllers
+    class Index < R '/'
+        def get
+            @posts = Post.find :all
+            render :index
+        end
+    end
+     
+    class Add
+        def get
+            unless @state.user_id.blank?
+                @user = User.find @state.user_id
+                @post = Post.new
+            end
+            render :add
+        end
+        def post
+            post = Post.create :title => input.post_title, :body => input.post_body,
+                               :user_id => @state.user_id
+            redirect View, post
+        end
+    end
+
+    class Info < R '/info/(\d+)', '/info/(\w+)/(\d+)', '/info', '/info/(\d+)/(\d+)/(\d+)/([\w-]+)'
+        def get(*args)
+            div do
+                code args.inspect; br; br
+                code ENV.inspect; br
+                code "Link: #{R(Info, 1, 2)}"
+            end
+        end
+    end
+
+    class View < R '/view/(\d+)'
+        def get post_id 
+            @post = Post.find post_id
+            @comments = Models::Comment.find :all, :conditions => ['post_id = ?', post_id]
+            render :view
+        end
+    end
+     
+    class Edit < R '/edit/(\d+)', '/edit'
+        def get post_id 
+            unless @state.user_id.blank?
+                @user = User.find @state.user_id
+            end
+            @post = Post.find post_id
+            render :edit
+        end
+     
+        def post
+            @post = Post.find input.post_id
+            @post.update_attributes :title => input.post_title, :body => input.post_body
+            redirect View, @post
+        end
+    end
+     
+    class Comment
+        def post
+            Models::Comment.create(:username => input.post_username,
+                       :body => input.post_body, :post_id => input.post_id)
+            redirect View, input.post_id
+        end
+    end
+     
+    class Login
+        def post
+            @user = User.find :first, :conditions => ['username = ? AND password = ?', input.username, input.password]
+     
+            if @user
+                @login = 'login success !'
+                @state.user_id = @user.id
+            else
+                @login = 'wrong user name or password'
+            end
+            render :login
+        end
+    end
+     
+    class Logout
+        def get
+            @state.user_id = nil
+            render :logout
+        end
+    end
+     
+    class Style < R '/styles.css'
+        def get
+            @headers["Content-Type"] = "text/css; charset=utf-8"
+            @body = %{
+                body {
+                    font-family: Utopia, Georga, serif;
+                }
+                h1.header {
+                    background-color: #fef;
+                    margin: 0; padding: 10px;
+                }
+                div.content {
+                    padding: 10px;
+                }
+            }
+        end
+    end
+end
+
+module Blog::Views
+
+    def layout
+      html do
+        head do
+          title 'blog'
+          link :rel => 'stylesheet', :type => 'text/css', 
+               :href => '/styles.css', :media => 'screen'
+        end
+        body do
+          h1.header { a 'blog', :href => R(Index) }
+          div.content do
+            self << yield
+          end
+        end
+      end
+    end
+
+    def index
+      if @posts.empty?
+        p 'No posts found.'
+        p { a 'Add', :href => R(Add) }
+      else
+        for post in @posts
+          _post(post)
+        end
+      end
+    end
+
+    def login
+      p { b @login }
+      p { a 'Continue', :href => R(Add) }
+    end
+
+    def logout
+      p "You have been logged out."
+      p { a 'Continue', :href => R(Index) }
+    end
+
+    def add
+      if @user
+        _form(post, :action => R(Add))
+      else
+        _login
+      end
+    end
+
+    def edit
+      if @user
+        _form(post, :action => R(Edit))
+      else
+        _login
+      end
+    end
+
+    def view
+        _post(post)
+
+        p "Comment for this post:"
+        for c in @comments
+          h1 c.username
+          p c.body
+        end
+
+        form :action => R(Comment), :method => 'post' do
+          label 'Name', :for => 'post_username'; br
+          input :name => 'post_username', :type => 'text'; br
+          label 'Comment', :for => 'post_body'; br
+          textarea :name => 'post_body' do; end; br
+          input :type => 'hidden', :name => 'post_id', :value => post.id
+          input :type => 'submit'
+        end
+    end
+
+    # partials
+    def _login
+      form :action => R(Login), :method => 'post' do
+        label 'Username', :for => 'username'; br
+        input :name => 'username', :type => 'text'; br
+
+        label 'Password', :for => 'password'; br
+        input :name => 'password', :type => 'text'; br
+
+        input :type => 'submit', :name => 'login', :value => 'Login'
+      end
+    end
+
+    def _post(post)
+      h1 post.title
+      p post.body
+      p do
+        a "Edit", :href => R(Edit, post)
+        a "View", :href => R(View, post)
+      end
+    end
+
+    def _form(post, opts)
+      p do
+        text "You are logged in as #{@user.username} | "
+        a 'Logout', :href => R(Logout)
+      end
+      form({:method => 'post'}.merge(opts)) do
+        label 'Title', :for => 'post_title'; br
+        input :name => 'post_title', :type => 'text', 
+              :value => post.title; br
+
+        label 'Body', :for => 'post_body'; br
+        textarea post.body, :name => 'post_body'; br
+
+        input :type => 'hidden', :name => 'post_id', :value => post.id
+        input :type => 'submit'
+      end
+    end
+end
+ 
+def Blog.create
+    Camping::Models::Session.create_schema
+    unless Blog::Models::Post.table_exists?
+        ActiveRecord::Schema.define(&Blog::Models.schema)
+    end
+end
+
+if __FILE__ == $0
+  require 'mongrel/camping'
+
+  Blog::Models::Base.establish_connection :adapter => 'sqlite3', :database => 'blog.db'
+  Blog::Models::Base.logger = Logger.new('camping.log')
+  Blog::Models::Base.threaded_connections=false
+  Blog.create
+  
+  # Use the Configurator as an example rather than Mongrel::Camping.start
+  config = Mongrel::Configurator.new :host => "0.0.0.0" do
+    listener :port => 3002 do
+      uri "/blog", :handler => Mongrel::Camping::CampingHandler.new(Blog)
+      uri "/favicon", :handler => Mongrel::Error404Handler.new("")
+      trap("INT") { stop }
+      run
+    end
+  end
+
+  puts "** Blog example is running at http://localhost:3002/blog"
+  puts "** Default username is `admin', password is `camping'"
+  config.join
+end