safubot 0.0.3 → 0.0.4

data/doc/Safubot/Bot.html

@@ -293,7 +293,7 @@ Performs appropriate dispatch operation for response type.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#enable_twitter-instance_method" title="#enable_twitter (instance method)">- (Object) <strong>enable_twitter</strong>(opts = {}) </a>
+      <a href="#dispatch_error-instance_method" title="#dispatch_error (instance method)">- (Object) <strong>dispatch_error</strong>(resp, e) </a>
     
 
     
@@ -307,7 +307,8 @@ Performs appropriate dispatch operation for response type.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Initialises Twitter-related functionality.
+Records an error in dispatch and emits a corresponding :dispatch_error
+event.
 </p>
 </div></span>
   
@@ -317,7 +318,7 @@ Initialises Twitter-related functionality.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#enable_xmpp-instance_method" title="#enable_xmpp (instance method)">- (Object) <strong>enable_xmpp</strong>(options = {}) </a>
+      <a href="#enable_twitter-instance_method" title="#enable_twitter (instance method)">- (Object) <strong>enable_twitter</strong>(opts = {}) </a>
     
 
     
@@ -331,7 +332,7 @@ Initialises Twitter-related functionality.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Initialises XMPP-related functionality.
+Initialises Twitter-related functionality.
 </p>
 </div></span>
   
@@ -341,14 +342,12 @@ Initialises XMPP-related functionality.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Bot) <strong>initialize</strong>(options = {}) </a>
+      <a href="#enable_xmpp-instance_method" title="#enable_xmpp (instance method)">- (Object) <strong>enable_xmpp</strong>(options = {}) </a>
     
 
     
   </span>
   
-    <span class="note title constructor">constructor</span>
-  
   
   
   
@@ -357,7 +356,7 @@ Initialises XMPP-related functionality.
 
   
     <span class="summary_desc"><div class='inline'><p>
-A new instance of Bot.
+Initialises XMPP-related functionality.
 </p>
 </div></span>
   
@@ -367,12 +366,14 @@ A new instance of Bot.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#process-instance_method" title="#process (instance method)">- (Object) <strong>process</strong> </a>
+      <a href="#initialize-instance_method" title="#initialize (instance method)">- (Bot) <strong>initialize</strong>(options = {}) </a>
     
 
     
   </span>
   
+    <span class="note title constructor">constructor</span>
+  
   
   
   
@@ -381,7 +382,7 @@ A new instance of Bot.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Goes through each unprocessed Request and submits it for processing.
+A new instance of Bot.
 </p>
 </div></span>
   
@@ -391,7 +392,7 @@ Goes through each unprocessed Request and submits it for processing.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#process_request-instance_method" title="#process_request (instance method)">- (Object) <strong>process_request</strong>(req) </a>
+      <a href="#process-instance_method" title="#process (instance method)">- (Object) <strong>process</strong> </a>
     
 
     
@@ -405,7 +406,7 @@ Goes through each unprocessed Request and submits it for processing.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Processes an individual request (synchronously).
+Goes through each unprocessed Request and submits it for processing.
 </p>
 </div></span>
   
@@ -415,7 +416,7 @@ Processes an individual request (synchronously).
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#pull-instance_method" title="#pull (instance method)">- (Object) <strong>pull</strong> </a>
+      <a href="#process_request-instance_method" title="#process_request (instance method)">- (Object) <strong>process_request</strong>(req) </a>
     
 
     
@@ -429,8 +430,7 @@ Processes an individual request (synchronously).
 
   
     <span class="summary_desc"><div class='inline'><p>
-This pulls requests from passive non-streaming sources (currently, the
-Twitter AJAX API).
+Processes an individual request (synchronously).
 </p>
 </div></span>
   
@@ -440,7 +440,7 @@ Twitter AJAX API).
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#push-instance_method" title="#push (instance method)">- (Object) <strong>push</strong> </a>
+      <a href="#pull-instance_method" title="#pull (instance method)">- (Object) <strong>pull</strong> </a>
     
 
     
@@ -454,7 +454,8 @@ Twitter AJAX API).
 
   
     <span class="summary_desc"><div class='inline'><p>
-Dispatches all undispatched Responses.
+This pulls requests from passive non-streaming sources (currently, the
+Twitter AJAX API).
 </p>
 </div></span>
   
@@ -464,7 +465,7 @@ Dispatches all undispatched Responses.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#request_error-instance_method" title="#request_error (instance method)">- (Object) <strong>request_error</strong>(req, e) </a>
+      <a href="#push-instance_method" title="#push (instance method)">- (Object) <strong>push</strong> </a>
     
 
     
@@ -478,7 +479,7 @@ Dispatches all undispatched Responses.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Records an error and emits a corresponding :request_error event.
+Dispatches all undispatched Responses.
 </p>
 </div></span>
   
@@ -488,7 +489,7 @@ Records an error and emits a corresponding :request_error event.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#respond-instance_method" title="#respond (instance method)">- (Object) <strong>respond</strong>(req, text) </a>
+      <a href="#request_error-instance_method" title="#request_error (instance method)">- (Object) <strong>request_error</strong>(req, e) </a>
     
 
     
@@ -502,7 +503,8 @@ Records an error and emits a corresponding :request_error event.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Adds a response to the queue.
+Records an error in processing and emits a corresponding :request_error
+event.
 </p>
 </div></span>
   
@@ -512,7 +514,7 @@ Adds a response to the queue.
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#respond_now-instance_method" title="#respond_now (instance method)">- (Object) <strong>respond_now</strong>(req, text) </a>
+      <a href="#respond-instance_method" title="#respond (instance method)">- (Object) <strong>respond</strong>(req, text) </a>
     
 
     
@@ -526,7 +528,7 @@ Adds a response to the queue.
 
   
     <span class="summary_desc"><div class='inline'><p>
-Respond + push.
+Adds a response to the queue and dispatches it.
 </p>
 </div></span>
   
@@ -647,16 +649,16 @@ A new instance of Bot
       <pre class="lines">
 
 
-190
-191
-192
-193
-194
-195
-196</pre>
+264
+265
+266
+267
+268
+269
+270</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 190</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 264</span>
 
 <span class='kw'>def</span> <span class='id initialize'>initialize</span><span class='lparen'>(</span><span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id defaults'>defaults</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='symbol'>:database</span> <span class='op'>=&gt;</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>safubot</span><span class='tstring_end'>&quot;</span></span> <span class='rbrace'>}</span>
@@ -703,12 +705,12 @@ Returns the value of attribute opts
       <pre class="lines">
 
 
-47
-48
-49</pre>
+81
+82
+83</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 81</span>
 
 <span class='kw'>def</span> <span class='id opts'>opts</span>
   <span class='ivar'>@opts</span>
@@ -746,12 +748,12 @@ Returns the value of attribute twitter
       <pre class="lines">
 
 
-47
-48
-49</pre>
+81
+82
+83</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 81</span>
 
 <span class='kw'>def</span> <span class='id twitter'>twitter</span>
   <span class='ivar'>@twitter</span>
@@ -789,12 +791,12 @@ Returns the value of attribute xmpp
       <pre class="lines">
 
 
-47
-48
-49</pre>
+81
+82
+83</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 47</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 81</span>
 
 <span class='kw'>def</span> <span class='id xmpp'>xmpp</span>
   <span class='ivar'>@xmpp</span>
@@ -877,16 +879,16 @@ KnownUser.by_name(&#8216;testing&#8217;)
       <pre class="lines">
 
 
-61
-62
-63
-64
 65
 66
-67</pre>
+67
+68
+69
+70
+71</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/test_helper.rb', line 61</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/test_helper.rb', line 65</span>
 
 <span class='kw'>def</span> <span class='id answer'>answer</span><span class='lparen'>(</span><span class='id text'>text</span><span class='comma'>,</span> <span class='id user'>user</span><span class='op'>=</span><span class='kw'>nil</span><span class='rparen'>)</span>
   <span class='id user'>user</span> <span class='op'>||=</span> <span class='const'>KnownUser</span><span class='period'>.</span><span class='id by_name'>by_name</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>'</span><span class='tstring_content'>testing</span><span class='tstring_end'>'</span></span><span class='rparen'>)</span>
@@ -964,20 +966,19 @@ The operation to be performed in a separate thread.
       <pre class="lines">
 
 
-138
-139
-140
-141
-142
-143
-144
-145
-146
-147
-148</pre>
+211
+212
+213
+214
+215
+216
+217
+218
+219
+220</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 138</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 211</span>
 
 <span class='kw'>def</span> <span class='id concurrently'>concurrently</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id blk'>blk</span><span class='rparen'>)</span>
   <span class='const'>Thread</span><span class='period'>.</span><span class='id new'>new</span> <span class='kw'>do</span>
@@ -986,7 +987,6 @@ The operation to be performed in a separate thread.
 	<span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id e'>e</span>
 	  <span class='id request_error'>request_error</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
 	<span class='kw'>end</span>
-
 	<span class='id push'>push</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
@@ -1041,37 +1041,73 @@ An undispatched Response.
       <pre class="lines">
 
 
-77
-78
-79
-80
-81
-82
-83
-84
-85
-86
-87
-88
-89
-90
-91
-92
-93
-94
-95
-96
-97
-98
-99
-100</pre>
+138
+139
+140
+141
+142
+143
+144
+145
+146
+147
+148
+149
+150
+151
+152
+153
+154
+155
+156
+157
+158
+159
+160
+161
+162
+163
+164
+165
+166
+167
+168
+169
+170
+171
+172
+173
+174
+175
+176
+177
+178
+179</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 77</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 138</span>
 
 <span class='kw'>def</span> <span class='id dispatch'>dispatch</span><span class='lparen'>(</span><span class='id resp'>resp</span><span class='rparen'>)</span>
+  <span class='id resp'>resp</span><span class='period'>.</span><span class='id reload'>reload</span>
+  <span class='kw'>if</span> <span class='id resp'>resp</span><span class='period'>.</span><span class='id dispatched'>dispatched</span>
+	<span class='const'>Log</span><span class='period'>.</span><span class='id debug'>debug</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Response '</span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>' has already been dispatched, ignoring.</span><span class='tstring_end'>&quot;</span></span>
+	<span class='kw'>return</span>
+  <span class='kw'>elsif</span> <span class='id resp'>resp</span><span class='period'>.</span><span class='id dispatching'>dispatching</span>
+	<span class='const'>Log</span><span class='period'>.</span><span class='id debug'>debug</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Response '</span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>' is already in dispatch, ignoring.</span><span class='tstring_end'>&quot;</span></span>
+	<span class='kw'>return</span>
+  <span class='kw'>elsif</span> <span class='id resp'>resp</span><span class='period'>.</span><span class='id problems'>problems</span><span class='period'>.</span><span class='id length'>length</span> <span class='op'>&gt;</span> <span class='int'>10</span>
+	<span class='const'>Log</span><span class='period'>.</span><span class='id debug'>debug</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Response '</span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>' encountered more than ten dispatch errors, ignoring.</span><span class='tstring_end'>&quot;</span></span>
+	<span class='kw'>return</span>
+  <span class='kw'>elsif</span> <span class='op'>!</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id problems'>problems</span><span class='period'>.</span><span class='id empty?'>empty?</span> <span class='op'>&amp;&amp;</span> <span class='lparen'>(</span><span class='const'>Time</span><span class='period'>.</span><span class='id now'>now</span> <span class='op'>-</span> <span class='id resp'>resp</span><span class='period'>.</span><span class='id last_problem'>last_problem</span><span class='period'>.</span><span class='id when'>when</span><span class='rparen'>)</span> <span class='op'>&lt;</span> <span class='int'>1</span><span class='period'>.</span><span class='id minute'>minute</span>
+	<span class='const'>Log</span><span class='period'>.</span><span class='id debug'>debug</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Response '</span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>' encountered a dispatch error &lt;1 minute ago, ignoring.</span><span class='tstring_end'>&quot;</span></span>
+	<span class='kw'>return</span>
+  <span class='kw'>end</span>
+
   <span class='kw'>begin</span>
 	<span class='id source'>source</span> <span class='op'>=</span> <span class='id resp'>resp</span><span class='period'>.</span><span class='id request'>request</span><span class='period'>.</span><span class='id source'>source</span>
+	<span class='id resp'>resp</span><span class='period'>.</span><span class='id dispatching'>dispatching</span> <span class='op'>=</span> <span class='kw'>true</span>
+	<span class='id resp'>resp</span><span class='period'>.</span><span class='id save'>save</span>
+
 	<span class='kw'>if</span> <span class='const'>Safubot</span><span class='op'>::</span><span class='id mode'>mode</span> <span class='op'>!=</span> <span class='symbol'>:production</span>
 	  <span class='const'>Log</span><span class='period'>.</span><span class='id info'>info</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id source'>source</span><span class='period'>.</span><span class='id class'>class</span><span class='rbrace'>}</span><span class='tstring_content'> Response to </span><span class='embexpr_beg'>#{</span><span class='id source'>source</span><span class='period'>.</span><span class='id username'>username</span><span class='rbrace'>}</span><span class='tstring_content'>: </span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
 	<span class='kw'>else</span>
@@ -1082,20 +1118,105 @@ An undispatched Response.
 	  <span class='kw'>else</span>
 		<span class='id raise'>raise</span> <span class='const'>NotImplementedError</span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Don't know how to send response to a </span><span class='embexpr_beg'>#{</span><span class='id source'>source</span><span class='period'>.</span><span class='id class'>class</span><span class='rbrace'>}</span><span class='tstring_content'>!</span><span class='tstring_end'>&quot;</span></span>
 	  <span class='kw'>end</span>
-	<span class='kw'>end</span>
 
-	<span class='id resp'>resp</span><span class='period'>.</span><span class='id dispatched'>dispatched</span> <span class='op'>=</span> <span class='kw'>true</span>
-	<span class='id resp'>resp</span><span class='period'>.</span><span class='id save'>save</span>
+	  <span class='id resp'>resp</span><span class='period'>.</span><span class='id dispatched'>dispatched</span> <span class='op'>=</span> <span class='kw'>true</span>
+	  <span class='id resp'>resp</span><span class='period'>.</span><span class='id save'>save</span>
+	<span class='kw'>end</span>
   <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id e'>e</span>
-	<span class='const'>Log</span><span class='period'>.</span><span class='id error'>error</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Error dispatching </span><span class='embexpr_beg'>#{</span><span class='id source'>source</span><span class='period'>.</span><span class='id class'>class</span><span class='rbrace'>}</span><span class='tstring_content'> '</span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>': </span><span class='embexpr_beg'>#{</span><span class='id e'>e</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
-	<span class='id resp'>resp</span><span class='period'>.</span><span class='id errors'>errors</span><span class='lbracket'>[</span><span class='const'>Time</span><span class='period'>.</span><span class='id now'>now</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id e'>e</span>
+	<span class='id dispatch_error'>dispatch_error</span><span class='lparen'>(</span><span class='id resp'>resp</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
+  <span class='kw'>ensure</span>
+	<span class='id resp'>resp</span><span class='period'>.</span><span class='id dispatching'>dispatching</span> <span class='op'>=</span> <span class='kw'>false</span>
 	<span class='id resp'>resp</span><span class='period'>.</span><span class='id save'>save</span>
-	<span class='id emit'>emit</span><span class='lparen'>(</span><span class='symbol'>:dispatch_error</span><span class='comma'>,</span> <span class='id resp'>resp</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <p class="signature " id="dispatch_error-instance_method">
+  
+    - (<tt>Object</tt>) <strong>dispatch_error</strong>(resp, e) 
+  
+
+  
+</p><div class="docstring">
+  <div class="discussion">
+    <p>
+Records an error in dispatch and emits a corresponding :dispatch_error
+event.
+</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  <h3>Parameters:</h3>
+<ul class="param">
+  
+    <li>
+      
+        <span class='name'>resp</span>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>
+The Response for which the error was encountered.
+</p>
+</div>
+      
+    </li>
+  
+    <li>
+      
+        <span class='name'>e</span>
+      
+      
+        <span class='type'></span>
+      
+      
+      
+        &mdash;
+        <div class='inline'><p>
+The caught Exception.
+</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+98
+99
+100
+101
+102
+103</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 98</span>
+
+<span class='kw'>def</span> <span class='id dispatch_error'>dispatch_error</span><span class='lparen'>(</span><span class='id resp'>resp</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
+  <span class='const'>Log</span><span class='period'>.</span><span class='id error'>error</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Error dispatching </span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id request'>request</span><span class='period'>.</span><span class='id source'>source</span><span class='period'>.</span><span class='id class'>class</span><span class='rbrace'>}</span><span class='tstring_content'> '</span><span class='embexpr_beg'>#{</span><span class='id resp'>resp</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>': </span><span class='embexpr_beg'>#{</span><span class='id error_report'>error_report</span><span class='lparen'>(</span><span class='id e'>e</span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id resp'>resp</span><span class='period'>.</span><span class='id add_problem'>add_problem</span><span class='lparen'>(</span><span class='id e'>e</span><span class='rparen'>)</span>
+  <span class='id resp'>resp</span><span class='period'>.</span><span class='id save'>save</span>
+  <span class='id emit'>emit</span><span class='lparen'>(</span><span class='symbol'>:dispatch_error</span><span class='comma'>,</span> <span class='id resp'>resp</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1123,20 +1244,22 @@ Initialises Twitter-related functionality.
       <pre class="lines">
 
 
-174
-175
-176
-177
-178
-179</pre>
+246
+247
+248
+249
+250
+251
+252</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 174</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 246</span>
 
 <span class='kw'>def</span> <span class='id enable_twitter'>enable_twitter</span><span class='lparen'>(</span><span class='id opts'>opts</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='ivar'>@twitter</span> <span class='op'>=</span> <span class='const'>Twitter</span><span class='op'>::</span><span class='const'>Bot</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id opts'>opts</span><span class='rparen'>)</span>
   <span class='ivar'>@twitter</span><span class='period'>.</span><span class='id on'>on</span><span class='lparen'>(</span><span class='symbol'>:request</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id req'>req</span><span class='op'>|</span>
-	<span class='id process'>process</span><span class='semicolon'>;</span> <span class='id push'>push</span>
+	<span class='id process_request'>process_request</span><span class='lparen'>(</span><span class='id req'>req</span><span class='rparen'>)</span>
+	<span class='id req'>req</span><span class='period'>.</span><span class='id responses'>responses</span><span class='period'>.</span><span class='id where'>where</span><span class='lparen'>(</span><span class='symbol'>:dispatched</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rparen'>)</span><span class='period'>.</span><span class='id map'>map</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:dispatch</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -1169,22 +1292,24 @@ Initialises XMPP-related functionality.
       <pre class="lines">
 
 
-182
-183
-184
-185
-186
-187
-188</pre>
+255
+256
+257
+258
+259
+260
+261
+262</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 182</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 255</span>
 
 <span class='kw'>def</span> <span class='id enable_xmpp'>enable_xmpp</span><span class='lparen'>(</span><span class='id options'>options</span><span class='op'>=</span><span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id defaults'>defaults</span> <span class='op'>=</span> <span class='lbrace'>{</span> <span class='symbol'>:jid</span> <span class='op'>=&gt;</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='symbol'>:password</span> <span class='op'>=&gt;</span> <span class='kw'>nil</span> <span class='rbrace'>}</span>
   <span class='ivar'>@xmpp</span> <span class='op'>=</span> <span class='const'>XMPP</span><span class='op'>::</span><span class='const'>Bot</span><span class='period'>.</span><span class='id new'>new</span><span class='lparen'>(</span><span class='id defaults'>defaults</span><span class='period'>.</span><span class='id merge'>merge</span><span class='lparen'>(</span><span class='id options'>options</span><span class='rparen'>)</span><span class='rparen'>)</span>
   <span class='ivar'>@xmpp</span><span class='period'>.</span><span class='id on'>on</span><span class='lparen'>(</span><span class='symbol'>:request</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id req'>req</span><span class='op'>|</span>
-	<span class='id process'>process</span><span class='semicolon'>;</span> <span class='id push'>push</span>
+	<span class='id process_request'>process_request</span><span class='lparen'>(</span><span class='id req'>req</span><span class='rparen'>)</span>
+	<span class='id req'>req</span><span class='period'>.</span><span class='id responses'>responses</span><span class='period'>.</span><span class='id where'>where</span><span class='lparen'>(</span><span class='symbol'>:dispatched</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rparen'>)</span><span class='period'>.</span><span class='id map'>map</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='symbol'>:dispatch</span><span class='rparen'>)</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
@@ -1217,14 +1342,14 @@ Goes through each unprocessed Request and submits it for processing.
       <pre class="lines">
 
 
-108
-109
-110
-111
-112</pre>
+187
+188
+189
+190
+191</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 108</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 187</span>
 
 <span class='kw'>def</span> <span class='id process'>process</span>
   <span class='const'>Request</span><span class='period'>.</span><span class='id where'>where</span><span class='lparen'>(</span><span class='symbol'>:processed</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rparen'>)</span><span class='period'>.</span><span class='id each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id req'>req</span><span class='op'>|</span>
@@ -1282,29 +1407,61 @@ An unprocessed Request.
       <pre class="lines">
 
 
-63
-64
-65
-66
-67
-68
-69
-70
-71
-72</pre>
+108
+109
+110
+111
+112
+113
+114
+115
+116
+117
+118
+119
+120
+121
+122
+123
+124
+125
+126
+127
+128
+129
+130
+131
+132
+133</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 63</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 108</span>
 
 <span class='kw'>def</span> <span class='id process_request'>process_request</span><span class='lparen'>(</span><span class='id req'>req</span><span class='rparen'>)</span>
+  <span class='id req'>req</span><span class='period'>.</span><span class='id reload'>reload</span>
+  <span class='kw'>if</span> <span class='id req'>req</span><span class='period'>.</span><span class='id processed'>processed</span>
+	<span class='const'>Log</span><span class='period'>.</span><span class='id debug'>debug</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Request '</span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>' has already been processed, ignoring.</span><span class='tstring_end'>&quot;</span></span>
+	<span class='kw'>return</span>
+  <span class='kw'>elsif</span> <span class='id req'>req</span><span class='period'>.</span><span class='id processing'>processing</span>
+	<span class='const'>Log</span><span class='period'>.</span><span class='id debug'>debug</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Request '</span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>' is currently in processing, ignoring.</span><span class='tstring_end'>&quot;</span></span>
+	<span class='kw'>return</span>
+  <span class='kw'>end</span>
+
   <span class='kw'>begin</span>
+	<span class='id req'>req</span><span class='period'>.</span><span class='id processing'>processing</span> <span class='op'>=</span> <span class='kw'>true</span>
+	<span class='id req'>req</span><span class='period'>.</span><span class='id save'>save</span>
 	<span class='id emit'>emit</span><span class='lparen'>(</span><span class='symbol'>:request</span><span class='comma'>,</span> <span class='id req'>req</span><span class='rparen'>)</span>
   <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id e'>e</span>
 	<span class='id request_error'>request_error</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
+  <span class='kw'>else</span>
+	<span class='id req'>req</span><span class='period'>.</span><span class='id success'>success</span> <span class='op'>=</span> <span class='kw'>true</span>
   <span class='kw'>ensure</span>
-	<span class='id req'>req</span><span class='period'>.</span><span class='id processed'>processed</span> <span class='op'>=</span> <span class='kw'>true</span>
-	<span class='id req'>req</span><span class='period'>.</span><span class='id save'>save</span>
-  <span class='kw'>end</span>
+	<span class='comment'>#if Safubot::mode == :production
+</span>	  <span class='id req'>req</span><span class='period'>.</span><span class='id processing'>processing</span> <span class='op'>=</span> <span class='kw'>false</span>
+	  <span class='id req'>req</span><span class='period'>.</span><span class='id processed'>processed</span> <span class='op'>=</span> <span class='kw'>true</span>
+	  <span class='id req'>req</span><span class='period'>.</span><span class='id save'>save</span>
+	<span class='comment'>#end
+</span>  <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1337,12 +1494,12 @@ Twitter AJAX API).
       <pre class="lines">
 
 
-103
-104
-105</pre>
+182
+183
+184</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 103</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 182</span>
 
 <span class='kw'>def</span> <span class='id pull'>pull</span>
   <span class='ivar'>@twitter</span><span class='period'>.</span><span class='id pull'>pull</span>
@@ -1377,12 +1534,12 @@ Dispatches all undispatched Responses.
       <pre class="lines">
 
 
-130
-131
-132</pre>
+203
+204
+205</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 130</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 203</span>
 
 <span class='kw'>def</span> <span class='id push'>push</span>
   <span class='const'>Response</span><span class='period'>.</span><span class='id where'>where</span><span class='lparen'>(</span><span class='symbol'>:dispatched</span> <span class='op'>=&gt;</span> <span class='kw'>false</span><span class='rparen'>)</span><span class='period'>.</span><span class='id each'>each</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id method'>method</span><span class='lparen'>(</span><span class='symbol'>:dispatch</span><span class='rparen'>)</span><span class='rparen'>)</span>
@@ -1402,7 +1559,8 @@ Dispatches all undispatched Responses.
 </p><div class="docstring">
   <div class="discussion">
     <p>
-Records an error and emits a corresponding :request_error event.
+Records an error in processing and emits a corresponding :request_error
+event.
 </p>
 
 
@@ -1455,19 +1613,19 @@ The caught Exception.
       <pre class="lines">
 
 
-53
-54
-55
-56
-57
-58</pre>
+87
+88
+89
+90
+91
+92</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 53</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 87</span>
 
 <span class='kw'>def</span> <span class='id request_error'>request_error</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
-  <span class='const'>Log</span><span class='period'>.</span><span class='id error'>error</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Error processing </span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id source'>source</span><span class='period'>.</span><span class='id class'>class</span><span class='rbrace'>}</span><span class='tstring_content'> '</span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>': </span><span class='embexpr_beg'>#{</span><span class='id e'>e</span><span class='rbrace'>}</span><span class='tstring_content'>\n</span><span class='embexpr_beg'>#{</span><span class='id e'>e</span><span class='period'>.</span><span class='id backtrace'>backtrace</span><span class='period'>.</span><span class='id join'>join</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>\n\t</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
-  <span class='id req'>req</span><span class='period'>.</span><span class='id errors'>errors</span><span class='lbracket'>[</span><span class='const'>Time</span><span class='period'>.</span><span class='id now'>now</span><span class='rbracket'>]</span> <span class='op'>=</span> <span class='id e'>e</span>
+  <span class='const'>Log</span><span class='period'>.</span><span class='id error'>error</span> <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='tstring_content'>Error processing </span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id source'>source</span><span class='period'>.</span><span class='id class'>class</span><span class='rbrace'>}</span><span class='tstring_content'> '</span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>': </span><span class='embexpr_beg'>#{</span><span class='id error_report'>error_report</span><span class='lparen'>(</span><span class='id e'>e</span><span class='rparen'>)</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span>
+  <span class='id req'>req</span><span class='period'>.</span><span class='id add_problem'>add_problem</span><span class='lparen'>(</span><span class='id e'>e</span><span class='rparen'>)</span>
   <span class='id req'>req</span><span class='period'>.</span><span class='id save'>save</span>
   <span class='id emit'>emit</span><span class='lparen'>(</span><span class='symbol'>:request_error</span><span class='comma'>,</span> <span class='id req'>req</span><span class='comma'>,</span> <span class='id e'>e</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
@@ -1486,7 +1644,7 @@ The caught Exception.
 </p><div class="docstring">
   <div class="discussion">
     <p>
-Adds a response to the queue.
+Adds a response to the queue and dispatches it.
 </p>
 
 
@@ -1539,59 +1697,17 @@ Contents of the response.
       <pre class="lines">
 
 
-118
-119
-120
-121</pre>
+197
+198
+199
+200</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 118</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 197</span>
 
 <span class='kw'>def</span> <span class='id respond'>respond</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='id text'>text</span><span class='rparen'>)</span>
   <span class='const'>Log</span><span class='period'>.</span><span class='id info'>info</span><span class='lparen'>(</span><span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id user'>user</span><span class='period'>.</span><span class='id name'>name</span><span class='rbrace'>}</span><span class='tstring_content'>: </span><span class='embexpr_beg'>#{</span><span class='id req'>req</span><span class='period'>.</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_content'>\nsafubot: </span><span class='embexpr_beg'>#{</span><span class='id text'>text</span><span class='rbrace'>}</span><span class='tstring_end'>&quot;</span></span><span class='rparen'>)</span>
-  <span class='const'>Response</span><span class='period'>.</span><span class='id create'>create</span><span class='lparen'>(</span><span class='symbol'>:request</span> <span class='op'>=&gt;</span> <span class='id req'>req</span><span class='comma'>,</span> <span class='symbol'>:text</span> <span class='op'>=&gt;</span> <span class='id text'>text</span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-    
-      <div class="method_details ">
-  <p class="signature " id="respond_now-instance_method">
-  
-    - (<tt>Object</tt>) <strong>respond_now</strong>(req, text) 
-  
-
-  
-</p><div class="docstring">
-  <div class="discussion">
-    <p>
-Respond + push
-</p>
-
-
-  </div>
-</div>
-<div class="tags">
-  
-
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-
-
-124
-125
-126
-127</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 124</span>
-
-<span class='kw'>def</span> <span class='id respond_now'>respond_now</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='id text'>text</span><span class='rparen'>)</span>
-  <span class='id respond'>respond</span><span class='lparen'>(</span><span class='id req'>req</span><span class='comma'>,</span> <span class='id text'>text</span><span class='rparen'>)</span>
-  <span class='id push'>push</span>
+  <span class='id dispatch'>dispatch</span><span class='lparen'>(</span><span class='const'>Response</span><span class='period'>.</span><span class='id create'>create</span><span class='lparen'>(</span><span class='symbol'>:request</span> <span class='op'>=&gt;</span> <span class='id req'>req</span><span class='comma'>,</span> <span class='symbol'>:text</span> <span class='op'>=&gt;</span> <span class='id text'>text</span><span class='rparen'>)</span><span class='rparen'>)</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1623,17 +1739,17 @@ Calls run_nowait and then waits for all child processes.
       <pre class="lines">
 
 
-158
-159
-160
-161
-162
-163
-164
-165</pre>
+230
+231
+232
+233
+234
+235
+236
+237</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 158</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 230</span>
 
 <span class='kw'>def</span> <span class='id run'>run</span>
   <span class='id run_nowait'>run_nowait</span>
@@ -1674,14 +1790,14 @@ processes.
       <pre class="lines">
 
 
-151
-152
-153
-154
-155</pre>
+223
+224
+225
+226
+227</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 151</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 223</span>
 
 <span class='kw'>def</span> <span class='id run_nowait'>run_nowait</span>
   <span class='id pull'>pull</span><span class='semicolon'>;</span> <span class='id process'>process</span><span class='semicolon'>;</span> <span class='id push'>push</span>
@@ -1718,13 +1834,13 @@ Shuts down the streaming processes.
       <pre class="lines">
 
 
-168
-169
-170
-171</pre>
+240
+241
+242
+243</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 168</span>
+      <pre class="code"><span class="info file"># File 'lib/safubot/bot.rb', line 240</span>
 
 <span class='kw'>def</span> <span class='id stop'>stop</span>
   <span class='ivar'>@twitter</span><span class='period'>.</span><span class='id stop'>stop</span> <span class='kw'>if</span> <span class='ivar'>@twitter</span>
@@ -1740,7 +1856,7 @@ Shuts down the streaming processes.
 </div>
     
     <div id="footer">
-  Generated on Tue Nov 29 11:44:04 2011 by 
+  Generated on Thu Dec  1 18:19:17 2011 by 
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.7.3 (ruby-1.9.2).
 </div>