thin 0.3.0

data/README

@@ -0,0 +1,35 @@
+== Thin
+
+Tiny, fast & funny HTTP server
+
+=== Installation
+
+ sudo gem install thin --source http://code.macournoyer.com
+
+Or get the source:
+
+ svn co http://code.macournoyer.com/svn/thin/trunk thin
+
+=== Usage
+In your Rails app directory:
+  
+ thin start
+
+Get more help with the thin script at http://code.macournoyer.com/thin/doc/files/bin/thin.html 
+and with the thin_cluster script at http://code.macournoyer.com/thin/doc/files/bin/thin_cluster.html
+
+=== License
+Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
+
+=== Credits
+Lots of the code was inspired (or stolen entirely) 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.
+
+transat/parser.rb was taken from Piston source code.
+Copyright (c) 2006 Francois Beausoleil <francois@teksol.info>
+
+Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>
+
+Please report any bug using http://code.macournoyer.com/thin/trac.fcgi/newticket

data/Rakefile

@@ -0,0 +1,101 @@
+require 'rake'
+require 'rake/clean'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/gempackagetask'
+require 'erb'
+
+require File.dirname(__FILE__) + '/lib/thin'
+
+REVISION = `svn info`.match('Revision: (\d+)')[1]
+CLEAN.include %w(doc/rdoc pkg tmp log)
+
+Rake::TestTask.new do |t|
+  t.pattern = 'test/*_test.rb'
+end
+task :default => :test
+
+Rake::RDocTask.new do |rdoc|
+  rdoc.rdoc_dir = 'doc/rdoc'
+  rdoc.options += ['--quiet', '--title', Thin::NAME,
+             	     "--opname", "index.html",
+            	     "--line-numbers",
+            	     "--main", "README",
+            	     "--inline-source"]
+  rdoc.template = "site/rdoc.rb"
+  rdoc.main = "README"
+  rdoc.title = Thin::NAME
+  rdoc.rdoc_files.add ['README', 'lib/thin/*.rb', 'bin/*']
+end
+
+namespace :rdoc do
+  desc 'Upload rdoc to code.macournoyer.com'
+  task :upload => :rdoc do
+    upload "doc/rdoc", 'thin/doc', :replace => true
+  end
+end
+
+spec = Gem::Specification.new do |s|
+  s.name                  = Thin::NAME
+  s.version               = Thin::VERSION::STRING
+  s.platform              = Gem::Platform::RUBY
+  s.summary               = "Thin and fast web server"
+  s.description           = s.summary
+  s.author                = "Marc-Andre Cournoyer"
+  s.email                 = 'macournoyer@gmail.com'
+  s.homepage              = 'http://code.macournoyer.com/thin/'
+  s.executables           = %w(thin thin_cluster)
+
+  s.required_ruby_version = '>= 1.8.6'
+
+  s.files                 = %w(README Rakefile) + Dir.glob("{bin,doc,lib}/**/*")
+  
+  s.require_path          = "lib"
+  s.bindir                = "bin"
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+end
+
+namespace :gem do
+  desc 'Upload gem to code.macournoyer.com'
+  task :upload => :gem do
+    upload "pkg/#{spec.full_name}.gem", 'gems'
+    sh 'ssh macournoyer@macournoyer.com "cd code.macournoyer.com && index_gem_repository.rb"'
+  end
+end
+
+desc 'Show some stats about the code'
+task :stats do
+  line_count = proc do |path|
+    Dir[path].collect { |f| File.open(f).readlines.reject { |l| l =~ /^\s*\#/ }.size }.inject(0){ |sum,n| sum += n }
+  end
+  puts "#{line_count['lib/**/*.rb'].to_s.rjust(6)} LOC of lib"
+  puts "#{line_count['lib/thin/{server,request,response,cgi,rails,handler,headers}.rb'].to_s.rjust(6)} LOC of web serving stuff"
+  puts "#{line_count['test/**/*.rb'].to_s.rjust(6)} LOC of test"
+end
+
+namespace :site do
+  task :build do
+    mkdir_p 'tmp/site/images'
+    cd 'tmp/site' do
+      ruby '../../site/thin.rb', '--dump'
+    end
+    cp 'site/style.css', 'tmp/site'
+    cp_r Dir['site/images/*'], 'tmp/site/images'
+  end
+  
+  desc 'Upload website to code.macournoyer.com'
+  task :upload => 'site:build' do
+    upload 'tmp/site/*', 'thin'
+  end
+end
+
+desc 'Upload all the stuff to code.macournoyer.com'
+task :upload => %w(gem:upload site:upload rdoc:upload)
+
+def upload(file, to, options={})
+  sh %{ssh macournoyer@macournoyer.com "rm -rf code.macournoyer.com/#{to}"} if options[:replace]
+  sh %{scp -rq #{file} macournoyer@macournoyer.com:code.macournoyer.com/#{to}}
+end

data/bin/thin

@@ -0,0 +1,48 @@
+#!/usr/bin/env ruby
+# == thin
+# Script to launch a Thin server for a Rails application.
+# 
+# To start a server for your current Rails app:
+#  thin start
+# You can specify the port using the -p option:
+#  thin start -p3001
+# By default the server will bind to 0.0.0.0:3000
+# 
+# You can specify which Rails environment should be loaded with the -e option:
+#  thin start -e production
+# 
+# You can also start the server in daemon mode:
+#  thin start -d
+# And later stop it
+#  thin stop
+#
+# Run <tt>thin help</tt> to get help.
+
+require File.dirname(__FILE__) + '/../lib/thin'
+require 'thin/command'
+
+Thin.define_commands do
+  program_name 'thin'
+  version      Thin::VERSION::STRING
+  help         'Thin is a web server that can run your Rails app in no time'
+
+  option :address,     :short => :a, :default => '0.0.0.0',           :message => 'Address to bind to',
+                                     :param_name => 'ADDRESS'
+  option :port,        :short => :p, :default => 3000,                :message => 'Port number to bind to',
+                                     :param_name => 'PORT', :type => :int
+  option :environment, :short => :e, :default => 'development',       :message => 'Rails environment',
+                                     :param_name => 'ENVIRONMENT'
+  option :log_file,    :short => :l, :default => 'log/thin.log',      :message => 'File to write log output to (use with -d)',
+                                     :param_name => 'PATH'
+  option :pid_file,    :short => :P, :default => 'tmp/pids/thin.pid', :message => 'File to write the PID (use with -d)',
+                                     :param_name => 'PATH'
+  option :daemonize,   :short => :d,                                  :message => 'Run in the background'
+  option :user,        :short => :u, :param_name => 'USER',           :message => 'User to run the process as'
+  option :group,       :short => :g, :param_name => 'GROUP',          :message => 'Group to run the process as'
+  option :timeout,     :short => :T, :param_name => 'SEC',            :message => 'Server timeout before giving up',
+                                     :default => 60
+  option :trace,       :short => :t,                                  :message => 'Turn trace on'
+
+  command :start, Thin::Commands::Server::Start, :valid_options => [:address, :port, :environment, :log_file, :daemonize, :pid_file, :user, :group, :trace, :timeout]
+  command :stop,  Thin::Commands::Server::Stop,  :valid_options => [:pid_file, :timeout]
+end

data/bin/thin_cluster

@@ -0,0 +1,53 @@
+#!/usr/bin/env ruby
+# == this_cluster
+# Script used to launch multiple server instances.
+# It takes most of the same argument as the +thin+ script
+# plus the -n option to specify the number of servers to run.
+# 
+# Also, you can store your options into a config file, create it like this:
+#  thin_cluster config -C /var/www/my_app/current config
+# Then a config file will be created in /var/www/my_app/current/config/thin.yml
+# with the default options.
+# You can launch your 3 servers with:
+#  thin_cluster start
+# And stop them with:
+#  thin_cluster stop
+#
+# Run <tt>thin_cluster help</tt> to get help.
+
+require File.dirname(__FILE__) + '/../lib/thin'
+require 'thin/command'
+
+Thin.define_commands do
+  program_name 'thin_cluster'
+  version      Thin::VERSION::STRING
+  help         'Thin cluster monitoring tool for managing multiple Thin web servers'
+
+  option :address,     :short => :a, :default => '127.0.0.1',         :message => 'Address to bind to',
+                                     :param_name => 'ADDRESS'
+  option :port,        :short => :p, :default => 5000,                :message => 'Port number to bind to',
+                                     :param_name => 'PORT', :type => :int
+  option :servers,     :short => :n, :default => 3,                   :message => 'Number of servers to launch',
+                                     :param_name => 'NUM', :type => :int  
+  option :environment, :short => :e, :default => 'production',        :message => 'Rails environment',
+                                     :param_name => 'ENVIRONMENT'
+  option :log_file,    :short => :l, :default => 'log/thin.log',      :message => 'File to write log output to',
+                                     :param_name => 'PATH'
+  option :pid_file,    :short => :P, :default => 'tmp/pids/thin.pid', :message => 'File to write the PID (use with -d)',
+                                     :param_name => 'PATH'
+  option :cwd,         :short => :c, :param_name => 'PATH',           :message => 'Change to dir before starting'
+  option :user,        :short => :u, :param_name => 'USER',           :message => 'User to run the process as'
+  option :group,       :short => :g, :param_name => 'GROUP',          :message => 'Group to run the process as'
+  option :config,      :short => :C, :default => 'config/thin.yml',   :message => 'Config file',
+                                     :param_name => 'PATH'
+  option :timeout,     :short => :T, :param_name => 'SEC',            :message => 'Server and command timeout',
+                                     :default => 60
+  option :trace,       :short => :t,                                  :message => 'Turn trace on'                                   
+
+  valid_options = [:address, :port, :environment, :log_file, :pid_file, :cwd, :servers, :config, :user, :group, :trace]
+  
+  command :start,   Thin::Commands::Cluster::Start,   :valid_options => valid_options
+  command :stop,    Thin::Commands::Cluster::Stop,    :valid_options => valid_options
+  command :restart, Thin::Commands::Cluster::Restart, :valid_options => valid_options
+  command :config,  Thin::Commands::Cluster::Config,  :valid_options => valid_options
+end

data/doc/benchmarks.txt

@@ -0,0 +1,271 @@
+= Benchmark Thin vs Mongrel
+
+== Single instance
+On server instance. Running Rails in development environment.
+App is http://refactormycode.com with no caching.
+
+=== Thin
+marc:~ marc$ ab -n10 -c3 localhost:3000/
+This is ApacheBench, Version 1.3d <$Revision: 1.73 $> apache-1.3
+Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
+Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+
+Benchmarking localhost (be patient).....done
+Server Software:        thin                                               
+Server Hostname:        localhost
+Server Port:            3000
+
+Document Path:          /
+Document Length:        11195 bytes
+
+Concurrency Level:      3
+Time taken for tests:   15.429 seconds
+Complete requests:      10
+Failed requests:        0
+Broken pipe errors:     0
+Total transferred:      114510 bytes
+HTML transferred:       111950 bytes
+Requests per second:    0.65 [#/sec] (mean)
+Time per request:       4628.70 [ms] (mean)
+Time per request:       1542.90 [ms] (mean, across all concurrent requests)
+Transfer rate:          7.42 [Kbytes/sec] received
+
+Connnection Times (ms)
+              min  mean[+/-sd] median   max
+Connect:        0     0    0.0      0     0
+Processing:  1935  4175  874.1   4458  4903
+Waiting:     1935  4175  874.1   4458  4903
+Total:       1935  4175  874.1   4458  4903
+
+Percentage of the requests served within a certain time (ms)
+  50%   4458
+  66%   4525
+  75%   4562
+  80%   4597
+  90%   4903
+  95%   4903
+  98%   4903
+  99%   4903
+ 100%   4903 (last request)
+ 
+=== Mongrel
+marc:~ marc$ ab -n10 -c3 localhost:3001/
+This is ApacheBench, Version 1.3d <$Revision: 1.73 $> apache-1.3
+Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
+Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+
+Benchmarking localhost (be patient).....done
+Server Software:        Mongrel                                            
+Server Hostname:        localhost
+Server Port:            3001
+
+Document Path:          /
+Document Length:        11195 bytes
+
+Concurrency Level:      3
+Time taken for tests:   16.522 seconds
+Complete requests:      10
+Failed requests:        0
+Broken pipe errors:     0
+Total transferred:      114930 bytes
+HTML transferred:       111950 bytes
+Requests per second:    0.61 [#/sec] (mean)
+Time per request:       4956.60 [ms] (mean)
+Time per request:       1652.20 [ms] (mean, across all concurrent requests)
+Transfer rate:          6.96 [Kbytes/sec] received
+
+Connnection Times (ms)
+              min  mean[+/-sd] median   max
+Connect:        0     0    0.0      0     0
+Processing:  2629  4496  746.2   4662  5602
+Waiting:     2629  4496  746.2   4662  5602
+Total:       2629  4496  746.2   4662  5602
+
+Percentage of the requests served within a certain time (ms)
+  50%   4662
+  66%   4681
+  75%   4691
+  80%   4715
+  90%   5602
+  95%   5602
+  98%   5602
+  99%   5602
+ 100%   5602 (last request)
+
+== Cluster
+Using Nginx as the load balancer with 3 app instance.
+App is http://refactormycode.com with no caching.
+
+=== Thin
+marc:~ marc$ ab -n10 -c5 localhost/
+This is ApacheBench, Version 1.3d <$Revision: 1.73 $> apache-1.3
+Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
+Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+
+Benchmarking localhost (be patient).....done
+Server Software:        nginx/0.5.33                                       
+Server Hostname:        localhost
+Server Port:            80
+
+Document Path:          /
+Document Length:        45456 bytes
+
+Concurrency Level:      5
+Time taken for tests:   4.444 seconds
+Complete requests:      10
+Failed requests:        0
+Broken pipe errors:     0
+Total transferred:      458270 bytes
+HTML transferred:       454560 bytes
+Requests per second:    2.25 [#/sec] (mean)
+Time per request:       2222.00 [ms] (mean)
+Time per request:       444.40 [ms] (mean, across all concurrent requests)
+Transfer rate:          103.12 [Kbytes/sec] received
+
+Connnection Times (ms)
+              min  mean[+/-sd] median   max
+Connect:        0     0    0.0      0     0
+Processing:  1031  1703 1064.3   1185  4119
+Waiting:     1031  1703 1064.3   1185  4119
+Total:       1031  1703 1064.3   1185  4119
+
+Percentage of the requests served within a certain time (ms)
+  50%   1185
+  66%   1207
+  75%   2178
+  80%   2978
+  90%   4119
+  95%   4119
+  98%   4119
+  99%   4119
+ 100%   4119 (last request)
+marc:~ marc$ ab -n100 -c10 localhost/
+This is ApacheBench, Version 1.3d <$Revision: 1.73 $> apache-1.3
+Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
+Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+
+Benchmarking localhost (be patient).....done
+Server Software:        nginx/0.5.33                                       
+Server Hostname:        localhost
+Server Port:            80
+
+Document Path:          /
+Document Length:        45456 bytes
+
+Concurrency Level:      10
+Time taken for tests:   36.949 seconds
+Complete requests:      100
+Failed requests:        0
+Broken pipe errors:     0
+Total transferred:      4582700 bytes
+HTML transferred:       4545600 bytes
+Requests per second:    2.71 [#/sec] (mean)
+Time per request:       3694.90 [ms] (mean)
+Time per request:       369.49 [ms] (mean, across all concurrent requests)
+Transfer rate:          124.03 [Kbytes/sec] received
+
+Connnection Times (ms)
+              min  mean[+/-sd] median   max
+Connect:        0     0    0.0      0     0
+Processing:   996  3502  762.1   3539  4841
+Waiting:      996  3502  762.3   3539  4841
+Total:        996  3502  762.1   3539  4841
+
+Percentage of the requests served within a certain time (ms)
+  50%   3539
+  66%   3947
+  75%   4167
+  80%   4229
+  90%   4417
+  95%   4563
+  98%   4742
+  99%   4841
+ 100%   4841 (last request)
+
+
+=== Mongrel
+
+marc:~ marc$ ab -n10 -c5 localhost/
+This is ApacheBench, Version 1.3d <$Revision: 1.73 $> apache-1.3
+Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
+Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+
+Benchmarking localhost (be patient).....done
+Server Software:        nginx/0.5.33                                       
+Server Hostname:        localhost
+Server Port:            80
+
+Document Path:          /
+Document Length:        45455 bytes
+
+Concurrency Level:      5
+Time taken for tests:   5.995 seconds
+Complete requests:      10
+Failed requests:        0
+Broken pipe errors:     0
+Total transferred:      458600 bytes
+HTML transferred:       454550 bytes
+Requests per second:    1.67 [#/sec] (mean)
+Time per request:       2997.50 [ms] (mean)
+Time per request:       599.50 [ms] (mean, across all concurrent requests)
+Transfer rate:          76.50 [Kbytes/sec] received
+
+Connnection Times (ms)
+              min  mean[+/-sd] median   max
+Connect:        0     0    0.0      0     0
+Processing:  1248  2500 1138.1   2743  4245
+Waiting:     1248  2500 1138.0   2743  4245
+Total:       1248  2500 1138.1   2743  4245
+
+Percentage of the requests served within a certain time (ms)
+  50%   2743
+  66%   3040
+  75%   3148
+  80%   4131
+  90%   4245
+  95%   4245
+  98%   4245
+  99%   4245
+ 100%   4245 (last request)
+marc:~ marc$ ab -n100 -c10 localhost/
+This is ApacheBench, Version 1.3d <$Revision: 1.73 $> apache-1.3
+Copyright (c) 1996 Adam Twiss, Zeus Technology Ltd, http://www.zeustech.net/
+Copyright (c) 1998-2002 The Apache Software Foundation, http://www.apache.org/
+
+Benchmarking localhost (be patient).....done
+Server Software:        nginx/0.5.33                                       
+Server Hostname:        localhost
+Server Port:            80
+
+Document Path:          /
+Document Length:        45455 bytes
+
+Concurrency Level:      10
+Time taken for tests:   41.135 seconds
+Complete requests:      100
+Failed requests:        0
+Broken pipe errors:     0
+Total transferred:      4586000 bytes
+HTML transferred:       4545500 bytes
+Requests per second:    2.43 [#/sec] (mean)
+Time per request:       4113.50 [ms] (mean)
+Time per request:       411.35 [ms] (mean, across all concurrent requests)
+Transfer rate:          111.49 [Kbytes/sec] received
+
+Connnection Times (ms)
+              min  mean[+/-sd] median   max
+Connect:        0     0    0.0      0     0
+Processing:  1600  3921  640.4   3877  5694
+Waiting:     1600  3921  640.4   3877  5694
+Total:       1600  3921  640.4   3877  5694
+
+Percentage of the requests served within a certain time (ms)
+  50%   3877
+  66%   4187
+  75%   4353
+  80%   4402
+  90%   4585
+  95%   4919
+  98%   5351
+  99%   5694
+ 100%   5694 (last request)