RubyGems - mongrel - Versions diffs - 0.3.12.4 → 0.3.13 - Mend

mongrel 0.3.12.4 → 0.3.13

Files changed (264) hide show

data/doc/rdoc/classes/Kernel.src/{M000025.html → M000020.html} RENAMED

@@ -10,10 +10,10 @@
   <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
 </head>
 <body class="standalone-code">
-  <pre>     <span class="ruby-comment cmt"># File lib/mongrel/debug.rb, line 118</span>
-118:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">open</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">arg</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
-119:     <span class="ruby-identifier">$open_files</span>[<span class="ruby-keyword kw">self</span>] = <span class="ruby-identifier">arg</span>[<span class="ruby-value">0</span>]
-120:     <span class="ruby-identifier">orig_open</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">arg</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
-121:   <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel/debug.rb, line 131</span>
+131:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">open</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">arg</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
+132:     <span class="ruby-identifier">$open_files</span>[<span class="ruby-keyword kw">self</span>] = <span class="ruby-identifier">arg</span>[<span class="ruby-value">0</span>]
+133:     <span class="ruby-identifier">orig_open</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">arg</span>,<span class="ruby-operator">&amp;</span><span class="ruby-identifier">blk</span>)
+134:   <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

data/doc/rdoc/classes/Kernel.src/M000021.html ADDED

@@ -0,0 +1,23 @@
+<?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>
+<head>
+  <title>log_open_files (Kernel)</title>
+  <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1" />
+  <link rel="stylesheet" href="../.././rdoc-style.css" type="text/css" media="screen" />
+</head>
+<body class="standalone-code">
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel/debug.rb, line 136</span>
+136:   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">log_open_files</span>
+137:     <span class="ruby-identifier">open_counts</span> = {}
+138:     <span class="ruby-identifier">$open_files</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">f</span>,<span class="ruby-identifier">args</span><span class="ruby-operator">|</span>
+139:       <span class="ruby-identifier">open_counts</span>[<span class="ruby-identifier">args</span>] <span class="ruby-operator">||=</span> <span class="ruby-value">0</span>
+140:       <span class="ruby-identifier">open_counts</span>[<span class="ruby-identifier">args</span>] <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
+141:     <span class="ruby-keyword kw">end</span>
+142:     <span class="ruby-constant">MongrelDbg</span><span class="ruby-operator">::</span><span class="ruby-identifier">trace</span>(<span class="ruby-identifier">:files</span>, <span class="ruby-identifier">open_counts</span>.<span class="ruby-identifier">to_yaml</span>)
+143:   <span class="ruby-keyword kw">end</span></pre>
+</body>
+</html>

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

@@ -98,10 +98,28 @@
     <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.
+<a href="Mongrel.html">Mongrel</a> Web Server - A Mostly Ruby Webserver and
+Library
+</p>
+<p>
+Copyright (C) 2005 Zed A. Shaw zedshaw AT zedshaw dot com
+</p>
+<p>
+This library is free software; you can redistribute it and/or modify it
+under the terms of the GNU Lesser General Public License as published by
+the Free Software Foundation; either version 2.1 of the License, or (at
+your option) any later version.
+</p>
+<p>
+This library is distributed in the hope that it will be useful, but WITHOUT
+ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
+FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License
+for more details.
+</p>
+<p>
+You should have received a copy of the GNU Lesser General Public License
+along with this library; if not, write to the Free Software Foundation,
+Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
 </p>
     </div>
@@ -127,6 +145,7 @@ Module <a href="Mongrel/HttpHandlerPlugin.html" class="link">Mongrel::HttpHandle
 Module <a href="Mongrel/Rails.html" class="link">Mongrel::Rails</a><br />
 Class <a href="Mongrel/CGIWrapper.html" class="link">Mongrel::CGIWrapper</a><br />
 Class <a href="Mongrel/Configurator.html" class="link">Mongrel::Configurator</a><br />
+Class <a href="Mongrel/DeflateFilter.html" class="link">Mongrel::DeflateFilter</a><br />
 Class <a href="Mongrel/DirHandler.html" class="link">Mongrel::DirHandler</a><br />
 Class <a href="Mongrel/Error404Handler.html" class="link">Mongrel::Error404Handler</a><br />
 Class <a href="Mongrel/HeaderOut.html" class="link">Mongrel::HeaderOut</a><br />
@@ -136,6 +155,8 @@ Class <a href="Mongrel/HttpParserError.html" class="link">Mongrel::HttpParserErr
 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/StatisticsFilter.html" class="link">Mongrel::StatisticsFilter</a><br />
+Class <a href="Mongrel/StatusHandler.html" class="link">Mongrel::StatusHandler</a><br />
 Class <a href="Mongrel/StopServer.html" class="link">Mongrel::StopServer</a><br />
 Class <a href="Mongrel/URIClassifier.html" class="link">Mongrel::URIClassifier</a><br />

data/doc/rdoc/classes/Mongrel/CGIWrapper.html ADDED

@@ -0,0 +1,383 @@
+<?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::CGIWrapper</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::CGIWrapper</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/mongrel/cgi_rb.html">
+                lib/mongrel/cgi.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                ::CGI
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+The beginning of a complete wrapper around <a
+href="../Mongrel.html">Mongrel</a>&#8217;s internal HTTP processing system
+but maintaining the original Ruby CGI module. Use this only as a crutch to
+get existing CGI based systems working. It should handle everything, but
+please notify me if you see special warnings. This work is still very alpha
+so I need testers to help work out the various corner cases.
+</p>
+<p>
+The CGIWrapper.handler attribute is normally not set and is available for
+frameworks that need to get back to the handler. <a
+href="Rails.html">Rails</a> uses this to give people access to the
+RailsHandler#files (<a href="DirHandler.html">DirHandler</a> really) so
+they can look-up paths and do other things with the files managed there.
+</p>
+<p>
+In <a href="Rails.html">Rails</a> you can get the real file for a request
+with:
+</p>
+<pre>
+ path = @request.cgi.handler.files.can_serve(@request['PATH_INFO'])
+</pre>
+<p>
+Which is ugly but does the job. Feel free to write a <a
+href="Rails.html">Rails</a> helper for that. Refer to <a
+href="DirHandler.html#M000057">DirHandler#can_serve</a> for more
+information on this.
+</p>
+    </div>
+   </div>
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+      <div class="name-list">
+      <a href="#M000101">args</a>&nbsp;&nbsp;
+      <a href="#M000102">env_table</a>&nbsp;&nbsp;
+      <a href="#M000097">header</a>&nbsp;&nbsp;
+      <a href="#M000096">new</a>&nbsp;&nbsp;
+      <a href="#M000099">out</a>&nbsp;&nbsp;
+      <a href="#M000098">send_cookies</a>&nbsp;&nbsp;
+      <a href="#M000100">status</a>&nbsp;&nbsp;
+      <a href="#M000103">stdinput</a>&nbsp;&nbsp;
+      <a href="#M000104">stdoutput</a>&nbsp;&nbsp;
+      </div>
+    </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <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">REMOVED_KEYS</td>
+          <td>=</td>
+          <td class="context-item-value">[ &quot;nph&quot;,&quot;status&quot;,&quot;server&quot;,&quot;connection&quot;,&quot;type&quot;,                      &quot;charset&quot;,&quot;length&quot;,&quot;language&quot;,&quot;expires&quot;]</td>
+          <td width="3em">&nbsp;</td>
+          <td class="context-item-desc">
+these are stripped out of any keys passed to <a
+href="CGIWrapper.html#M000097">CGIWrapper.header</a> function
+</td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <div id="attribute-list">
+      <h3 class="section-bar">Attributes</h3>
+      <div class="name-list">
+        <table>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">handler</td>
+          <td class="context-item-value">&nbsp;[W]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">handler</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        <tr class="top-aligned-row context-row">
+          <td class="context-item-name">options</td>
+          <td class="context-item-value">&nbsp;[R]&nbsp;</td>
+          <td class="context-item-desc"></td>
+        </tr>
+        </table>
+      </div>
+    </div>
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Class methods</h3>
+      <div id="method-M000096" class="method-detail">
+        <a name="M000096"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000096.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000096.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(request, response, *args)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Takes an <a href="HttpRequest.html">HttpRequest</a> and <a
+href="HttpResponse.html">HttpResponse</a> object, plus any additional
+arguments normally passed to CGI. These are used internally to create a
+wrapper around the real CGI while maintaining <a
+href="../Mongrel.html">Mongrel</a>&#8217;s view of the world.
+</p>
+        </div>
+      </div>
+      <h3 class="section-bar">Public Instance methods</h3>
+      <div id="method-M000101" class="method-detail">
+        <a name="M000101"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000101.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000101.html');return false;">
+          <span class="method-name">args</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Used to wrap the normal args variable used inside CGI.
+</p>
+        </div>
+      </div>
+      <div id="method-M000102" class="method-detail">
+        <a name="M000102"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000102.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000102.html');return false;">
+          <span class="method-name">env_table</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Used to wrap the normal <a href="CGIWrapper.html#M000102">env_table</a>
+variable used inside CGI.
+</p>
+        </div>
+      </div>
+      <div id="method-M000097" class="method-detail">
+        <a name="M000097"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000097.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000097.html');return false;">
+          <span class="method-name">header</span><span class="method-args">(options = &quot;text/html&quot;)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+The header is typically called to send back the header. In our case we
+collect it into a hash for later usage.
+</p>
+<p>
+nph &#8212; Mostly ignored. It&#8216;ll output the date. connection &#8212;
+Completely ignored. Why is CGI doing this? length &#8212; Ignored since <a
+href="../Mongrel.html">Mongrel</a> figures this out from what you write to
+output.
+</p>
+        </div>
+      </div>
+      <div id="method-M000099" class="method-detail">
+        <a name="M000099"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000099.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000099.html');return false;">
+          <span class="method-name">out</span><span class="method-args">(options = &quot;text/html&quot;) {||| &quot;&quot;)| ...}</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+The dumb thing is people can call header or this or both and in any order.
+So, we just reuse header and then finalize the <a
+href="HttpResponse.html">HttpResponse</a> the right way. Status is taken
+from the various options and converted to what <a
+href="../Mongrel.html">Mongrel</a> needs via the <a
+href="CGIWrapper.html#M000100">CGIWrapper.status</a> function.
+</p>
+        </div>
+      </div>
+      <div id="method-M000098" class="method-detail">
+        <a name="M000098"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000098.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000098.html');return false;">
+          <span class="method-name">send_cookies</span><span class="method-args">(to)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Takes any &#8216;cookie&#8217; setting and sends it over the <a
+href="../Mongrel.html">Mongrel</a> header, then removes the setting from
+the options. If cookie is an Array or Hash then it sends those on with
+.to_s, otherwise it just calls .to_s on it and hopefully your
+&quot;cookie&quot; can write itself correctly.
+</p>
+        </div>
+      </div>
+      <div id="method-M000100" class="method-detail">
+        <a name="M000100"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000100.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000100.html');return false;">
+          <span class="method-name">status</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Computes the status once, but lazily so that people who call header twice
+don&#8217;t get penalized. Because CGI insists on including the options
+status message in the status we have to do a bit of parsing.
+</p>
+        </div>
+      </div>
+      <div id="method-M000103" class="method-detail">
+        <a name="M000103"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000103.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000103.html');return false;">
+          <span class="method-name">stdinput</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Used to wrap the normal stdinput variable used inside CGI.
+</p>
+        </div>
+      </div>
+      <div id="method-M000104" class="method-detail">
+        <a name="M000104"></a>
+        <div class="method-heading">
+          <a href="CGIWrapper.src/M000104.html" target="Code" class="method-signature"
+            onclick="popupCode('CGIWrapper.src/M000104.html');return false;">
+          <span class="method-name">stdoutput</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+The stdoutput should be completely bypassed but we&#8217;ll drop a warning
+just in case
+</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>