thin 1.6.4 → 2.0.0.pre

data/.gitignore

@@ -0,0 +1,9 @@
+*.gem
+*.log
+*.pid
+.bundle
+Gemfile.lock
+pkg/*
+tmp
+.yardoc
+test.conf.rb

data/CHANGELOG

@@ -1,68 +1,3 @@
-== 1.6.4 Gob Bluth
- * Increase REQUEST_PATH to 2048 symbols [X2rdas]
- * Fix warning in logger [tenderlove]
- * Add :timeout option for Rack::Server.new [sugitak]
- * When restarting, exit on a next tick so we can send response back to a client [rsamoilov]
- * Check for empty PID files [z1dane]
- * Update Event Machine version to 1.0.4, Ruby 2.2.0 fix [freemanoid]
-
-
-== 1.6.3 Protein Powder
- * Add HTTP 422 status code [rajcybage]
- * Add warning about EM reactor still running when stopping.
- * Remove version number from "Server" HTTP header. [benbasson]
- * Adding `--ssl-disable-verify` to allow disabling of client cert requests when SSL enabled [brucek]
- * Ensure Tempfiles created by a large request are closed and deleted. [Tonkpils]
-
-== 1.6.2 Doc Brown
- * No longer replace response's body on HEAD request. Ensuring body.close will be called.
- * Remove `---ssl-verify` option as EventMachine doesn't verify the certificate.
- * Fix env['rack.peer_cert'] to return SSL certifcate.
-
-== 1.6.1 Death Proof
- * Regression: Default logger to STDOUT when using outside of CLI.
- * Regression: Downgrade Rack required version back to 1.0 to work w/ prior Rails versions.
-
-== 1.6.0 Greek Yogurt
- * Accept absolute URL in request line, eg.: 'GET http://site.com/he/lo HTTP/1.1'.
- * HEAD request no longer return a body in the response.
- * No longer stop EventMachine's reactor loop unless it was started by Thin.
- * Make request env keys upcasing locale-agnostic.
- * Use Ruby's `Logger` for logging. [Akshay Moghe].
-   The logger can now be set using `Thin::Logging.logger=`.
-   Tracing of request is handled by a second logger, `Thin::Logging.trace_logger=`.
- * Add --threadpool-size option to configure EM's thread pool size (default: 20).
- * Pipelining is no longer supported.
-
-== 1.5.1 Straight Razor
- * Fix issue when running as another user/group without a PID file.
- * Allow overriding Connection & Server response headers.
- * Update vlad example [Mathieu Lemoine]
- * Keep connections in a Hash to speedup deletion [slivu]
- * Force kill using already known pid. Prevents "thin stop" from leaving a process that removed its
-   pid file, but is still running (e.g. hung on some at_exit callback) [Michal Kwiatkowski]
-
-== 1.5.0 Knife
- * Fix compilation under Ubuntu 12.04 with -Werror=format-security option.
- * Raise an error when no PID file.
- * Prevent duplicate response headers.
- * Make proper response on exception [MasterLambaster].
- * Automatically close idling pipeline connections on server stop [MasterLambaster].
-
-== 1.4.1 Chromeo Fix
- * Fix error when sending USR1 signal and no log file is supplied.
-
-== 1.4.0 Chromeo
- * kill -USR1 $PID for log rotation [catwell].
- * Fix HUP signal being reseted after deamonization [atotic].
- * Fix error with nil addresses in Connection#socket_address.
-
-== 1.3.2 Low-bar Squat
- * Remove mack and halcyon Rack adapters from automatic detection.
-
-== 1.3.1 Triple Espresso
- * Fix service not working pre 1.9.
-
 == 1.3.0 Double Espresso
  * BREAKING CHANGE: Thin no longer ships with fat Windows binaries.
    From now on, to install on Windows, install https://github.com/oneclick/rubyinstaller/wiki/Development-Kit.
@@ -70,10 +5,10 @@
    It is now the responsibility of the app (or a middleware) to set the Content-Length.
  * Log errors to STDERR [textgoeshere]
  * Shut down gracefully when receiving SIGTERM [ddollar]
-
+     
      Processes are allowed a chance to shut down gracefully when receiving
      SIGTERM (http://en.wikipedia.org/wiki/SIGTERM).
-
+     
      On Heroku, when shutting down a process, we send a SIGTERM followed 10
      seconds later with a SIGKILL, similar to the behavior of the init daemon
      on most Unix systems. This patch will allow Heroku apps to shut down
@@ -98,7 +33,7 @@
      the existing connection to another protocol, and specifically is NOT
      used to upgrade a separate connection. Therefore, the connection must
      remain open after this response in order to facilitate that.
-
+   
  * Accept IE7 badly encoded URL (eg.: %uEEEE)
  * Fix gemspec to work w/ Bundler [smparkes]
  * Add SSL support [tmm1]
@@ -114,10 +49,10 @@
       --ssl-key-file PATH      Path to private key
       --ssl-cert-file PATH     Path to certificate
       --ssl-verify             Enables SSL certificate verification
-
+    
   * Expose peer SSL certificate in env (rack.peer_cert) [fd]
   * Adjusting unix socket permissions to be more open [mbj]
-
+  
 == 1.2.7 No Hup
  * Support multiple Ruby version (fat binaries under windows)
  * Do not trap unsupported HUP signal on Windows
@@ -141,7 +76,7 @@
 == 1.2.2 I Find Your Lack of Sauce Disturbing release
  * Fix force kill under 1.9 [Alexey Chebotar]
  * Fix regression when --only option is used w/ --socket.
- * Add process name 'tag' functionality. Easier to distinguish thin daemons
+ * Add process name 'tag' functionality. Easier to distinguish thin daemons 
    from eachother in process listing [ctcherry]
 
 == 1.2.1 Asynctilicious Ultra Supreme release
@@ -151,11 +86,11 @@
  * Allow String for response body
  * Require openssl before eventmachine to prevent crash in 1.9
 
-== 1.2.0 Asynctilicious Supreme release
+== 1.2.0 Asynctilicious Supreme release 
  * Add support for Windows mingw Ruby distro [Juan C. Rodriguez]
  * Add async response support, see example/async_*.ru [raggi]
 
-== 1.1.1 Super Disco Power Plus release
+== 1.1.1 Super Disco Power Plus release 
  * Fix bug when running with only options [hasimo]
 
 == 1.1.0 Super Disco Power release
@@ -252,20 +187,20 @@
  * 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].
@@ -273,9 +208,9 @@
    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.
@@ -301,9 +236,9 @@
  * 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
@@ -314,20 +249,20 @@
  * 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
@@ -336,13 +271,13 @@
          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 KB)
+ * 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
@@ -354,7 +289,7 @@
    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
@@ -374,7 +309,7 @@
      --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.
@@ -389,9 +324,9 @@
 
 == 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/Gemfile

@@ -0,0 +1,8 @@
+source "http://rubygems.org"
+
+# Specify your gem's dependencies in thin.gemspec
+gemspec
+
+group :test do
+  gem "mocha", "~> 0.10.0"
+end

data/README.md

@@ -1,170 +1,68 @@
-Thin
-====
+---
 
-Tiny, fast & funny HTTP server
+# This is alpha software. Things might break, people will cry and it will be your fault.
+### When reporting issues, make sure to mention you're using Thin v2.
 
-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
+# Thin
+Tiny, fast & funny Ruby server
+
+Thin is a high performance and customizable Ruby server. It's structured much like Nginx. A
+master process listen to incoming requests and dispatch to its worker processes, each one
+running an EventMachine event loop.
 
 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://github.com/macournoyer/thin/issues
-    Code:  http://github.com/macournoyer/thin
-    IRC:   #thin on freenode
+**Site:**  http://code.macournoyer.com/thin/  
+**Group:** http://groups.google.com/group/thin-ruby/topics  
+**Bugs:**  http://github.com/macournoyer/thin/issues  
+**Code:**  http://github.com/macournoyer/thin  
+**IRC:**   #thin on freenode  
 
-## Installation
+## Features
+
+ * Prefork model with an EventMachine loop running in each worker.
+ * Optional single process mode for non-UNIX systems and simpler deployments.
+ * Optional threaded mode using a pool of threads.
+ * Easy asynchronous streaming response support with chunked encoding.
+ * Fast file serving with automatic streaming for large files.
+ * Keep-alive support.
+ * SSL support (upcoming).
 
-For the latest stable version:
+## Installation
+For this pre-release of version 2.0:
 
-`gem install thin`
+    $ gem install thin --pre
 
 Or from source:
 
-```
-git clone git://github.com/macournoyer/thin.git
-cd thin
-rake install
-```
+    $ git clone git://github.com/macournoyer/thin.git
+    $ git checkout v2
+    $ cd thin
+    $ bundle install
+    $ rake install
 
 ## Usage
+The `thin` script offers an easy way to start your Rack based application and acts just like
+the `rackup` script.:
 
-A +thin+ script offers an easy way to start your Rack application:
-
-```
-cd to/your/app
-thin start
-```
-
-When using with Rails and Bundler, make sure to add `gem 'thin'`
-to your Gemfile.
-
-See example directory for samples.
-
-### Command Line Examples
-
-Use a rackup file and bind to localhost port 8080:
-
-```
-thin -R config.ru -a 127.0.0.1 -p 8080 start
-```
-
-Store the server process ID, log to a file and daemonize:
-
-```
-thin -p 9292 -P tmp/pids/thin.pid -l logs/thin.log -d start
-```
-
-Thin is quite flexible in that many options can be specified at the command line (see below for usage).
-
-### Configuration files
-
-You can create configuration files in yaml format and feed them to thin using `thin -C config.yml`.  Here is an example config file:
-
-```yaml
---- 
-user: www-data
-group: www-data
-pid: tmp/pids/thin.pid
-timeout: 30
-wait: 30
-log: log/thin.log
-max_conns: 1024
-require: []
-environment: production
-max_persistent_conns: 512
-servers: 1
-threaded: true
-no-epoll: true
-daemonize: true
-socket: tmp/sockets/thin.sock
-chdir: /path/to/your/apps/root
-tag: a-name-to-show-up-in-ps aux
-```
-
-### Command Line Options
-
-This is the usage for the thin command which can be obtained by running `thin -h` at the command line.
-
-```sh
-Usage: thin [options] start|stop|restart|config|install
-
-Server options:
-    -a, --address HOST               bind to HOST address (default: 0.0.0.0)
-    -p, --port PORT                  use PORT (default: 3000)
-    -S, --socket FILE                bind to unix domain socket
-    -y, --swiftiply [KEY]            Run using swiftiply
-    -A, --adapter NAME               Rack adapter to use (default: autodetect)
-                                     (rack, rails, ramaze, merb, file)
-    -R, --rackup FILE                Load a Rack config file instead of Rack adapter
-    -c, --chdir DIR                  Change to dir before starting
-        --stats PATH                 Mount the Stats adapter under PATH
-
-SSL options:
-        --ssl                        Enables SSL
-        --ssl-key-file PATH          Path to private key
-        --ssl-cert-file PATH         Path to certificate
-        --ssl-disable-verify         Disables (optional) client cert requests
-
-Adapter options:
-    -e, --environment ENV            Framework environment (default: development)
-        --prefix PATH                Mount the app under PATH (start with /)
-
-Daemon options:
-    -d, --daemonize                  Run daemonized in the background
-    -l, --log FILE                   File to redirect output (default: /home/robert/log/thin.log)
-    -P, --pid FILE                   File to store PID (default: tmp/pids/thin.pid)
-    -u, --user NAME                  User to run daemon as (use with -g)
-    -g, --group NAME                 Group to run daemon as (use with -u)
-        --tag NAME                   Additional text to display in process listing
-
-Cluster options:
-    -s, --servers NUM                Number of servers to start
-    -o, --only NUM                   Send command to only one server of the cluster
-    -C, --config FILE                Load options from config file
-        --all [DIR]                  Send command to each config files in DIR
-    -O, --onebyone                   Restart the cluster one by one (only works with restart command)
-    -w, --wait NUM                   Maximum wait time for server to be started in seconds (use with -O)
-
-Tuning options:
-    -b, --backend CLASS              Backend to use, full classname
-    -t, --timeout SEC                Request or command timeout in sec (default: 30)
-    -f, --force                      Force the execution of the command
-        --max-conns NUM              Maximum number of open file descriptors (default: 1024)
-                                     Might require sudo to set higher than 1024
-        --max-persistent-conns NUM   Maximum number of persistent connections
-                                     (default: 100)
-        --threaded                   Call the Rack application in threads [experimental]
-        --threadpool-size NUM        Sets the size of the EventMachine threadpool.
-                                     (default: 20)
-        --no-epoll                   Disable the use of epoll
-
-Common options:
-    -r, --require FILE               require the library
-    -q, --quiet                      Silence all logging
-    -D, --debug                      Enable debug logging
-    -V, --trace                      Set tracing on (log raw request/response)
-    -h, --help                       Show this message
-    -v, --version                    Show version
-```
+    $ cd to/your/rack/app
+    $ thin
 
-## License
+To use with Rails, add thin to your Gemfile and use Rails server command:
 
-Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
+    $ echo "gem 'thin'" >> Gemfile
+    $ bundle install
+    $ rails server thin
 
-## Credits
+See examples/thin.conf.rb for a sample configuration file.
 
-The parser was stolen from Mongrel http://mongrel.rubyforge.org by Zed Shaw.
-Mongrel is copyright 2007 Zed A. Shaw and contributors. It is licensed under
-the Ruby license and the GPL2.
+Run `thin -h` to list available options.
 
-Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>
+## License
+Ruby License, http://www.ruby-lang.org/en/LICENSE.txt.
 
-Get help at http://groups.google.com/group/thin-ruby/
-Report bugs at https://github.com/macournoyer/thin/issues
-and major security issues directly to me macournoyer@gmail.com.
+## Credits
+Thin is copyright Marc-Andre Cournoyer <macournoyer@gmail.com>