wee 0.4.0 → 0.5.0

data/doc/rdoc/classes/Wee/WEBrickAdaptor.html

@@ -78,31 +78,6 @@
 
   <div id="contextContent">
 
-    <div id="description">
-      <p>
-Example of usage:
-</p>
-<pre>
-  require 'wee/adaptors/webrick'
-  s = WEBrick::HTTPServer.new(:Port =&gt; 2000)
-  s.mount '/app', Wee::WEBrickAdaptor, application
-
-  trap(&quot;INT&quot;) { s.shutdown; exit }
-  s.start
-</pre>
-<p>
-Or when using the convenience methods:
-</p>
-<pre>
-  require 'wee/adaptors/webrick'
-  Wee::WEBrickAdaptor.
-    register('/app' =&gt; application).
-    register('/cnt' =&gt; application2).
-    mount('/', WEBrick::HTTPServlet::FileHandler, '.').
-    start(:Port =&gt; 2000)
-</pre>
-
-    </div>
 
 
    </div>
@@ -111,13 +86,13 @@ Or when using the convenience methods:
       <h3 class="section-bar">Methods</h3>
 
       <div class="name-list">
-      <a href="#M000041">do_GET</a>&nbsp;&nbsp;
-      <a href="#M000042">do_POST</a>&nbsp;&nbsp;
-      <a href="#M000040">handle_request</a>&nbsp;&nbsp;
-      <a href="#M000038">mount</a>&nbsp;&nbsp;
-      <a href="#M000039">new</a>&nbsp;&nbsp;
-      <a href="#M000037">register</a>&nbsp;&nbsp;
-      <a href="#M000036">start</a>&nbsp;&nbsp;
+      <a href="#M000052">do_GET</a>&nbsp;&nbsp;
+      <a href="#M000053">do_POST</a>&nbsp;&nbsp;
+      <a href="#M000051">handle_request</a>&nbsp;&nbsp;
+      <a href="#M000049">mount</a>&nbsp;&nbsp;
+      <a href="#M000050">new</a>&nbsp;&nbsp;
+      <a href="#M000048">register</a>&nbsp;&nbsp;
+      <a href="#M000047">start</a>&nbsp;&nbsp;
       </div>
     </div>
 
@@ -139,11 +114,11 @@ Or when using the convenience methods:
     <div id="methods">
       <h3 class="section-bar">Public Class methods</h3>
 
-      <div id="method-M000038" class="method-detail">
-        <a name="M000038"></a>
+      <div id="method-M000049" class="method-detail">
+        <a name="M000049"></a>
 
         <div class="method-heading">
-          <a href="#M000038" class="method-signature">
+          <a href="#M000049" class="method-signature">
           <span class="method-name">mount</span><span class="method-args">(*args, &amp;block)</span>
           </a>
         </div>
@@ -153,10 +128,10 @@ Or when using the convenience methods:
 Convenience method
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000038-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000038-source">
+            onclick="toggleCode('M000049-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000049-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 53</span>
+<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 55</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">mount</span>(<span class="ruby-operator">*</span><span class="ruby-identifier">args</span>, <span class="ruby-operator">&amp;</span><span class="ruby-identifier">block</span>)
     <span class="ruby-ivar">@mounts</span> <span class="ruby-operator">||=</span> []
     <span class="ruby-ivar">@mounts</span> <span class="ruby-operator">&lt;&lt;</span> [<span class="ruby-identifier">args</span>, <span class="ruby-identifier">block</span>]
@@ -167,21 +142,21 @@ Convenience method
         </div>
       </div>
 
-      <div id="method-M000039" class="method-detail">
-        <a name="M000039"></a>
+      <div id="method-M000050" class="method-detail">
+        <a name="M000050"></a>
 
         <div class="method-heading">
-          <a href="#M000039" class="method-signature">
+          <a href="#M000050" class="method-signature">
           <span class="method-name">new</span><span class="method-args">(server, mount_path, application)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000039-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000039-source">
+            onclick="toggleCode('M000050-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000050-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 59</span>
+<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 61</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">initialize</span>(<span class="ruby-identifier">server</span>, <span class="ruby-identifier">mount_path</span>, <span class="ruby-identifier">application</span>)
     <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">server</span>)
     <span class="ruby-ivar">@mount_path</span> = <span class="ruby-identifier">mount_path</span>
@@ -192,11 +167,11 @@ Convenience method
         </div>
       </div>
 
-      <div id="method-M000037" class="method-detail">
-        <a name="M000037"></a>
+      <div id="method-M000048" class="method-detail">
+        <a name="M000048"></a>
 
         <div class="method-heading">
-          <a href="#M000037" class="method-signature">
+          <a href="#M000048" class="method-signature">
           <span class="method-name">register</span><span class="method-args">(hash)</span>
           </a>
         </div>
@@ -206,10 +181,10 @@ Convenience method
 Convenience method
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000037-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000037-source">
+            onclick="toggleCode('M000048-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000048-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 44</span>
+<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 46</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">register</span>(<span class="ruby-identifier">hash</span>)
     <span class="ruby-ivar">@apps</span> <span class="ruby-operator">||=</span> []
     <span class="ruby-identifier">hash</span>.<span class="ruby-identifier">each</span> <span class="ruby-keyword kw">do</span> <span class="ruby-operator">|</span><span class="ruby-identifier">path</span>, <span class="ruby-identifier">application</span><span class="ruby-operator">|</span>
@@ -222,11 +197,11 @@ Convenience method
         </div>
       </div>
 
-      <div id="method-M000036" class="method-detail">
-        <a name="M000036"></a>
+      <div id="method-M000047" class="method-detail">
+        <a name="M000047"></a>
 
         <div class="method-heading">
-          <a href="#M000036" class="method-signature">
+          <a href="#M000047" class="method-signature">
           <span class="method-name">start</span><span class="method-args">(options={}) {|server if block_given?| ...}</span>
           </a>
         </div>
@@ -236,10 +211,10 @@ Convenience method
 Convenience method
 </p>
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000036-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000036-source">
+            onclick="toggleCode('M000047-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000047-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 25</span>
+<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 27</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-keyword kw">self</span>.<span class="ruby-identifier">start</span>(<span class="ruby-identifier">options</span>={})
     <span class="ruby-identifier">server</span> = <span class="ruby-constant">WEBrick</span><span class="ruby-operator">::</span><span class="ruby-constant">HTTPServer</span>.<span class="ruby-identifier">new</span>({<span class="ruby-identifier">:Port</span> =<span class="ruby-operator">&gt;</span> <span class="ruby-value">2000</span>}.<span class="ruby-identifier">update</span>(<span class="ruby-identifier">options</span>))
     <span class="ruby-identifier">trap</span>(<span class="ruby-value str">&quot;INT&quot;</span>) { <span class="ruby-identifier">server</span>.<span class="ruby-identifier">shutdown</span> }
@@ -264,8 +239,8 @@ Convenience method
 
       <h3 class="section-bar">Public Instance methods</h3>
 
-      <div id="method-M000041" class="method-detail">
-        <a name="M000041"></a>
+      <div id="method-M000052" class="method-detail">
+        <a name="M000052"></a>
 
         <div class="method-heading">
           <span class="method-name">do_GET</span><span class="method-args">(req, res)</span>
@@ -273,13 +248,13 @@ Convenience method
       
         <div class="method-description">
           <p>
-Alias for <a href="WEBrickAdaptor.html#M000040">handle_request</a>
+Alias for <a href="WEBrickAdaptor.html#M000051">handle_request</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000042" class="method-detail">
-        <a name="M000042"></a>
+      <div id="method-M000053" class="method-detail">
+        <a name="M000053"></a>
 
         <div class="method-heading">
           <span class="method-name">do_POST</span><span class="method-args">(req, res)</span>
@@ -287,26 +262,26 @@ Alias for <a href="WEBrickAdaptor.html#M000040">handle_request</a>
       
         <div class="method-description">
           <p>
-Alias for <a href="WEBrickAdaptor.html#M000040">handle_request</a>
+Alias for <a href="WEBrickAdaptor.html#M000051">handle_request</a>
 </p>
         </div>
       </div>
 
-      <div id="method-M000040" class="method-detail">
-        <a name="M000040"></a>
+      <div id="method-M000051" class="method-detail">
+        <a name="M000051"></a>
 
         <div class="method-heading">
-          <a href="#M000040" class="method-signature">
+          <a href="#M000051" class="method-signature">
           <span class="method-name">handle_request</span><span class="method-args">(req, res)</span>
           </a>
         </div>
       
         <div class="method-description">
           <p><a class="source-toggle" href="#"
-            onclick="toggleCode('M000040-source');return false;">[Source]</a></p>
-          <div class="method-source-code" id="M000040-source">
+            onclick="toggleCode('M000051-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000051-source">
 <pre>
-<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 65</span>
+<span class="ruby-comment cmt"># File lib/wee/adaptors/webrick.rb, line 67</span>
   <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">handle_request</span>(<span class="ruby-identifier">req</span>, <span class="ruby-identifier">res</span>)
     <span class="ruby-identifier">context</span> = <span class="ruby-constant">Wee</span><span class="ruby-operator">::</span><span class="ruby-constant">Context</span>.<span class="ruby-identifier">new</span>(<span class="ruby-constant">Wee</span><span class="ruby-operator">::</span><span class="ruby-constant">Request</span>.<span class="ruby-identifier">new</span>(<span class="ruby-ivar">@mount_path</span>, <span class="ruby-identifier">req</span>.<span class="ruby-identifier">path</span>, <span class="ruby-identifier">req</span>.<span class="ruby-identifier">header</span>, <span class="ruby-identifier">req</span>.<span class="ruby-identifier">query</span>))
     <span class="ruby-ivar">@application</span>.<span class="ruby-identifier">handle_request</span>(<span class="ruby-identifier">context</span>)

data/doc/rdoc/classes/Wee/WrapperDecoration.html

@@ -0,0 +1,150 @@
+<?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: Wee::WrapperDecoration</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">Wee::WrapperDecoration</td>
+        </tr>
+        <tr class="top-aligned-row">
+            <td><strong>In:</strong></td>
+            <td>
+                <a href="../../files/lib/wee/components/wrapper_decoration_rb.html">
+                lib/wee/components/wrapper_decoration.rb
+                </a>
+        <br />
+            </td>
+        </tr>
+
+        <tr class="top-aligned-row">
+            <td><strong>Parent:</strong></td>
+            <td>
+                <a href="Decoration.html">
+                Wee::Decoration
+               </a>
+            </td>
+        </tr>
+        </table>
+    </div>
+  <!-- banner header -->
+
+  <div id="bodyContent">
+
+
+
+  <div id="contextContent">
+
+
+
+   </div>
+
+    <div id="method-list">
+      <h3 class="section-bar">Methods</h3>
+
+      <div class="name-list">
+      <a href="#M000056">do_render</a>&nbsp;&nbsp;
+      </div>
+    </div>
+
+  </div>
+
+
+    <!-- if includes -->
+
+    <div id="section">
+
+
+
+
+
+      
+
+
+    <!-- if method_list -->
+    <div id="methods">
+      <h3 class="section-bar">Public Instance methods</h3>
+
+      <div id="method-M000056" class="method-detail">
+        <a name="M000056"></a>
+
+        <div class="method-heading">
+          <a href="#M000056" class="method-signature">
+          <span class="method-name">do_render</span><span class="method-args">(rendering_context)</span>
+          </a>
+        </div>
+      
+        <div class="method-description">
+          <p><a class="source-toggle" href="#"
+            onclick="toggleCode('M000056-source');return false;">[Source]</a></p>
+          <div class="method-source-code" id="M000056-source">
+<pre>
+<span class="ruby-comment cmt"># File lib/wee/components/wrapper_decoration.rb, line 2</span>
+  <span class="ruby-keyword kw">def</span> <span class="ruby-identifier">do_render</span>(<span class="ruby-identifier">rendering_context</span>)
+    <span class="ruby-identifier">with_renderer_for</span>(<span class="ruby-identifier">rendering_context</span>) <span class="ruby-keyword kw">do</span>
+      <span class="ruby-identifier">render_wrapper</span> { <span class="ruby-keyword kw">super</span>(<span class="ruby-identifier">rendering_context</span>) }
+    <span class="ruby-keyword kw">end</span>
+  <span class="ruby-keyword kw">end</span>
+</pre>
+          </div>
+        </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>

data/doc/rdoc/created.rid

@@ -1 +1 @@
-Wed Jan 12 16:54:33 CET 2005
+Wed Jan 26 22:18:42 CET 2005

data/doc/rdoc/files/README.html

@@ -56,7 +56,7 @@
     </tr>
     <tr class="top-aligned-row">
       <td><strong>Last Update:</strong></td>
-      <td>Wed Jan 12 16:49:13 CET 2005</td>
+      <td>Wed Jan 26 20:20:05 CET 2005</td>
     </tr>
     </table>
   </div>
@@ -81,17 +81,23 @@ licensed under different terms.
 </p>
 <h2>Status and Bugs</h2>
 <p>
-<a href="../classes/Wee.html">Wee</a> is not considered production ready!
-It should only be used for small things.
+<a href="../classes/Wee.html">Wee</a> is now considered pretty stable (if
+you don&#8217;t use continuations). Nevertheless I wouldn&#8217;t use it
+yet for mission-critical applications ;-)
 </p>
 <p>
 Known Bugs:
 </p>
 <ul>
-<li>Continuations leak memory!
+<li>Using continuations might leak memory, at least they did in the past. The
 
 </li>
 </ul>
+<p>
+latest memory stress-test has not showed up any memory problems, but since
+I haven&#8217;t changed anything at the continuation implementation, I
+can&#8217;t say for sure whether the problem has been fixed or not.
+</p>
 <h2>Introduction</h2>
 <p>
 <a href="../classes/Wee.html">Wee</a> is a light-weight, very high-level
@@ -163,12 +169,13 @@ array. Items can be any object, e.g. whole components:
    items = labels.collect {|m| MessageBox.new(m)}
    r.select_list(items).labels(labels).callback {|choosen| call choosen.first}
 </pre>
-<h3>Continuation based (Optional)</h3>
+<h3>Optional use of Continuations</h3>
 <p>
 <b>IMPORTANT:</b> <em>The current implementation of continuations in Ruby
-might lead to memory leaks, if you use continuations. Furthermore, if you
-use continuations, it&#8217;s no longer possible to store the session state
-to disk.</em>
+(or their use in <a href="../classes/Wee.html">Wee</a>) might lead to
+memory leaks, if you use continuations. Furthermore, if you use
+continuations, it&#8217;s no longer possible to store the session state to
+disk.</em>
 </p>
 <p>
 Continuation-based frameworks are also known as <em>modal</em> frameworks.
@@ -191,6 +198,12 @@ emails) where each method displays a new page:
 Try to implement the same in a non-continuation based framework and show me
 your code&#8230; ;-)
 </p>
+<p>
+To enable continuations, you have to require:
+</p>
+<pre>
+  require 'wee/continuation'
+</pre>
 <h3>Fully Marshallable (drops Continuation support)</h3>
 <p>
 If you don&#8217;t need continuations, <a
@@ -210,8 +223,9 @@ href="http://www.dragonflybsd.org">DragonFly</a>. But with this approach
 it&#8217;s still impossible to store sessions <em>selectively</em> to disk.
 
 </li>
-<li>Each session runs in it&#8217;s own (light-weigth) thread (this is a
-neccessity when using continuations).
+<li>When using continuations, each session runs in it&#8217;s own
+(light-weigth) thread. This is not the case if you don&#8217;t use
+continuations.
 
 </li>
 <li>Only one action callback can be invoked per request (a former version of <a
@@ -254,7 +268,7 @@ Decorations are used to modify the look and behaviour of a component,
 without modifying the components tree. A component can have more than one
 decoration. This is implemented as a linked list of decorations
 (Wee::Decoration#owner points to the next decoration). <a
-href="../classes/Wee/Component.html#M000179">Wee::Component#decoration</a>
+href="../classes/Wee/Component.html#M000215">Wee::Component#decoration</a>
 points to the first decoration in the chain or to the component itself, if
 no decorations were specified. We actually use a <a
 href="../classes/Wee/ValueHolder.html">Wee::ValueHolder</a> for the
@@ -347,11 +361,11 @@ There are two methods related to callback processing:
 </p>
 <ul>
 <li><a
-href="../classes/Wee/Component.html#M000174">Wee::Component#process_callbacks_chain</a>
+href="../classes/Wee/Component.html#M000210">Wee::Component#process_callbacks_chain</a>
 
 </li>
 <li><a
-href="../classes/Wee/Presenter.html#M000196">Wee::Presenter#process_callbacks</a>
+href="../classes/Wee/Presenter.html#M000234">Wee::Presenter#process_callbacks</a>
 
 </li>
 </ul>
@@ -388,11 +402,11 @@ a page:
 </p>
 <ul>
 <li><a
-href="../classes/Wee/Component.html#M000172">Wee::Component#do_render_chain</a>
+href="../classes/Wee/Component.html#M000208">Wee::Component#do_render_chain</a>
 
 </li>
 <li><a
-href="../classes/Wee/Presenter.html#M000191">Wee::Presenter#do_render</a>
+href="../classes/Wee/Presenter.html#M000229">Wee::Presenter#do_render</a>
 
 </li>
 </ul>