thin 0.5.3-x86-mswin32-60

data/CHANGELOG

@@ -0,0 +1,40 @@
+== 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/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,60 @@
+== 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.
+
+=== Installation
+For the latest stable version:
+
+ sudo gem install thin
+
+or using my mirror (might be more recent):
+
+ sudo gem install thin --source http://code.macournoyer.com
+
+Or from source:
+
+ git clone git://repo.or.cz/thin.git
+ cd thin
+ rake install
+
+=== Usage
+A +thin+ script is offered to easily start your Rails application:
+
+ cd to/your/rails/app
+ thin start
+
+But Thin is also usable through Rack +rackup+ command.
+You need to setup a config.ru file and require thin in it:
+  
+ cat <<EOS
+ require 'thin'
+ 
+ app = proc do |env|
+  [200, {'Content-Type'=>'text/html'}, ['hi']]
+ end
+ 
+ run app
+ EOS
+ rackup -s thin
+ 
+See example/config.ru for details and rackup -h
+
+=== 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>
+
+Please report any bug at http://groups.google.com/group/thin-ruby/
+and major security issues directly to me at macournoyer@gmail.com.

data/Rakefile

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

data/benchmark/simple.rb

@@ -0,0 +1,48 @@
+# Simple benchmark to compare Thin performance against
+# other webservers supported by Rack.
+#
+# Run with:
+#
+#  ruby simple.rb [num of request]
+#
+require File.dirname(__FILE__) + '/../lib/thin'
+require 'rack/lobster'
+
+REQUEST = (ARGV[0] || 1000).to_i # Number of request to send (ab -n option)
+
+def run(handler_name, c=1, n=REQUEST)
+  server = fork do
+    [STDOUT, STDERR].each { |o| o.reopen "/dev/null" }
+  
+    app = Rack::Lobster.new
+    
+    if handler_name == 'EMongrel'
+      require 'swiftcore/evented_mongrel'
+      handler_name = 'Mongrel'
+    end
+    handler = Rack::Handler.const_get(handler_name)
+    handler.run app, :Host => '0.0.0.0', :Port => 7000
+  end
+
+  sleep 2
+
+  out = `nice -n20 ab -c #{c} -n #{n} http://127.0.0.1:7000/ 2> /dev/null`
+
+  Process.kill('SIGKILL', server)
+  Process.wait
+  
+  if requests = out.match(/^Requests.+?(\d+\.\d+)/)
+    failed = out.match(/^Failed requests.+?(\d+)$/)[1]
+    "#{requests[1].to_s.ljust(9)} #{failed}"
+  else
+    'ERROR'
+  end
+end
+
+puts 'server     request   concurrency   req/s     failures'
+puts '=' * 53
+[1, 10, 100].each do |c|
+  %w(WEBrick Mongrel EMongrel Thin).each do |server|
+    puts "#{server.ljust(8)}   #{REQUEST}      #{c.to_s.ljust(4)}          #{run(server, c)}"
+  end
+end

data/bin/thin

@@ -0,0 +1,123 @@
+#!/usr/bin/env ruby
+# <tt>thin start</tt>: Starts the Rails app in the current directory.
+# Run <tt>thin -h</tt> to get more usage.
+require File.dirname(__FILE__) + '/../lib/thin'
+require 'optparse'
+
+COMMANDS = %w(start stop restart)
+
+# Default options values
+options = {
+  :chdir       => Dir.pwd,
+  :environment => 'development',
+  :address     => '0.0.0.0',
+  :port        => 3000,
+  :timeout     => 60,
+  :log         => 'log/thin.log',
+  :pid         => 'tmp/pids/thin.pid',
+  :servers     => 1 # no cluster
+}
+
+# NOTE: If you add an option here make sure the key in the +options+ hash is the
+# same as the name of the command line option.
+# +option+ keys are use to build the command line to launch a cluster,
+# see <tt>lib/thin/cluster.rb</tt>.
+opts = OptionParser.new do |opts|
+  opts.banner = "Usage: thin [options] #{COMMANDS.join('|')}"
+
+  opts.separator ""
+  opts.separator "Server options:"
+
+  opts.on("-a", "--address HOST", "bind to 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("-e", "--environment ENV", "Rails environment (default: development)")  { |env| options[:environment] = env }
+  opts.on("-c", "--chdir PATH", "Change to dir before starting")                  { |dir| options[:chdir] = File.expand_path(dir) }
+  opts.on("-s", "--servers NUM", "Number of servers to start",
+                                 "set a value >1 to start a cluster")             { |num| options[:servers] = num.to_i }
+  opts.on("-d", "--daemonize", "Run daemonized in the background")                { options[:daemonize] = true }
+  opts.on("-l", "--log FILE", "File to redirect output",
+                              "(default: #{options[:log]})")                      { |file| options[:log] = file }
+  opts.on("-P", "--pid FILE", "File to store PID",
+                              "(default: #{options[:pid]})")                      { |file| options[:pid] = file }
+  opts.on("-t", "--timeout SEC", "Request or command timeout in sec",            
+                                 "(default: #{options[:timeout]})")               { |sec| options[:timeout] = sec.to_i }
+  opts.on("-u", "--user NAME", "User to run daemon as (use with -g)")             { |user| options[:user] = user }
+  opts.on("-g", "--group NAME", "Group to run daemon as (use with -u)")           { |group| options[:group] = group }
+  opts.on(      "--prefix PATH", "Mount the app under PATH (start with /)")       { |path| options[:prefix] = path }
+  
+  opts.separator ""
+  opts.separator "Common options:"
+
+  opts.on_tail("-D", "--debug", "Set debbuging on") { $DEBUG = true }
+  opts.on_tail("-h", "--help", "Show this message") { puts opts; exit }
+  opts.on_tail('-v', '--version', "Show version")   { puts Thin::SERVER; exit }
+
+  opts.parse! ARGV
+end
+
+
+# == Commands definitions
+
+def cluster?(options)
+  options[:servers] && options[:servers] > 1
+end
+
+def start(options)
+  if cluster?(options)
+    Thin::Cluster.new(options).start
+  else
+    server = Thin::Server.new(options[:address], options[:port])
+  
+    server.pid_file = options[:pid]
+    server.log_file = options[:log]
+    server.timeout  = options[:timeout]
+  
+    if options[:daemonize]
+      server.change_privilege options[:user], options[:group] if options[:user] && options[:group]
+      server.daemonize
+    end
+  
+    server.app = Rack::Adapter::Rails.new(options.merge(:root => options[:chdir]))
+    
+    # If a prefix is required, wrap in Rack URL mapper
+    server.app = Rack::URLMap.new(options[:prefix] => server.app) if options[:prefix]
+    
+    server.start!
+  end  
+end
+
+def stop(options)
+  if cluster?(options)
+    Thin::Cluster.new(options).stop
+  else
+    Thin::Server.kill options[:pid], options[:timeout]
+  end
+end
+
+def restart(options)
+  if cluster?(options)
+    Thin::Cluster.new(options).restart
+  else
+    # Restart only make sense when running as a daemon
+    options.update :daemonize => true
+  
+    stop(options)
+    start(options)
+  end
+end
+
+
+# == Runs the command
+
+Dir.chdir(options[:chdir])
+command = ARGV[0]
+
+if COMMANDS.include?(command)
+  send(command, options)
+elsif command.nil?
+  puts "Command required"
+  puts opts
+  exit 1  
+else
+  abort "Invalid command : #{command}"
+end

data/doc/benchmarks.txt

@@ -0,0 +1,86 @@
+== Process
+* rackup ...
+* nice -n20 httperf --port 9292 --num-conns 9000
+* nice -n20 ab -n5000 localhost:9292/
+* nice -n20 ab -n5000 -c10 localhost:9292/
+* nice -n20 ab -n5000 -c100 localhost:9292/
+
+== More Benchmarks
+http://www.webficient.com/2007/08/testing-various-configurations-of-rails.html
+
+=== WEBrick
+rackup -s webrick
+
+==== httperf
+Reply rate [replies/s]: min 303.8 avg 306.8 max 310.4 stddev 2.8 (5 samples)
+Reply rate [replies/s]: min 235.8 avg 292.2 max 306.4 stddev 27.7 (6 samples)
+Reply rate [replies/s]: min 304.8 avg 306.9 max 308.8 stddev 1.5 (5 samples)
+  avg:                                302.0                  10.7
+
+==== Concurrency Level 1
+297.37 [#/sec] (mean)
+
+==== Concurrency Level 10
+296.65 [#/sec] (mean) Failed requests: 4 (Connect: 2, Length: 2, Exceptions: 0)
+298.22 [#/sec] (mean) Failed requests: 4 (Connect: 2, Length: 2, Exceptions: 0)
+
+==== Concurrency Level 100
+297.16 [#/sec] (mean) Failed requests: 489 (Connect: 245, Length: 244, Exceptions: 0)
+
+
+=== Mongrel
+rackup -s mongrel
+
+==== httperf
+Reply rate [replies/s]: min 556.4 avg 580.1 max 613.6 stddev 29.9 (3 samples)
+Reply rate [replies/s]: min 299.0 avg 502.6 max 613.4 stddev 176.5 (3 samples)
+Reply rate [replies/s]: min 601.0 avg 608.5 max 616.0 stddev 10.7 (2 samples)
+Reply rate [replies/s]: min 605.2 avg 608.4 max 611.6 stddev 4.5 (2 samples)
+  avg:                                574.9                  55.4
+
+==== Concurrency Level 1
+556.67 [#/sec] (mean)
+
+==== Concurrency Level 10
+622.90 [#/sec] (mean)
+
+==== Concurrency Level 100
+428.23 [#/sec] (mean)
+
+=== Evented Mongrel
+rackup -r "swiftcore/evented_mongrel" -s mongrel
+
+==== httperf
+Reply rate [replies/s]: min 452.4 avg 541.0 max 590.0 stddev 76.9 (3 samples)
+Reply rate [replies/s]: min 573.2 avg 586.0 max 593.0 stddev 11.1 (3 samples)
+Reply rate [replies/s]: min 546.6 avg 574.8 max 594.6 stddev 25.0 (3 samples)
+Reply rate [replies/s]: min 593.6 avg 595.2 max 596.4 stddev 1.5 (3 samples)
+  avg:                                574.25                 28.625
+
+==== Concurrency Level 1
+517.97 [#/sec] (mean)
+
+==== Concurrency Level 10
+657.89 [#/sec] (mean)
+
+==== Concurrency Level 100
+656.17 [#/sec] (mean)
+
+=== Thin
+rackup -s thin
+
+==== httperf
+Reply rate [replies/s]: min 671.4 avg 681.0 max 690.7 stddev 13.6 (2 samples)
+Reply rate [replies/s]: min 690.0 avg 695.8 max 701.7 stddev 8.3 (2 samples)
+Reply rate [replies/s]: min 643.4 avg 669.4 max 695.4 stddev 36.7 (2 samples)
+Reply rate [replies/s]: min 694.1 avg 695.8 max 697.6 stddev 2.5 (2 samples)
+  avg:                                685.5                  15.275
+
+==== Concurrency Level 1
+719.53 [#/sec] (mean)
+
+==== Concurrency Level 10
+782.11 [#/sec] (mean)
+
+==== Concurrency Level 100
+776.40 [#/sec] (mean)

data/doc/rdoc/classes/Process.html

@@ -0,0 +1,181 @@
+
+<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
+<html>
+<head>
+  <title>
+  thin &raquo; Module: Process
+  </title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script language="JavaScript" type="text/javascript">
+    // <![CDATA[
+
+    function toggleSource( id )
+    {
+    var elem
+    var link
+
+    if( document.getElementById )
+    {
+    elem = document.getElementById( id )
+    link = document.getElementById( "l_" + id )
+    }
+    else if ( document.all )
+    {
+    elem = eval( "document.all." + id )
+    link = eval( "document.all.l_" + id )
+    }
+    else
+    return false;
+
+    if( elem.style.display == "block" )
+    {
+    elem.style.display = "none"
+    link.innerHTML = "show source"
+    }
+    else
+    {
+    elem.style.display = "block"
+    link.innerHTML = "hide source"
+    }
+    }
+
+    function openCode( url )
+    {
+    window.open( url, "SOURCE_CODE", "width=400,height=400,scrollbars=yes" )
+    }
+    // ]]>
+  </script>
+</head>
+  <body>
+    <ul id="menu">
+      <li><a href="/thin/">about</a></li>
+      <li><a href="/thin/download/">download</a></li>
+      <li><a href="/thin/usage/">usage</a></li>
+      <li><a href="/thin/doc/">doc</a></li>
+      <li><a href="http://groups.google.com/group/thin-ruby/">community</a></li>
+    </ul>
+    <div id="sidebar">
+      <h2>Files</h2>
+      <ul class="list">
+        <li><a href="../files/README.html" value="File: README">README</a></li>
+        <li><a href="../files/lib/rack/adapter/rails_rb.html" value="File: rails.rb">lib/rack/adapter/rails.rb</a></li>
+        <li><a href="../files/lib/rack/handler/thin_rb.html" value="File: thin.rb">lib/rack/handler/thin.rb</a></li>
+        <li><a href="../files/lib/thin/cluster_rb.html" value="File: cluster.rb">lib/thin/cluster.rb</a></li>
+        <li><a href="../files/lib/thin/connection_rb.html" value="File: connection.rb">lib/thin/connection.rb</a></li>
+        <li><a href="../files/lib/thin/daemonizing_rb.html" value="File: daemonizing.rb">lib/thin/daemonizing.rb</a></li>
+        <li><a href="../files/lib/thin/headers_rb.html" value="File: headers.rb">lib/thin/headers.rb</a></li>
+        <li><a href="../files/lib/thin/logging_rb.html" value="File: logging.rb">lib/thin/logging.rb</a></li>
+        <li><a href="../files/lib/thin/request_rb.html" value="File: request.rb">lib/thin/request.rb</a></li>
+        <li><a href="../files/lib/thin/response_rb.html" value="File: response.rb">lib/thin/response.rb</a></li>
+        <li><a href="../files/lib/thin/server_rb.html" value="File: server.rb">lib/thin/server.rb</a></li>
+        <li><a href="../files/lib/thin/statuses_rb.html" value="File: statuses.rb">lib/thin/statuses.rb</a></li>
+        <li><a href="../files/lib/thin/version_rb.html" value="File: version.rb">lib/thin/version.rb</a></li>
+        <li><a href="../files/lib/thin_rb.html" value="File: thin.rb">lib/thin.rb</a></li>
+        <li><a href="../files/bin/thin.html" value="File: thin">bin/thin</a></li>
+      </ul>
+      
+      <h2>Classes</h2>
+      <ul class="list">
+        <li><a href="../classes/Rack.html" title="Module: Rack">Rack</a></li>
+        <li><a href="../classes/Rack/Adapter.html" title="Module: Rack::Adapter">Rack::Adapter</a></li>
+        <li><a href="../classes/Rack/Adapter/Rails.html" title="Class: Rack::Adapter::Rails">Rack::Adapter::Rails</a></li>
+        <li><a href="../classes/Rack/Adapter/Rails/CGIWrapper.html" title="Class: Rack::Adapter::Rails::CGIWrapper">Rack::Adapter::Rails::CGIWrapper</a></li>
+        <li><a href="../classes/Rack/Handler.html" title="Module: Rack::Handler">Rack::Handler</a></li>
+        <li><a href="../classes/Rack/Handler/Thin.html" title="Class: Rack::Handler::Thin">Rack::Handler::Thin</a></li>
+        <li><a href="../classes/Thin.html" title="Module: Thin">Thin</a></li>
+        <li><a href="../classes/Thin/Daemonizable.html" title="Module: Thin::Daemonizable">Thin::Daemonizable</a></li>
+        <li><a href="../classes/Thin/Daemonizable/ClassMethods.html" title="Module: Thin::Daemonizable::ClassMethods">Thin::Daemonizable::ClassMethods</a></li>
+        <li><a href="../classes/Thin/VERSION.html" title="Module: Thin::VERSION">Thin::VERSION</a></li>
+        <li><a href="../classes/Thin/Logging.html" title="Module: Thin::Logging">Thin::Logging</a></li>
+        <li><a href="../classes/Thin/InvalidRequest.html" title="Class: Thin::InvalidRequest">Thin::InvalidRequest</a></li>
+        <li><a href="../classes/Thin/StopServer.html" title="Class: Thin::StopServer">Thin::StopServer</a></li>
+        <li><a href="../classes/Thin/Response.html" title="Class: Thin::Response">Thin::Response</a></li>
+        <li><a href="../classes/Thin/Headers.html" title="Class: Thin::Headers">Thin::Headers</a></li>
+        <li><a href="../classes/Thin/Server.html" title="Class: Thin::Server">Thin::Server</a></li>
+        <li><a href="../classes/Thin/Request.html" title="Class: Thin::Request">Thin::Request</a></li>
+        <li><a href="../classes/Thin/Connection.html" title="Class: Thin::Connection">Thin::Connection</a></li>
+        <li><a href="../classes/Thin/Cluster.html" title="Class: Thin::Cluster">Thin::Cluster</a></li>
+        <li><a href="../classes/Process.html" title="Module: Process">Process</a></li>
+      </ul>
+    </div>
+    <div id="container">
+      <div id="header">
+        <a href="/thin/" title="Home">
+          <img id="logo" src="../logo.gif" />
+        </a>
+        <h2 id="tag_line">A fast and very simple Ruby web server</h2>
+      </div>
+    
+      <div id="content">
+        <h2>Module: Process</h2>
+
+  
+<div id="Process" class="page_shade">
+<div class="page">
+<h3>Module Process &lt; Object</h3>
+
+<span class="path">(in files
+<a href="../files/lib/thin/daemonizing_rb.html">lib/thin/daemonizing.rb</a>
+)</span>
+
+<p>
+Control a set of servers.
+</p>
+<ul>
+<li>Generate <a href="Cluster.html#M000058">start</a> and <a
+href="Cluster.html#M000060">stop</a> commands and run them.
+
+</li>
+<li>Inject the port number in the pid and log filenames.
+
+</li>
+</ul>
+<p>
+Servers are started throught the <tt>thin</tt> commandline script.
+</p>
+
+
+
+
+<h4>Includes</h4>
+<ul>
+<li><a href="Logging.html">Logging</a></li>
+</ul>
+
+<h2 class="ruled">Methods</h2>
+<h4 class="ruled">
+<span class="method-type" title="Public Instance method">Public Instance</span>
+<strong><a name="M000066" href="#M000066" title="Permalink to Public Instance method: running?">running?(pid)</a></strong>
+</h4>
+
+<p>
+Returns <tt>true</tt> the process identied by <tt>pid</tt> is running.
+</p>
+
+<div class="sourcecode">
+  <p class="source-link">[ <a href="javascript:toggleSource('M000066_source')" id="l_M000066_source">show source</a> ]</p>
+  <div id="M000066_source" class="dyn-source">
+<pre>
+    <span class="ruby-comment cmt"># File lib/thin/daemonizing.rb, line 6</span>
+ 6:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">running?</span>(<span class="ruby-identifier">pid</span>)
+ 7:     <span class="ruby-constant">Process</span>.<span class="ruby-identifier">getpgid</span>(<span class="ruby-identifier">pid</span>) <span class="ruby-operator">!=</span> <span class="ruby-value">-1</span>
+ 8:   <span class="ruby-keyword kw">rescue</span> <span class="ruby-constant">Errno</span><span class="ruby-operator">::</span><span class="ruby-constant">ESRCH</span>
+ 9:     <span class="ruby-keyword kw">false</span>
+10:   <span class="ruby-keyword kw">end</span>
+</pre>
+  </div>
+</div>
+
+</div>
+</div>
+
+
+      </div>
+    </div>
+    <div id="footer">
+      <hr />
+      &copy; <a href="http://macournoyer.com">Marc-Andr&eacute; Cournoyer</a>
+    </div>
+  </body>
+</html>