public
Description: A very fast & simple Ruby web server
Homepage: http://code.macournoyer.com/thin/
Clone URL: git://github.com/macournoyer/thin.git
Search Repo:
kevwil (author)
Wed Jan 16 19:21:07 -0800 2008
commit  1f4be478303aab34181af828f1228d04e14f57dd
tree    8a8fb31150cbd3efe1dc5d84614667f809f8d581
parent  d5b8163b27f3f667cc7c2c418e46e5e1e2e77418
thin /
name age message
folder .gitignore Sat Jan 05 19:49:21 -0800 2008 Restore usage and download pages on web site. [macournoyer]
folder CHANGELOG Sun Jan 13 19:50:28 -0800 2008 Add prefix option to thin script to mount app u... [macournoyer]
folder COMMITTERS Wed Jan 16 19:21:07 -0800 2008 add email address to COMMITTERS file [kevwil]
folder COPYING Wed Jan 09 19:29:16 -0800 2008 Add some thing to do [macournoyer]
folder README Thu Jan 10 19:58:01 -0800 2008 Update Git repo url. [macournoyer]
folder Rakefile Sun Jan 13 20:44:41 -0800 2008 Try to make win32 build work [macournoyer]
folder TODO Wed Jan 16 06:32:29 -0800 2008 Fixing typo in James last name, aye sry! [macournoyer]
folder benchmark/ Mon Jan 07 21:14:43 -0800 2008 Update announcement email and make benchmark sc... [macournoyer]
folder bin/ Sun Jan 13 19:50:28 -0800 2008 Add prefix option to thin script to mount app u... [macournoyer]
folder doc/ Sun Dec 16 15:28:13 -0800 2007 Update benchmarks and web site [macournoyer]
folder example/ Wed Jan 09 21:46:54 -0800 2008 Fix IOError when writing to logger when startin... [macournoyer]
folder ext/ Sat Jan 05 05:26:21 -0800 2008 Fix parser to be Ruby 1.9 compatible [Aman Gupta] [macournoyer]
folder lib/ Sun Jan 13 19:50:28 -0800 2008 Add prefix option to thin script to mount app u... [macournoyer]
folder site/ Tue Jan 15 08:33:24 -0800 2008 Add James site to users page [macournoyer]
folder spec/ Sun Jan 13 19:50:28 -0800 2008 Add prefix option to thin script to mount app u... [macournoyer]
folder tasks/ Sun Jan 13 20:44:41 -0800 2008 Try to make win32 build work [macournoyer]
README
== 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.