RubyGems - mongrel - Versions diffs - 0.2.0 - Mend

mongrel 0.2.0

Files changed (74) hide show

data/COPYING +504 -0
data/LICENSE +504 -0
data/README +117 -0
data/Rakefile +30 -0
data/doc/rdoc/classes/Mongrel.html +144 -0
data/doc/rdoc/classes/Mongrel/Error404Handler.html +171 -0
data/doc/rdoc/classes/Mongrel/Error404Handler.src/M000023.html +18 -0
data/doc/rdoc/classes/Mongrel/Error404Handler.src/M000024.html +18 -0
data/doc/rdoc/classes/Mongrel/HeaderOut.html +167 -0
data/doc/rdoc/classes/Mongrel/HeaderOut.src/M000013.html +18 -0
data/doc/rdoc/classes/Mongrel/HeaderOut.src/M000014.html +21 -0
data/doc/rdoc/classes/Mongrel/HttpHandler.html +159 -0
data/doc/rdoc/classes/Mongrel/HttpHandler.src/M000019.html +17 -0
data/doc/rdoc/classes/Mongrel/HttpParser.html +271 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000001.html +28 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000002.html +29 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000003.html +29 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000004.html +41 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000005.html +27 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000006.html +27 -0
data/doc/rdoc/classes/Mongrel/HttpParser.src/M000007.html +28 -0
data/doc/rdoc/classes/Mongrel/HttpRequest.html +177 -0
data/doc/rdoc/classes/Mongrel/HttpRequest.src/M000025.html +30 -0
data/doc/rdoc/classes/Mongrel/HttpResponse.html +202 -0
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000020.html +21 -0
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000021.html +20 -0
data/doc/rdoc/classes/Mongrel/HttpResponse.src/M000022.html +25 -0
data/doc/rdoc/classes/Mongrel/HttpServer.html +336 -0
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000008.html +26 -0
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000009.html +58 -0
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000010.html +22 -0
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000011.html +18 -0
data/doc/rdoc/classes/Mongrel/HttpServer.src/M000012.html +18 -0
data/doc/rdoc/classes/Mongrel/URIClassifier.html +257 -0
data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000015.html +54 -0
data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000016.html +50 -0
data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000017.html +36 -0
data/doc/rdoc/classes/Mongrel/URIClassifier.src/M000018.html +73 -0
data/doc/rdoc/created.rid +1 -0
data/doc/rdoc/files/COPYING.html +756 -0
data/doc/rdoc/files/LICENSE.html +756 -0
data/doc/rdoc/files/README.html +273 -0
data/doc/rdoc/files/ext/http11/http11_c.html +101 -0
data/doc/rdoc/files/lib/mongrel_rb.html +111 -0
data/doc/rdoc/fr_class_index.html +35 -0
data/doc/rdoc/fr_file_index.html +31 -0
data/doc/rdoc/fr_method_index.html +51 -0
data/doc/rdoc/index.html +24 -0
data/doc/rdoc/rdoc-style.css +208 -0
data/examples/camping/blog.rb +300 -0
data/examples/camping/tepee.rb +168 -0
data/examples/simpletest.rb +16 -0
data/examples/webrick_compare.rb +20 -0
data/ext/http11/MANIFEST +0 -0
data/ext/http11/ext_help.h +14 -0
data/ext/http11/extconf.rb +6 -0
data/ext/http11/http11.c +436 -0
data/ext/http11/http11_parser.c +918 -0
data/ext/http11/http11_parser.h +37 -0
data/ext/http11/tst.h +40 -0
data/ext/http11/tst_cleanup.c +24 -0
data/ext/http11/tst_delete.c +146 -0
data/ext/http11/tst_grow_node_free_list.c +38 -0
data/ext/http11/tst_init.c +41 -0
data/ext/http11/tst_insert.c +192 -0
data/ext/http11/tst_search.c +54 -0
data/lib/mongrel.rb +298 -0
data/setup.rb +1360 -0
data/test/test_http11.rb +38 -0
data/test/test_response.rb +44 -0
data/test/test_uriclassifier.rb +104 -0
data/test/test_ws.rb +33 -0
data/tools/rakehelp.rb +99 -0
metadata +132 -0

@@ -0,0 +1,273 @@
+<?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>File: README</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="fileHeader">
+    <h1>README</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>README
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Tue Jan 31 00:44:18 EST 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <h1><a href="../classes/Mongrel.html">Mongrel</a>: Simple Fast Mostly Ruby Web Server</h1>
+<p>
+<a href="../classes/Mongrel.html">Mongrel</a> 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.
+</p>
+<p>
+What makes <a href="../classes/Mongrel.html">Mongrel</a> 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.
+</p>
+<h2>Status</h2>
+<p>
+The 0.2.0 release of <a href="../classes/Mongrel.html">Mongrel</a> 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 <a
+href="../classes/Mongrel/HttpResponse.html">Mongrel::HttpResponse</a> class
+to make it more feature complete. The remaining development will be spent
+getting <a href="../classes/Mongrel.html">Mongrel</a> to work with other
+frameworks, adding additional needed features, and improving the
+concurrency and speed.
+</p>
+<p>
+The current release has samples from &quot;why the lucky stiff&quot; for
+his Camping framework in the examples directory. Camping is a small micro
+framework (<a
+href="http://rubyforge.org/projects/camping">rubyforge.org/projects/camping</a>)
+which should work with <a href="../classes/Mongrel.html">Mongrel</a> if you
+use the subversion source for Camping.
+</p>
+<p>
+This is also the first release onto the new <a
+href="../classes/Mongrel.html">Mongrel</a> RubyForge project page found at
+<a
+href="http://rubyforge.org/projects/mongrel">rubyforge.org/projects/mongrel</a>/
+thanks to Tom Copland. I&#8217;ll be looking to automate management of
+this, but feel free to use rubyforge to post feature requests, bugs, and
+join the mailing list.
+</p>
+<h2>Install</h2>
+<p>
+It doesn&#8217;t explicitly require Camping, but if you want to run the
+examples/camping/ examples then you&#8217;ll need to install Camping 1.2 at
+least (and redcloth I think). These are all available from RubyGems.
+</p>
+<p>
+The library consists of a C extension so you&#8217;ll need a C compiler or
+at least a friend who can build it for you.
+</p>
+<p>
+Finally, the source includes a setup.rb for those who hate RubyGems.
+</p>
+<h2>Usage</h2>
+<p>
+The examples/simpletest.rb file has the following code as the simplest
+example:
+</p>
+<pre>
+ require 'mongrel'
+ class SimpleHandler &lt; Mongrel::HttpHandler
+    def process(request, response)
+      response.start(200) do |head,out|
+        head[&quot;Content-Type&quot;] = &quot;text/plain&quot;
+        out.write(&quot;hello!\n&quot;)
+      end
+    end
+ end
+ h = Mongrel::HttpServer.new(&quot;0.0.0.0&quot;, &quot;3000&quot;)
+ h.register(&quot;/test&quot;, SimpleHandler.new)
+ h.run.join
+</pre>
+<p>
+If you run this and access port 3000 with a browser it will say
+&quot;hello!&quot;. If you access it with any url other than
+&quot;/test&quot; it will give a simple 404. Check out the <a
+href="../classes/Mongrel/Error404Handler.html">Mongrel::Error404Handler</a>
+for a basic way to give a more complex 404 message.
+</p>
+<h2>Speed</h2>
+<p>
+The 0.2.0 release probably consists of the most effort I&#8217;ve ever put
+into tuning a Ruby library for speed. It consists of nearly everything I
+could think of to make <a href="../classes/Mongrel.html">Mongrel</a> the
+fastest Ruby HTTP library possible. I&#8217;ve tried about seven different
+architectures and IO processing methods and none of them make it any
+faster. In short: <a href="../classes/Mongrel.html">Mongrel</a> is
+amazingly fast considering Ruby&#8217;s speed limitations.
+</p>
+<p>
+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:
+</p>
+<pre>
+ h = Mongrel::HttpServer.new(&quot;0.0.0.0&quot;, &quot;3000&quot;, 40)
+</pre>
+<p>
+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.
+</p>
+<p>
+With this release I&#8217;m hoping that I&#8217;ve created a nice solid
+fast as hell core upon which I can build the remaining features I want in
+<a href="../classes/Mongrel.html">Mongrel</a>.
+</p>
+<h2>The Future</h2>
+<p>
+With the core of <a href="../classes/Mongrel.html">Mongrel</a> completed
+I&#8217;m now turning to the next set of features to make <a
+href="../classes/Mongrel.html">Mongrel</a> useful for hosting web
+applications in a heavily utilized production environment. Right now
+I&#8217;m looking at:
+</p>
+<ul>
+<li>Fast static file handling with directory listings.
+</li>
+<li>More testing on more platforms.
+</li>
+<li>An idea I&#8217;ve had for an insane caching handler which could speed up
+quite a
+</li>
+</ul>
+<p>
+few deployments.
+</p>
+<ul>
+<li>General little things most web servers need.
+</li>
+<li>A nice management system or interface for controlling mongrel servers.
+</li>
+</ul>
+<p>
+Overall though the goal of <a href="../classes/Mongrel.html">Mongrel</a> 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:
+</p>
+<ul>
+<li>Camping &#8212; because it&#8217;s already done (thanks Why).
+</li>
+<li>Ruby on Rails &#8212; that&#8217;s where my bread is buttered right now.
+</li>
+<li>Nitro &#8212; George is a nice guy, and Nitro is thread safe. Might be fun.
+</li>
+<li>????? &#8212; Others people might be interested in.
+</li>
+</ul>
+<h2>Contact</h2>
+<p>
+E-mail zedshaw at zedshaw.com and I&#8217;ll help. Comments about the API
+are welcome.
+</p>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- 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/files/ext/http11/http11_c.html ADDED

@@ -0,0 +1,101 @@
+<?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>File: http11.c</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="fileHeader">
+    <h1>http11.c</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>ext/http11/http11.c
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Jan 30 23:59:49 EST 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- 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/files/lib/mongrel_rb.html ADDED

@@ -0,0 +1,111 @@
+<?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>File: mongrel.rb</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="fileHeader">
+    <h1>mongrel.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/mongrel.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Jan 30 23:59:49 EST 2006</td>
+    </tr>
+    </table>
+  </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="requires-list">
+      <h3 class="section-bar">Required files</h3>
+      <div class="name-list">
+      socket&nbsp;&nbsp;
+      http11&nbsp;&nbsp;
+      thread&nbsp;&nbsp;
+      stringio&nbsp;&nbsp;
+      </div>
+    </div>
+   </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <!-- 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>