RubyGems - mongrel - Versions diffs - 0.2.0 - Mend

mongrel 0.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

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

data/doc/rdoc/files/README.html ADDED

@@ -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>