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/Mongrel/Command/Registry.src/M000039.html CHANGED

@@ -5,16 +5,46 @@
 <html>
 <head>
-  <title>commands (Mongrel::Command::Registry)</title>
+  <title>run (Mongrel::Command::Registry)</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/command.rb, line 116</span>
-116:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">commands</span>
-117:         <span class="ruby-identifier">pmgr</span> = <span class="ruby-constant">GemPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Manager</span>.<span class="ruby-identifier">instance</span>
-118:         <span class="ruby-identifier">list</span> = <span class="ruby-identifier">pmgr</span>.<span class="ruby-identifier">plugins</span>[<span class="ruby-value str">&quot;/commands&quot;</span>].<span class="ruby-identifier">keys</span>
-119:         <span class="ruby-keyword kw">return</span> <span class="ruby-identifier">list</span>.<span class="ruby-identifier">sort</span>
-120:       <span class="ruby-keyword kw">end</span></pre>
+  <pre>     <span class="ruby-comment cmt"># File lib/mongrel/command.rb, line 182</span>
+182:       <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">run</span>(<span class="ruby-identifier">args</span>)
+183:         <span class="ruby-comment cmt"># find the command</span>
+184:         <span class="ruby-identifier">cmd_name</span> = <span class="ruby-identifier">args</span>.<span class="ruby-identifier">shift</span>
+185:
+186:         <span class="ruby-keyword kw">if</span> <span class="ruby-operator">!</span><span class="ruby-identifier">cmd_name</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">cmd_name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;?&quot;</span> <span class="ruby-keyword kw">or</span> <span class="ruby-identifier">cmd_name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;help&quot;</span>
+187:           <span class="ruby-identifier">print_command_list</span>
+188:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+189:         <span class="ruby-keyword kw">elsif</span> <span class="ruby-identifier">cmd_name</span> <span class="ruby-operator">==</span> <span class="ruby-value str">&quot;--version&quot;</span>
+190:           <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;Mongrel Web Server #{Mongrel::Const::MONGREL_VERSION}&quot;</span>
+191:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+192:         <span class="ruby-keyword kw">end</span>
+193:
+194:         <span class="ruby-comment cmt"># command exists, set it up and validate it</span>
+195:         <span class="ruby-keyword kw">begin</span>
+196:           <span class="ruby-identifier">command</span> = <span class="ruby-constant">GemPlugin</span><span class="ruby-operator">::</span><span class="ruby-constant">Manager</span>.<span class="ruby-identifier">instance</span>.<span class="ruby-identifier">create</span>(<span class="ruby-node">&quot;/commands/#{cmd_name}&quot;</span>, <span class="ruby-identifier">:argv</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-identifier">args</span>)
+197:         <span class="ruby-keyword kw">rescue</span>
+198:           <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-value str">&quot;INVALID COMMAND: #$!&quot;</span>
+199:           <span class="ruby-identifier">print_command_list</span>
+200:           <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+201:         <span class="ruby-keyword kw">end</span>
+202:
+203:         <span class="ruby-comment cmt"># Normally the command is NOT valid right after being created</span>
+204:         <span class="ruby-comment cmt"># but sometimes (like with -h or -v) there's no further processing</span>
+205:         <span class="ruby-comment cmt"># needed so the command is already valid so we can skip it.</span>
+206:         <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">command</span>.<span class="ruby-identifier">done_validating</span>
+207:           <span class="ruby-keyword kw">if</span> <span class="ruby-keyword kw">not</span> <span class="ruby-identifier">command</span>.<span class="ruby-identifier">validate</span>
+208:             <span class="ruby-constant">STDERR</span>.<span class="ruby-identifier">puts</span> <span class="ruby-node">&quot;#{cmd_name} reported an error. Use mongrel_rails #{cmd_name} -h to get help.&quot;</span>
+209:             <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">false</span>
+210:           <span class="ruby-keyword kw">else</span>
+211:             <span class="ruby-identifier">command</span>.<span class="ruby-identifier">run</span>
+212:           <span class="ruby-keyword kw">end</span>
+213:         <span class="ruby-keyword kw">end</span>
+214:
+215:         <span class="ruby-keyword kw">return</span> <span class="ruby-keyword kw">true</span>
+216:       <span class="ruby-keyword kw">end</span></pre>
 </body>
 </html>

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

@@ -0,0 +1,651 @@
+<?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::Configurator</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::Configurator</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>
+                Object
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+  <div id="bodyContent">
+  <div id="contextContent">
+    <div id="description">
+      <p>
+Implements a simple DSL for configuring a <a
+href="../Mongrel.html">Mongrel</a> server for your purposes. More used by
+framework implementers to setup <a href="../Mongrel.html">Mongrel</a> how
+they like, but could be used by regular folks to add more things to an
+existing mongrel configuration.
+</p>
+<p>
+It is used like this:
+</p>
+<pre>
+  require 'mongrel'
+  config = Mongrel::Configurator.new :host =&gt; &quot;127.0.0.1&quot; do
+    listener :port =&gt; 3000 do
+      uri &quot;/app&quot;, :handler =&gt; Mongrel::DirHandler.new(&quot;.&quot;, load_mime_map(&quot;mime.yaml&quot;))
+    end
+    run
+  end
+</pre>
+<p>
+This will setup a simple <a href="DirHandler.html">DirHandler</a> at the
+current directory and load additional mime types from mimy.yaml. The :host
+=&gt; &quot;127.0.0.1&quot; is actually not specific to the servers but
+just a hash of default parameters that all server or uri calls receive.
+</p>
+<p>
+When you are inside the block after <a
+href="Configurator.html#M000105">Mongrel::Configurator.new</a> you can
+simply call functions that are part of <a
+href="Configurator.html">Configurator</a> (like server, uri, daemonize,
+etc) without having to refer to anything else. You can also call these
+functions on the resulting object directly for additional configuration.
+</p>
+<p>
+A major thing about <a href="Configurator.html">Configurator</a> is that it
+actually lets you configure multiple listeners for any hosts and ports you
+want. These are kept in a map config.listeners so you can get to them.
+</p>
+<ul>
+<li>:pid_file =&gt; Where to write the process ID.
+</li>
+</ul>
+    </div>
+   </div>
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+      <div class="name-list">
+      <a href="#M000106">change_privilege</a>&nbsp;&nbsp;
+      <a href="#M000109">cloaker</a>&nbsp;&nbsp;
+      <a href="#M000108">cloaking_class</a>&nbsp;&nbsp;
+      <a href="#M000113">daemonize</a>&nbsp;&nbsp;
+      <a href="#M000121">debug</a>&nbsp;&nbsp;
+      <a href="#M000120">join</a>&nbsp;&nbsp;
+      <a href="#M000111">listener</a>&nbsp;&nbsp;
+      <a href="#M000116">load_mime_map</a>&nbsp;&nbsp;
+      <a href="#M000114">load_plugins</a>&nbsp;&nbsp;
+      <a href="#M000115">load_yaml</a>&nbsp;&nbsp;
+      <a href="#M000124">log</a>&nbsp;&nbsp;
+      <a href="#M000105">new</a>&nbsp;&nbsp;
+      <a href="#M000117">plugin</a>&nbsp;&nbsp;
+      <a href="#M000110">resolve_defaults</a>&nbsp;&nbsp;
+      <a href="#M000118">run</a>&nbsp;&nbsp;
+      <a href="#M000122">run_config</a>&nbsp;&nbsp;
+      <a href="#M000123">setup_signals</a>&nbsp;&nbsp;
+      <a href="#M000119">stop</a>&nbsp;&nbsp;
+      <a href="#M000112">uri</a>&nbsp;&nbsp;
+      <a href="#M000107">write_pid_file</a>&nbsp;&nbsp;
+      </div>
+    </div>
+  </div>
+    <!-- if includes -->
+    <div id="section">
+    <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">defaults</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">listeners</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">needs_restart</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-M000105" class="method-detail">
+        <a name="M000105"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000105.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000105.html');return false;">
+          <span class="method-name">new</span><span class="method-args">(defaults={}, &amp;blk)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+You pass in initial defaults and then a block to continue configuring.
+</p>
+        </div>
+      </div>
+      <h3 class="section-bar">Public Instance methods</h3>
+      <div id="method-M000106" class="method-detail">
+        <a name="M000106"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000106.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000106.html');return false;">
+          <span class="method-name">change_privilege</span><span class="method-args">(user, group)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Change privilege of the process to specified user and group.
+</p>
+        </div>
+      </div>
+      <div id="method-M000109" class="method-detail">
+        <a name="M000109"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000109.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000109.html');return false;">
+          <span class="method-name">cloaker</span><span class="method-args">(&amp;blk)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Do not call this. You were warned.
+</p>
+        </div>
+      </div>
+      <div id="method-M000108" class="method-detail">
+        <a name="M000108"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000108.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000108.html');return false;">
+          <span class="method-name">cloaking_class</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+generates a class for cloaking the current self and making the DSL nicer
+</p>
+        </div>
+      </div>
+      <div id="method-M000113" class="method-detail">
+        <a name="M000113"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000113.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000113.html');return false;">
+          <span class="method-name">daemonize</span><span class="method-args">(options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Daemonizes the current Ruby script turning all the listeners into an actual
+&quot;server&quot; or detached process. You must call this <b>before</b>
+frameworks that open files as otherwise the files will be closed by this
+function.
+</p>
+<p>
+Does not work for Win32 systems (the call is silently ignored).
+</p>
+<p>
+Requires the following options or defaults:
+</p>
+<ul>
+<li>:cwd =&gt; Directory to change to.
+</li>
+<li>:log_file =&gt; Where to write STDOUT and STDERR.
+</li>
+</ul>
+<p>
+It is safe to call this on win32 as it will only require the daemons
+gem/library if NOT win32.
+</p>
+        </div>
+      </div>
+      <div id="method-M000121" class="method-detail">
+        <a name="M000121"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000121.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000121.html');return false;">
+          <span class="method-name">debug</span><span class="method-args">(location, what = [:object, :rails, :files, :threads, :params])</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Calling this before you register your URIs to the given location will setup
+a set of handlers that log open files, objects, and the parameters for each
+request. This helps you track common problems found in <a
+href="Rails.html">Rails</a> applications that are either slow or become
+unresponsive after a little while.
+</p>
+<p>
+TODO: Document the optional selections from the what parameter
+</p>
+        </div>
+      </div>
+      <div id="method-M000120" class="method-detail">
+        <a name="M000120"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000120.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000120.html');return false;">
+          <span class="method-name">join</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+This method should actually be called <b>outside</b> of the <a
+href="Configurator.html">Configurator</a> block so that you can control it.
+In otherwords do it like: config.join.
+</p>
+        </div>
+      </div>
+      <div id="method-M000111" class="method-detail">
+        <a name="M000111"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000111.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000111.html');return false;">
+          <span class="method-name">listener</span><span class="method-args">(options={},&amp;blk)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Starts a listener block. This is the only one that actually takes a block
+and then you make <a href="Configurator.html#M000112">Configurator.uri</a>
+calls in order to setup your URIs and handlers. If you write your Handlers
+as GemPlugins then you can use <a
+href="Configurator.html#M000114">load_plugins</a> and plugin to load them.
+</p>
+<p>
+It expects the following options (or defaults):
+</p>
+<ul>
+<li>:host =&gt; Host name to bind.
+</li>
+<li>:port =&gt; Port to bind.
+</li>
+<li>:num_processors =&gt; The maximum number of concurrent threads allowed.
+(950 default)
+</li>
+<li>:timeout =&gt; 1/100th of a second timeout between requests. (10 is 1/10th,
+0 is timeout)
+</li>
+</ul>
+        </div>
+      </div>
+      <div id="method-M000116" class="method-detail">
+        <a name="M000116"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000116.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000116.html');return false;">
+          <span class="method-name">load_mime_map</span><span class="method-args">(file, mime={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Loads the MIME map file and checks that it is correct on loading. This is
+commonly passed to <a href="DirHandler.html">Mongrel::DirHandler</a> or any
+framework handler that uses <a href="DirHandler.html">DirHandler</a> to
+serve files. You can also include a set of default MIME types as additional
+settings. See <a href="DirHandler.html">Mongrel::DirHandler</a> for how the
+MIME types map is organized.
+</p>
+        </div>
+      </div>
+      <div id="method-M000114" class="method-detail">
+        <a name="M000114"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000114.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000114.html');return false;">
+          <span class="method-name">load_plugins</span><span class="method-args">(options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Uses the GemPlugin system to easily load plugins based on their gem
+dependencies. You pass in either an :includes =&gt; [] or :excludes =&gt;
+[] setting listing the names of plugins to include or exclude from the when
+determining the dependencies.
+</p>
+        </div>
+      </div>
+      <div id="method-M000115" class="method-detail">
+        <a name="M000115"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000115.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000115.html');return false;">
+          <span class="method-name">load_yaml</span><span class="method-args">(file, default={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Easy way to load a YAML file and apply default settings.
+</p>
+        </div>
+      </div>
+      <div id="method-M000124" class="method-detail">
+        <a name="M000124"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000124.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000124.html');return false;">
+          <span class="method-name">log</span><span class="method-args">(msg)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Logs a simple message to STDERR (or the mongrel log if in daemon mode).
+</p>
+        </div>
+      </div>
+      <div id="method-M000117" class="method-detail">
+        <a name="M000117"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000117.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000117.html');return false;">
+          <span class="method-name">plugin</span><span class="method-args">(name, options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Loads and creates a plugin for you based on the given name and configured
+with the selected options. The options are merged with the defaults prior
+to passing them in.
+</p>
+        </div>
+      </div>
+      <div id="method-M000110" class="method-detail">
+        <a name="M000110"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000110.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000110.html');return false;">
+          <span class="method-name">resolve_defaults</span><span class="method-args">(options)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+This will resolve the given options against the defaults. Normally just
+used internally.
+</p>
+        </div>
+      </div>
+      <div id="method-M000118" class="method-detail">
+        <a name="M000118"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000118.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000118.html');return false;">
+          <span class="method-name">run</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Works like a meta run method which goes through all the configured
+listeners. Use the <a
+href="Configurator.html#M000120">Configurator.join</a> method to prevent
+Ruby from exiting until each one is done.
+</p>
+        </div>
+      </div>
+      <div id="method-M000122" class="method-detail">
+        <a name="M000122"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000122.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000122.html');return false;">
+          <span class="method-name">run_config</span><span class="method-args">(script)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Used to allow you to let users specify their own configurations inside your
+<a href="Configurator.html">Configurator</a> setup. You pass it a script
+name and it reads it in and does an eval on the contents passing in the
+right binding so they can put their own <a
+href="Configurator.html">Configurator</a> statements.
+</p>
+        </div>
+      </div>
+      <div id="method-M000123" class="method-detail">
+        <a name="M000123"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000123.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000123.html');return false;">
+          <span class="method-name">setup_signals</span><span class="method-args">(options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Sets up the standard signal handlers that are used on most Ruby It only
+configures if the platform is not win32 and doesn&#8217;t do a HUP signal
+since this is typically framework specific.
+</p>
+<p>
+Requires a :pid_file option given to <a
+href="Configurator.html#M000105">Configurator.new</a> to indicate a file to
+delete. It sets the MongrelConfig.needs_restart attribute if the start
+command should reload. It&#8217;s up to you to detect this and do whatever
+is needed for a &quot;restart&quot;.
+</p>
+<p>
+This command is safely ignored if the platform is win32 (with a warning)
+</p>
+        </div>
+      </div>
+      <div id="method-M000119" class="method-detail">
+        <a name="M000119"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000119.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000119.html');return false;">
+          <span class="method-name">stop</span><span class="method-args">(needs_restart=false, unlink_pid_file=true)</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Calls .stop on all the configured listeners so they stop processing
+requests (gracefully). By default it assumes that you don&#8217;t want to
+restart and that the pid file should be unlinked on exit.
+</p>
+        </div>
+      </div>
+      <div id="method-M000112" class="method-detail">
+        <a name="M000112"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000112.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000112.html');return false;">
+          <span class="method-name">uri</span><span class="method-args">(location, options={})</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Called inside a <a
+href="Configurator.html#M000111">Configurator.listener</a> block in order
+to add URI-&gt;handler mappings for that listener. Use this as many times
+as you like. It expects the following options or defaults:
+</p>
+<ul>
+<li>:handler =&gt; <a href="HttpHandler.html">HttpHandler</a> &#8212; Handler
+to use for this location.
+</li>
+<li>:in_front =&gt; true/false &#8212; Rather than appending, it prepends this
+handler.
+</li>
+</ul>
+        </div>
+      </div>
+      <div id="method-M000107" class="method-detail">
+        <a name="M000107"></a>
+        <div class="method-heading">
+          <a href="Configurator.src/M000107.html" target="Code" class="method-signature"
+            onclick="popupCode('Configurator.src/M000107.html');return false;">
+          <span class="method-name">write_pid_file</span><span class="method-args">()</span>
+          </a>
+        </div>
+        <div class="method-description">
+          <p>
+Writes the PID file but only if we&#8217;re on windows.
+</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>