mongrel 0.3.8 → 0.3.9

data/doc/rdoc/created.rid

@@ -1 +1 @@
-Sat Mar 04 13:27:08 EST 2006
+Mon Mar 06 00:47:36 EST 2006

data/doc/rdoc/files/README.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Feb 22 13:06:44 EST 2006</td>
+      <td>Mon Mar 06 00:25:36 EST 2006</td>
     </tr>
     </table>
   </div>
@@ -84,13 +84,34 @@ portability issues.
 </p>
 <h2>Status</h2>
 <p>
-The 0.3.6 release supports Ruby On Rails much better than previously, and
-also sports the beginning of a command and plugin infrastructure. There is
-now a more complete CGIWrapper that handles most of the CGI usage, but
-still doesn&#8217;t do the MIME decoding or file upload/send (it leaves
-that to CGI). Finally, there&#8217;s a great mongrel_rails_service script
-for running under Win32 as a service.
+<a href="../classes/Mongrel.html">Mongrel</a> 0.3.9 now supports a fancy
+RubyGems based plugin system called GemPlugin. It uses the basic machinery
+of RubyGems to implement dynamically loaded plugins based on dependencies.
+Writing a plugin is pretty easy, but right now it&#8217;s not as well
+documented as it should be. There is a simple example plugin for adding a
+status command to your mongrel. Just do:
 </p>
+<pre>
+ &gt; gem install mongrel_status
+</pre>
+<p>
+And you&#8217;ll then get a new status command. Then just do:
+</p>
+<pre>
+ &gt; cd myrailsapp
+ &gt; mongrel_rails start -d
+ &gt; mongrel_rails status
+</pre>
+<p>
+And it&#8217;ll print out the PID your Rails app is running under.
+</p>
+<p>
+The GemPlugin project is a sub-project of <a
+href="../classes/Mongrel.html">Mongrel</a>, but it&#8217;s licensed under
+the Ruby license and is usable outside <a
+href="../classes/Mongrel.html">Mongrel</a>
+</p>
+<h2>Quick Start</h2>
 <p>
 After you&#8217;ve installed (either with gem install mongrel or via
 source) you should have the mongrel_rails command available in your PATH.
@@ -146,10 +167,15 @@ do:
  $ mongrel_rails_service start -n myapp
 </pre>
 <p>
-Now hit the port and poof, works. *Stopping the service is a little
-problematic right now.*
+Now hit the port and poof, works.
 </p>
 <p>
+Stopping a service is simple:
+</p>
+<pre>
+ $ mongrel_rails_service stop -n myapp
+</pre>
+<p>
 If you run into an app that&#8217;s not running right, my suggestion is to
 run it with the regular mongrel_rails runner:
 </p>
@@ -161,6 +187,13 @@ run it with the regular mongrel_rails runner:
 Since that will spit out error messages and stuff to the console. *Use
 CTRL-Pause/Break to stop.*
 </p>
+<p>
+Best thing about the win32 support is that you can simply use the Windows
+Services in Control Panel-&gt;Admin Tools to work with it. You can also
+install the same Rails app as different installs. For example I&#8217;ve
+got myapp_dev, and myapp_prod and just start/stop which one I want to work
+with.
+</p>
 <h2>Install</h2>
 <p>
 It doesn&#8217;t explicitly require Camping, but if you want to run the
@@ -199,9 +232,9 @@ example:
 <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
-Mongrel::Error404Handler for a basic way to give a more complex 404
-message.
+&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>
 <p>
 This also shows the DirHandler with directory listings. This is still rough
@@ -229,44 +262,6 @@ 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>
-<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>An idea I&#8217;ve had for an insane caching handler which could speed up
-quite a
-
-</li>
-</ul>
-<p>
-few deployments.
-</p>
-<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; Nitro folks have already hooked this up and started using it.
-Nice.
-
-</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

data/doc/rdoc/files/lib/mongrel/cgi_rb.html

@@ -0,0 +1,108 @@
+<?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: cgi.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>cgi.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/mongrel/cgi.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Sat Mar 04 12:53:36 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">
+      cgi&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>

data/doc/rdoc/files/lib/mongrel/command_rb.html

@@ -0,0 +1,110 @@
+<?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: command.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>command.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/mongrel/command.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Sun Mar 05 22:20:07 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">
+      singleton&nbsp;&nbsp;
+      optparse&nbsp;&nbsp;
+      mongrel/plugins&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>

data/doc/rdoc/files/lib/mongrel/handlers_rb.html

@@ -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: handlers.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>handlers.rb</h1>
+    <table class="header-table">
+    <tr class="top-aligned-row">
+      <td><strong>Path:</strong></td>
+      <td>lib/mongrel/handlers.rb
+      </td>
+    </tr>
+    <tr class="top-aligned-row">
+      <td><strong>Last Update:</strong></td>
+      <td>Mon Feb 20 19:06:29 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>