mongrel 0.2.0

data/README

@@ -0,0 +1,117 @@
+= Mongrel:  Simple Fast Mostly Ruby Web Server
+
+Mongrel is a small library that provides a very fast HTTP 1.1 server for Ruby
+web applications.  It is not particular to any framework, and is intended to
+be just enough to get a web application running behind a more complete and robust
+web server.
+
+What makes Mongrel so fast is the careful use of a C extension to provide fast
+HTTP 1.1 protocol parsing and fast URI lookup.  This combination makes the server
+scream without too many portability issues.
+
+== Status
+
+The 0.2.0 release of Mongrel features an HTTP core server that is the fastest possible
+thing I could get without using something other than Ruby.  It features a few bug fixes,
+but mostly just a change to the Mongrel::HttpResponse class to make it more feature 
+complete.  The remaining development will be spent getting Mongrel to work with 
+other frameworks, adding additional needed features, and improving the concurrency
+and speed.
+
+The current release has samples from "why the lucky stiff" for his Camping
+framework in the examples directory.  Camping is a small micro framework 
+(http://rubyforge.org/projects/camping) which should work with Mongrel if
+you use the subversion source for Camping.
+
+This is also the first release onto the new Mongrel RubyForge project
+page found at http://rubyforge.org/projects/mongrel/ thanks to Tom Copland.
+I'll be looking to automate management of this, but feel free to use
+rubyforge to post feature requests, bugs, and join the mailing list.
+
+
+== Install
+
+It doesn't explicitly require Camping, but if you want to run the examples/camping/
+examples then you'll need to install Camping 1.2 at least (and redcloth I think).  
+These are all available from RubyGems.
+
+The library consists of a C extension so you'll need a C compiler or at least a friend
+who can build it for you.
+
+Finally, the source includes a setup.rb for those who hate RubyGems.
+
+
+== Usage
+
+The examples/simpletest.rb file has the following code as the simplest
+example:
+
+ require 'mongrel'
+
+ class SimpleHandler < Mongrel::HttpHandler
+    def process(request, response)
+      response.start(200) do |head,out|
+        head["Content-Type"] = "text/plain"
+        out.write("hello!\n")
+      end
+    end
+ end
+
+ h = Mongrel::HttpServer.new("0.0.0.0", "3000")
+ h.register("/test", SimpleHandler.new)
+ h.run.join
+
+If you run this and access port 3000 with a browser it will say
+"hello!".  If you access it with any url other than "/test" it will
+give a simple 404.  Check out the Mongrel::Error404Handler for a 
+basic way to give a more complex 404 message.
+
+== Speed
+
+The 0.2.0 release probably consists of the most effort I've ever put into 
+tuning a Ruby library for speed.  It consists of nearly everything I could think
+of to make Mongrel the fastest Ruby HTTP library possible.  I've tried about 
+seven different architectures and IO processing methods and none of them 
+make it any faster.  In short:  Mongrel is amazingly fast considering Ruby's speed
+limitations.
+
+This release also brings in controllable threads that you can scale to meet your
+needs to do your processing.  Simple pass in the HttpServer.new third optional
+parameter:
+
+ h = Mongrel::HttpServer.new("0.0.0.0", "3000", 40)
+
+Which will make 40 thread processors.  Right now the optimal setting is up in
+the air, but 20 seemed to be about the sweet spot on my systems.  The 
+limited processors also means that you can use ActiveRecord as-is and it will
+create a matching database connection for each processor thread.  More on 
+this in future releases.
+
+With this release I'm hoping that I've created a nice solid fast as hell core
+upon which I can build the remaining features I want in Mongrel.
+
+== The Future
+
+With the core of Mongrel completed I'm now turning to the next set of features
+to make Mongrel useful for hosting web applications in a heavily utilized
+production environment.  Right now I'm looking at:
+
+* Fast static file handling with directory listings.
+* More testing on more platforms.
+* An idea I've had for an insane caching handler which could speed up quite a
+few deployments.
+* General little things most web servers need.
+* A nice management system or interface for controlling mongrel servers.
+
+Overall though the goal of Mongrel is to be just enough HTTP to serve a Ruby
+web application that sits behind a more complete web server.  Everything 
+in the next will focus on actually hosting the major web frameworks for Ruby:
+
+* Camping -- because it's already done (thanks Why).
+* Ruby on Rails -- that's where my bread is buttered right now.
+* Nitro -- George is a nice guy, and Nitro is thread safe.  Might be fun.
+* ????? -- Others people might be interested in.
+
+== Contact
+
+E-mail zedshaw at zedshaw.com and I'll help.  Comments about the API are welcome.

data/Rakefile

@@ -0,0 +1,30 @@
+require 'rake'
+require 'rake/testtask'
+require 'rake/clean'
+require 'rake/gempackagetask'
+require 'rake/rdoctask'
+require 'tools/rakehelp'
+require 'fileutils'
+include FileUtils
+
+setup_tests
+setup_clean ["ext/http11/Makefile", "pkg", "lib/*.bundle", "ext/http11/*.bundle"]
+setup_rdoc ['README', 'LICENSE', 'COPYING', 'lib/*.rb',
+            'doc/**/*.rdoc', 'ext/http11/http11.c']
+
+desc "Does a full compile, test run"
+task :default => [:compile, :test]
+
+desc "Compiles all extensions"
+task :compile => [:http11]
+task :package => [:clean]
+
+task :ragel do
+	sh %{/usr/local/bin/ragel ext/http11/http11_parser.rl | /usr/local/bin/rlcodegen -G2 -o ext/http11/http11_parser.c}
+end
+
+setup_extension("http11", "http11")
+
+summary = "An experimental fast simple web server for Ruby."
+test_file = "test/test_ws.rb"
+setup_gem("mongrel", "0.2.0",  "Zed A. Shaw", summary, [], test_file)

data/doc/rdoc/classes/Mongrel.html

@@ -0,0 +1,144 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Module: Mongrel</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href=".././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Module</strong></td>
+          <td class="class-name-in-header">Mongrel</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../files/lib/mongrel_rb.html">
+                lib/mongrel.rb
+                </a>
+        <br />
+                <a href="../files/ext/http11/http11_c.html">
+                ext/http11/http11.c
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+<a href="Mongrel.html">Mongrel</a> module containing all of the classes
+(include C extensions) for running a <a href="Mongrel.html">Mongrel</a> web
+server. It contains a minimalist HTTP server with just enough functionality
+to service web application requests fast as possible.
+</p>
+
+    </div>
+
+
+   </div>
+
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+    <div id="class-list">
+      <h3 class="section-bar">Classes and Modules</h3>
+
+      Class <a href="Mongrel/Error404Handler.html" class="link">Mongrel::Error404Handler</a><br />
+Class <a href="Mongrel/HeaderOut.html" class="link">Mongrel::HeaderOut</a><br />
+Class <a href="Mongrel/HttpHandler.html" class="link">Mongrel::HttpHandler</a><br />
+Class <a href="Mongrel/HttpParser.html" class="link">Mongrel::HttpParser</a><br />
+Class <a href="Mongrel/HttpRequest.html" class="link">Mongrel::HttpRequest</a><br />
+Class <a href="Mongrel/HttpResponse.html" class="link">Mongrel::HttpResponse</a><br />
+Class <a href="Mongrel/HttpServer.html" class="link">Mongrel::HttpServer</a><br />
+Class <a href="Mongrel/URIClassifier.html" class="link">Mongrel::URIClassifier</a><br />
+
+    </div>
+
+    <div id="constants-list">
+      <h3 class="section-bar">Constants</h3>
+
+      <div class="name-list">
+        <table summary="Constants">
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">HTTP_STATUS_CODES</td>
+          <td>=</td>
+          <td class="context-item-value">{       100  =&gt; 'Continue',      101  =&gt; 'Switching Protocols',      200  =&gt; 'OK',      201  =&gt; 'Created',      202  =&gt; 'Accepted',      203  =&gt; 'Non-Authoritative Information',      204  =&gt; 'No Content',      205  =&gt; 'Reset Content',      206  =&gt; 'Partial Content',      300  =&gt; 'Multiple Choices',      301  =&gt; 'Moved Permanently',      302  =&gt; 'Moved Temporarily',      303  =&gt; 'See Other',      304  =&gt; 'Not Modified',      305  =&gt; 'Use Proxy',      400  =&gt; 'Bad Request',      401  =&gt; 'Unauthorized',      402  =&gt; 'Payment Required',      403  =&gt; 'Forbidden',      404  =&gt; 'Not Found',      405  =&gt; 'Method Not Allowed',      406  =&gt; 'Not Acceptable',      407  =&gt; 'Proxy Authentication Required',      408  =&gt; 'Request Time-out',      409  =&gt; 'Conflict',      410  =&gt; 'Gone',      411  =&gt; 'Length Required',      412  =&gt; 'Precondition Failed',      413  =&gt; 'Request Entity Too Large',      414  =&gt; 'Request-URI Too Large',      415  =&gt; 'Unsupported Media Type',      500  =&gt; 'Internal Server Error',      501  =&gt; 'Not Implemented',      502  =&gt; 'Bad Gateway',      503  =&gt; 'Service Unavailable',      504  =&gt; 'Gateway Time-out',      505  =&gt; 'HTTP Version not supported'</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+
+
+
+      
+
+
+    <!-- if method_list -->
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>

data/doc/rdoc/classes/Mongrel/Error404Handler.html

@@ -0,0 +1,171 @@
+<?xml version="1.0" encoding="iso-8859-1"?>
+<!DOCTYPE html 
+     PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
+     "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
+
+<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
+<head>
+  <title>Class: Mongrel::Error404Handler</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <meta http-equiv="Content-Script-Type" content="text/javascript" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+  <script type="text/javascript">
+  // <![CDATA[
+
+  function popupCode( url ) {
+    window.open(url, "Code", "resizable=yes,scrollbars=yes,toolbar=no,status=no,height=150,width=400")
+  }
+
+  function toggleCode( id ) {
+    if ( document.getElementById )
+      elem = document.getElementById( id );
+    else if ( document.all )
+      elem = eval( "document.all." + id );
+    else
+      return false;
+
+    elemStyle = elem.style;
+    
+    if ( elemStyle.display != "block" ) {
+      elemStyle.display = "block"
+    } else {
+      elemStyle.display = "none"
+    }
+
+    return true;
+  }
+  
+  // Make codeblocks hidden by default
+  document.writeln( "<style type=\"text/css\">div.method-source-code { display: none }</style>" )
+  
+  // ]]>
+  </script>
+
+</head>
+<body>
+
+
+
+    <div id="classHeader">
+        <table class="header-table">
+        <tr class="top-aligned-row">
+          <td><strong>Class</strong></td>
+          <td class="class-name-in-header">Mongrel::Error404Handler</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/mongrel_rb.html">
+                lib/mongrel.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                <a href="HttpHandler.html">
+                HttpHandler
+               </a>
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+    <div id="description">
+      <p>
+The server normally returns a 404 response if a URI is requested, but it
+also returns a lame empty message. This lets you do a 404 response with a
+custom message for special URIs.
+</p>
+
+    </div>
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000023">new</a>&nbsp;&nbsp;
+      <a href="#M000024">process</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+
+      <div id="method-M000023" class="method-detail">
+        <a name="M000023"></a>
+
+        <div class="method-heading">
+          <a href="Error404Handler.src/M000023.html" target="Code" class="method-signature"
+            onclick="popupCode('Error404Handler.src/M000023.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(msg)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Sets the message to return. This is constructed once for the handler so
+it&#8217;s pretty efficient.
+</p>
+        </div>
+      </div>
+
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000024" class="method-detail">
+        <a name="M000024"></a>
+
+        <div class="method-heading">
+          <a href="Error404Handler.src/M000024.html" target="Code" class="method-signature"
+            onclick="popupCode('Error404Handler.src/M000024.html');return false;">
+          <span class="method-name">process</span><span class="method-args">(request, response)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p>
+Just kicks back the standard 404 response with your special message.
+</p>
+        </div>
+      </div>
+
+
+    </div>
+
+
+  </div>
+
+
+<div id="validator-badges">
+  <p><small><a href="http://validator.w3.org/check/referer">[Validate]</a></small></p>
+</div>
+
+</body>
+</html>