grockit-thin 0.8.2

data/CHANGELOG

@@ -0,0 +1,220 @@
+== 1.0.0 The Big release
+ * Add Content-Length header to response automatically when possible [#74 state:resolved] [dkubb]
+ * Runner now remembers -r, -D and -V parameters so that clustered servers inherit those and
+   `restart` keep your parameters.
+ * Make Set-Cookie header, in Rails adapter, compatible with current Rack spec [Pedro Belo]
+   [#73, state:resolved]
+ * Add --no-epoll option to disable epoll usage on Linux [#61 state:resolved]
+ * Add --force (-f) option to force stopping of a daemonized server [#72 state:resolved]
+ * Update halycon adapter loader [mtodd]
+
+== 0.8.2 Double Margarita release
+ * Require EventMachine 0.12.0
+ * [bug] Fix timeout handling when running command
+ * [bug] Fix hanging when restarting and no process is running in single server move, fixes #67
+ * Added Mack adapter [markbates]
+ * Allow rackup .rb files by getting a conventionally named constant as the app [bmizerany]
+
+== 0.8.1 Rebel Porpoise release
+ * [bug] Rescue all types of errors when processing request, fixes #62
+ * [bug] Use Swiftiply backend when -y option is specified, fixes #63 and #64
+ * Allow passing port as a string in Server.new
+ * Define deferred?(env) in your Rack application to set if a request is handled in a
+	 thread (return true) or not (return false).
+
+== 0.8.0 Dodgy Dentist release
+ * [bug] Fix server crash when header too large.
+ * Add --require (-r) option to require a library, before executing your script.
+ * Rename --rackup short option to -R, warn and load as rackup when file ends with .ru.
+ * List supported adapters in command usage.
+ * Add file adapter to built-in adapter, serve static files in current directory.
+ * Allow disabling signal handling in Server with :signals => false
+ * Make Server.new arguments more flexible, can now specify any of host, port, app or hash options.
+ * Add --backend option to specified which backend to use, closes #55
+ * [bug] Serve static file only on GET and HEAD requests in Rails adapter, fixes #58
+ * Add threaded option to run server in threaded mode, calling the application in a
+   thread allowing for concurrency in the Rack adapter, closes #46
+ * Guess which adapter to use from directory (chdir option)
+   or use specified one in 'adapter' option, re #47.
+
+== 0.7.1 Fancy Pants release
+ * Clean stale PID files when starting as daemon, fixes #53 [Chu Yeow]
+ * Require EventMachine 0.11.0 for UNIX domain sockets. Until it's released, install from:
+   gem install eventmachine --source http://code.macournoyer.com
+ * Ruby 1.8.5 compatibility, closes #49 [Wincent Colaiuta]
+ * Move all EventMachine stuff out of Server, you can now create a Thin Backend that
+   does not depend on EventMachine.
+ * Rename Connector to Backend. Extend Thin::Backends::Base to implement your own.
+ * Fix high memory usage with big POST body, fixes #48
+
+== 0.7.0 Spherical Cow release
+ * Add --max-persistent-conns option to sets the maximum number of persistent connections.
+   Set to 0 to disable Keep-Alive.
+ * INT signal now force stop and QUIT signal gracefully stops.
+ * Warn when descriptors table size can't be set as high as expected.
+ * Eval Rackup config file using top level bindings.
+ * Remove daemons gem dependency on Windows plateform, fixes #45.
+ * Change default timeout from 60 to 30 seconds.
+ * Add --max-conns option to sets the maximum number of file or socket descriptors that
+   your process may open, defaults to 1024.
+ * Tail logfile when stopping and restarting a demonized server, fixes #26.
+ * Wrap application in a Rack::CommonLogger adapter in debug mode.
+ * --debug (-D) option no longer set $DEBUG so logging will be less verbose
+   and Ruby won't be too strict, fixes #36.
+ * Deprecate Server#silent in favour of Logging.silent.
+ * Persistent connection (keep-alive) support.
+ * Fix -s option not being included in generated config file, fixes #37.
+ * Add Swiftiply support. Use w/ the --swiftiply (-y) option in the thin script,
+   closes #28 [Alex MacCaw]
+
+== 0.6.4 Sexy Lobster release
+ * Fix error when stopping server on UNIX domain socket, fixes #42
+ * Rescue errors in Connection#get_peername more gracefully, setting REMOTE_ADDR to nil, fixes #43
+
+== 0.6.3 Ninja Cookie release
+ * Add tasks for Vlad the Deployer in example/vlad.rake [cnantais]
+ * Add Ramaze Rackup config file in example dir [tmm1]
+   Use like this from you Ramaze app dir:
+   
+     thin start -r /path/to/thin/example/ramaze.ru
+   
+ * Add the --rackup option to load a Rack config file instead of the Rails adapter.
+   So you can use any framework with the thin script and start cluster and stuff like that.
+   A Rack config file is one that is usable through the rackup command and looks like this:
+     
+     use Rack::CommonLogger
+     run MyCrazyRackAdapter.new(:uterly, 'cool')
+     
+   Then use it with thin like this:
+     
+     thin start --rackup config.ru
+     
+ * thin config --chrdir ... -C thin/yml do not change current directory anymore, fixes #33.
+ * Add a better sample god config file in example/thin.god that loads all info from config
+   files in /etc/thin. Drop-in replacement for the thin runlevel service [Gump].
+ * Add support for specifying a custom Connector to the server and add more doc about Server
+   configuration.
+ * Add a script to run thin as a runlevel service that can start at startup, closes #31 [Gump]
+   Setup the service like this:
+   
+     sudo thin install /etc/thin
+   
+   This will install the boot script under /etc/init.d/thin. Then copy your config files to
+   /etc/thin. Works only under Linux.
+ * Set process name to 'thin server (0.0.0.0:3000)' when running as a daemon, closes #32.
+ * Make sure chdir option from config file is used when present.
+ * Raise an error when starting a server as a daemon and pid file already exist, fixes #27.
+
+== 0.6.2 Rambo release
+ * Server now let current connections finish before stopping, fixes #18
+ * Fix uploading hanging bug when body is moved to a tempfile,
+   also delete the tempfile properly upon completion, fixes #25
+ * 'thin restart' now sends HUP signals rather then stopping & starting, closes #17
+ * HUP signal now launches a new process with the same options.
+ * Add PID and more info from the last request to the Stats adapter
+   mostly taken from Rack::ShowException.
+ * pid and log files in cluster are no longer required to be relative to the
+   app directory (chdir option), fixes #24
+ * Revert to using #each when building response headers under Ruby 1.8,
+   solves an issue w/ Camping adapter, fixes #22
+ * Restructure thin script options in 3 sections: server, daemon and cluster
+ * Add --only (-o) option to control only one server of a cluster.
+ * Stylize stats page and make the url configurable from the thin script.
+ * Raise error if attempting to use unix sockets on windows.
+ * Add example config files for http://www.tildeslash.com/monit usage.
+   Include the example file using "include /path/to/thin/monit/file" in your monitrc file.
+   The group settings let you do this to manage your clusters:
+   
+     sudo monit -g blog restart all
+    
+   There are examples of thin listening on sockets and thin listening on unix sockets.
+
+== 0.6.1 Cheesecake release
+ * Remove socket file when server stops.
+ * Set back cluster to use 'thin' command to launch servers.
+
+== 0.6.0 Big Pony release
+ * Add support for connection through UNIX domain socket.
+   Use the --socket (-S) option w/ the thin script to configure the socket filename.
+   Nginx support binding to a UNIX socket like this:
+   
+     upstream  backend {
+       server   unix:/tmp/thin.0.sock;
+       server   unix:/tmp/thin.1.sock;
+       server   unix:/tmp/thin.2.sock;
+     }
+  
+   Start your servers like this:
+   
+     thin start -s3 -S/tmp/thin.sock
+   
+ * Remove Server#listen! method. Use Server#start instead.
+ * Server can now yield a Rack::Builder to allow building an app in one call:
+ 
+     Server.start '0.0.0.0', 3000 do
+       use Rack::CommonLogger
+       use Rack::ShowExceptions
+       map "/lobster" do
+         use Rack::Lint
+         run Rack::Lobster.new
+       end
+     end
+     
+ * Add a very basic stats page through Stats adapter, load w/ --stats and browse to /stats.
+ * Add --trace (-V) option to trace request/response and get backtrace w/out all Ruby debug stuff.
+ * Add --config (-C) option to load options from a config file in thin script [Matt Todd].
+ * Alter response headers to output directly to a string.
+ * Improve specs stability.
+ * Move request body to a Tempfile if too big (> 112 MB)
+ * Remove useless check for max header size in Request (already done in the parser)
+
+== 0.5.4 Flying Mustard release
+ * Don't read the full body, use direct streaming when sending response.
+   See: Response#each
+   As a result, the Content-Length can not be calculated anymore.
+   You have to do set this in your adapter. All frameworks do it anyway.
+   It improve memory usage and boost speed for low concurrency.
+   Thanks to Kent Sibilev and Ezra for their help on that one.
+ * Add 'Server' response header
+ * Fix --user and --group option not changing daemon process privileges
+ 
+== 0.5.3 Purple Yogurt release
+ * win32 pre-compiled gem now available
+ * change rake task configuration to allow win32 gem build
+ * Add prefix option to thin script to mount app under a given path.
+
+== 0.5.2 Cheezburger release
+ * Add cluster support through the -s option in the thin script, start 3 thins like this:
+    thin start -s3 -p3000
+   3 thin servers will be started on port 3000, 3001, 3002, also the port number will be
+   injected in the pid and log filenames.
+ * Fix IOError when writing to logger when starting server as a daemon.
+ * Really change directory when the -c option is specified.
+ * Add restart command to thin script.
+ * Fix typos in thin script usage message and expand chdir path.
+ * Rename thin script options to be the same as mongrel_rails script [thronedrk]:
+     -o --host  => -a --address
+     --log-file => --log
+     --pid-file => --pid
+     --env      => --environment
+ 
+== 0.5.1 LOLCAT release
+ * Add URL rewriting to Rails adapter so that page caching works and / fetches index.html if present.
+ * Fix bug in multiline response header parsing.
+ * Add specs for the Rails adapter.
+ * Fix Set-Cookie headers in Rails adapter to handle multiple values correctly.
+ * Fix Ruby 1.9 incompatibility in Response#headers= and Rakefile.
+ * Fix parser to be Ruby 1.9 compatible [Aman Gupta]
+ * Set gemspec to use EventMachine version 0.8.1 as it's the latest one having precompiled windows binaries.
+   [Francis Cianfrocca].
+ * Add -D option to thin script to set debugging on.
+ * Output incoming data and response when debugging is on.
+
+== 0.5.0
+ * Full rewrite to use EventMachine, Rack and Mongrel parser
+ 
+== 0.4.1
+ * Fix Rails environment option not being used in thin script.
+ 
+== 0.4.0
+ * First alphaish release as a gem.

data/COMMITTERS

@@ -0,0 +1,3 @@
+Marc-Andre Cournoyer <macournoyer@gmail.com>
+Kevin Williams <kevwil@gmail.com>
+James Golick

data/COPYING

@@ -0,0 +1,18 @@
+Copyright (c) 2008 Marc-Andre Cournoyer
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to
+deal in the Software without restriction, including without limitation the
+rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
+sell copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+  
+The above copyright notice and this permission notice shall be included in
+all copies or substantial portions of the Software.
+   
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
+THE AUTHORS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 
+IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
+CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README

@@ -0,0 +1,77 @@
+== Thin
+Tiny, fast & funny HTTP server
+
+Thin is a Ruby web server that glues together 3 of the best Ruby libraries in web history:
+* the Mongrel parser: the root of Mongrel speed and security
+* Event Machine: a network I/O library with extremely high scalability, performance and stability
+* Rack: a minimal interface between webservers and Ruby frameworks
+
+Which makes it, with all humility, the most secure, stable, fast and extensible Ruby web server
+bundled in an easy to use gem for your own pleasure.
+
+Site:  http://code.macournoyer.com/thin/
+Group: http://groups.google.com/group/thin-ruby/topics
+Bugs:  http://thin.lighthouseapp.com/projects/7212-thin
+Code:  http://github.com/macournoyer/thin
+IRC:   #thin on freenode
+
+=== Installation
+For the latest stable version:
+
+ sudo gem install thin
+
+or using my mirror (might be more recent and unstable):
+
+ sudo gem install thin --source http://code.macournoyer.com
+
+Or from source:
+
+ git clone git://github.com/macournoyer/thin.git
+ cd thin
+ rake install
+
+To use Thin with UNIX domain sockets you need EventMachine 0.11.0 from my gem server:
+
+ gem install eventmachine --source http://code.macournoyer.com
+
+=== Usage
+A +thin+ script offers an easy way to start your Rails application:
+
+ cd to/your/rails/app
+ thin start
+
+But Thin is also usable with a Rack config file.
+You need to setup a config.ru file and pass it to the thin script:
+  
+ cat config.ru
+ app = proc do |env|
+  [
+    200,
+    {
+      'Content-Type' => 'text/html',
+      'Content-Length' => '2'
+    },
+    ['hi']
+  ]
+ end
+ 
+ run app
+
+ thin start -R config.ru
+ 
+See example directory for more samples and run 'thin -h' for usage.
+
+=== License
+Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
+
+=== Credits
+The parser was stolen from Mongrel http://mongrel.rubyforge.org by Zed Shaw.
+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.
+
+Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>
+
+Get help at http://groups.google.com/group/thin-ruby/
+Report bugs at http://thin.lighthouseapp.com/projects/7212-thin
+and major security issues directly to a team member (see COMMITTERS)

data/Rakefile

@@ -0,0 +1,13 @@
+RUBY_1_9 = RUBY_VERSION =~ /^1\.9/
+WIN      = (RUBY_PLATFORM =~ /mswin|cygwin/)
+SUDO     = (WIN ? "" : "sudo")
+
+require 'rake'
+require 'rake/clean'
+require 'lib/thin'
+
+Dir['tasks/**/*.rake'].each { |rake| load rake }
+
+task :default => :spec
+
+ext_task :thin_parser

data/benchmark/abc

@@ -0,0 +1,51 @@
+#!/usr/bin/env ruby
+# Automate benchmarking with ab with various concurrency levels.
+require 'optparse'
+
+options = {
+  :address  => '0.0.0.0',
+  :port     => 3000,
+  :requests => 1000,
+  :start    => 1,
+  :end      => 100,
+  :step     => 10
+}
+
+OptionParser.new do |opts|
+  opts.banner = "Usage: #{$PROGRAM_NAME} [options]"
+
+  opts.on("-n", "--requests NUM", "Number of requests")         { |num| options[:requests] = num }
+  opts.on("-a", "--address HOST", "Address (default: 0.0.0.0)") { |host| options[:address] = host }
+  opts.on("-p", "--port PORT", "use PORT (default: 3000)")      { |port| options[:port] = port.to_i }
+  opts.on("-s", "--start N", "First concurrency level")         { |n| options[:start] = n.to_i }
+  opts.on("-e", "--end N", "Last concurrency level")            { |n| options[:end] = n.to_i }
+  opts.on("-S", "--step N", "Concurrency level step")           { |n| options[:step] = n.to_i }
+  opts.on("-u", "--uri PATH", "Path to send to")                { |u| options[:uri] = u }
+  opts.on("-k", "--keep-alive", "Use Keep-Alive")               { options[:keep_alive] = true }
+  
+  opts.on_tail("-h", "--help", "Show this message")     { puts opts; exit }
+end.parse!(ARGV)
+
+puts 'request   concurrency   req/s    failures'
+puts '=' * 42
+
+c = options[:start]
+until c >= options[:end]
+  sleep 0.5
+  out = `nice -n20 ab #{'-k' if options[:keep_alive]} -c #{c} -n #{options[:requests]} #{options[:address]}:#{options[:port]}/#{options[:uri]} 2> /dev/null`
+
+  r = if requests = out.match(/^Requests.+?(\d+\.\d+)/)
+    requests[1].to_i
+  else
+    0
+  end
+  f = if requests = out.match(/^Failed requests.+?(\d+)/)
+    requests[1].to_i
+  else
+    0
+  end
+  
+  puts "#{options[:requests].to_s.ljust(9)} #{c.to_s.ljust(13)} #{r.to_s.ljust(8)} #{f}"
+  
+  c += options[:step]
+end

data/benchmark/benchmarker.rb

@@ -0,0 +1,80 @@
+require 'rack/lobster'
+
+class Benchmarker
+  PORT    = 7000
+  ADDRESS = '0.0.0.0'
+  
+  attr_accessor :requests, :concurrencies, :servers, :keep_alive
+  
+  def initialize
+    @servers = %w(Mongrel EMongrel Thin)
+    @requests = 1000
+    @concurrencies = [1, 10, 100]
+  end
+  
+  def writer(&block)
+    @writer = block
+  end
+  
+  def run!
+    @concurrencies.each do |concurrency|
+      @servers.each do |server|
+        req_sec, failed = run_one(server, concurrency)
+        @writer.call(server, @requests, concurrency, req_sec, failed)
+      end
+    end
+  end
+  
+  private
+    def start_server(handler_name)
+      @server = fork do
+        [STDOUT, STDERR].each { |o| o.reopen "/dev/null" }
+
+        case handler_name
+        when 'EMongrel'
+          require 'swiftcore/evented_mongrel'
+          handler_name = 'Mongrel'
+        end
+
+        app = proc do |env|
+          [200, {'Content-Type' => 'text/html', 'Content-Length' => '11'}, ['hello world']]
+        end
+
+        handler = Rack::Handler.const_get(handler_name)
+        handler.run app, :Host => ADDRESS, :Port => PORT
+      end
+    
+      sleep 2
+    end
+  
+    def stop_server
+      Process.kill('SIGKILL', @server)
+      Process.wait
+    end
+  
+    def run_ab(concurrency)
+      `nice -n20 ab -c #{concurrency} -n #{@requests} #{@keep_alive ? '-k' : ''} #{ADDRESS}:#{PORT}/ 2> /dev/null`
+    end
+  
+    def run_one(handler_name, concurrency)
+      start_server(handler_name)
+
+      out = run_ab(concurrency)
+
+      stop_server
+
+      req_sec = if matches = out.match(/^Requests.+?(\d+\.\d+)/)
+        matches[1].to_i
+      else
+        0
+      end
+    
+      failed = if matches = out.match(/^Failed requests.+?(\d+)/)
+        matches[1].to_i
+      else
+        0
+      end
+    
+      [req_sec, failed]
+    end
+end