isimud 0.7.0 → 1.3.1

data/doc/Isimud/EventListener.html

@@ -103,7 +103,80 @@
 </dl>
 <div class="clear"></div>
 
+<h2>Overview</h2><div class="docstring">
+  <div class="discussion">
+    
+<p>Daemon process manager for monitoring event queues. Known EventObserver
+models and their instances automatically registered upon startup. It is
+also possible to define ad-hoc queues and handlers by extending In
+addition, ad-hoc event managing may be set up by extending bind_queues()
+and making the appropriate subscribe calls directly.</p>
+
+<h6 id="label-"></h6>
+
+<p>Threads created by the daemon process</p>
+
+<h6 id="label-"></h6>
+
+<p>Upon startup, EventListener operates using the following threads:</p>
+<ul><li>
+<p>An event processing thread that establishes consumers for message queues</p>
+</li><li>
+<p>An error counter thread that manages the error counter</p>
+</li><li>
+<p>A shutdown thread that listens for INT or TERM signals, which will trigger
+a graceful shutdown.</p>
+</li><li>
+<p>The main thread is put to sleep until a shutdown is required.</p>
+</li></ul>
+
+<h6 id="label-"></h6>
+
+<p>Registering Queues</p>
+
+<h6 id="label-"></h6>
+
+<p>All active instances of all known EventObserver classes (which are assumed
+to be ActiveRecord instances) are automatically loaded by the event
+processing thread, and their associated queues are bound. Note that queues
+and associated routing key bindings are established at the time the
+instance is created or modified. Each EventListener process creates an
+exclusive queue for monitoring the creation, modification, and destruction
+of EventObserver instances, using ModelWatcher messages.</p>
+
+<h6 id="label-"></h6>
+
+<p>Error Handling</p>
+
+<h6 id="label-"></h6>
+
+<p>Whenever an uncaught exception is rescued from a consumer handling a
+message, it is logged and the error counter is incremented. The error
+counter is reset periodically according to the value of
+<code>error_interval</code>. If the total number of errors logged exceeds
+<code>error_limit</code>, the process is terminated immediately. There are
+certain situations that may cause a Bunny exception to occur, such as a
+loss of network connection. Whenever a Bunny exception is rescued in the
+event processing thread, the Bunny session is closed (canceling all queue
+consumers), in addition to the error being counted, all Bunny channels are
+closed, and queues are reinitialized.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
 
+  <p class="tag_title">See Also:</p>
+  <ul class="see">
+    
+      <li>EventObserver.find_active_observers</li>
+    
+      <li>BunnyClient#subscribe()</li>
+    
+  </ul>
+
+</div>
   <h2>Constant Summary</h2>
   
     <dl class="constants">
@@ -111,7 +184,7 @@
         <dt id="DEFAULT_ERROR_LIMIT-constant" class="">DEFAULT_ERROR_LIMIT =
           
         </dt>
-        <dd><pre class="code"><span class='int'>100</span></pre></dd>
+        <dd><pre class="code"><span class='int'>10</span></pre></dd>
       
         <dt id="DEFAULT_ERROR_INTERVAL-constant" class="">DEFAULT_ERROR_INTERVAL =
           
@@ -140,7 +213,7 @@
       <li class="public ">
   <span class="summary_signature">
     
-      <a href="#error_count-instance_method" title="#error_count (instance method)">- (Object) <strong>error_count</strong> </a>
+      <a href="#error_count-instance_method" title="#error_count (instance method)">- (Integer) <strong>error_count</strong> </a>
     
 
     
@@ -160,7 +233,8 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Returns the value of attribute error_count.</p>
+<p>Count of errors (uncaught exceptions) that have occurred in the current
+error interval.</p>
 </div></span>
   
 </li>
@@ -385,7 +459,7 @@
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#bind_queues-instance_method" title="#bind_queues (instance method)">- (Object) <strong>bind_queues</strong> </a>
+      <a href="#bind_event_queues-instance_method" title="#bind_event_queues (instance method)">- (Object) <strong>bind_event_queues</strong> </a>
     
 
     
@@ -400,31 +474,9 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Override this method to set up message observers.</p>
+<p>Hook for setting up custom queues in your application.</p>
 </div></span>
   
-</li>
-
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a href="#has_observer%3F-instance_method" title="#has_observer? (instance method)">- (Boolean) <strong>has_observer?</strong>(observer) </a>
-    
-
-    
-  </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'></div></span>
-  
 </li>
 
       
@@ -448,31 +500,9 @@
 
   
     <span class="summary_desc"><div class='inline'>
-<p>A new instance of EventListener.</p>
+<p>Initialize a new EventListener daemon instance.</p>
 </div></span>
   
-</li>
-
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a href="#max_errors-instance_method" title="#max_errors (instance method)">- (Object) <strong>max_errors</strong> </a>
-    
-
-    
-  </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'></div></span>
-  
 </li>
 
       
@@ -493,29 +523,9 @@
   
 
   
-    <span class="summary_desc"><div class='inline'></div></span>
-  
-</li>
-
-      
-        <li class="public ">
-  <span class="summary_signature">
-    
-      <a href="#test_env%3F-instance_method" title="#test_env? (instance method)">- (Boolean) <strong>test_env?</strong> </a>
-    
-
-    
-  </span>
-  
-  
-  
-  
-  
-  
-  
-
-  
-    <span class="summary_desc"><div class='inline'></div></span>
+    <span class="summary_desc"><div class='inline'>
+<p>Run the daemon process.</p>
+</div></span>
   
 </li>
 
@@ -549,13 +559,126 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Returns a new instance of EventListener</p>
+<p>Initialize a new EventListener daemon instance</p>
 
 
   </div>
 </div>
 <div class="tags">
+  <p class="tag_title">Parameters:</p>
+<ul class="param">
   
+    <li>
+      
+        <span class='name'>options</span>
+      
+      
+        <span class='type'>(<tt>Hash</tt>)</span>
+      
+      
+        <em class="default">(defaults to: <tt>{}</tt>)</em>
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>daemon options</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+  
+    
+    
+    <p class="tag_title">Options Hash (<tt>options</tt>):</p>
+    <ul class="option">
+      
+        <li>
+          <span class="name">:error_limit</span>
+          <span class="type">(<tt>Integer</tt>)</span>
+          <span class="default">
+            
+              &mdash; default:
+              <tt>10</tt>
+            
+          </span>
+          
+            &mdash; <div class='inline'>
+<p>maximum number of errors that are allowed to occur within error_interval
+before the process terminates</p>
+</div>
+          
+        </li>
+      
+        <li>
+          <span class="name">:error_interval</span>
+          <span class="type">(<tt>Integer</tt>)</span>
+          <span class="default">
+            
+              &mdash; default:
+              <tt>3600</tt>
+            
+          </span>
+          
+            &mdash; <div class='inline'>
+<p>time interval, in seconds, before the error counter is cleared</p>
+</div>
+          
+        </li>
+      
+        <li>
+          <span class="name">:events_exchange</span>
+          <span class="type">(<tt>String</tt>)</span>
+          <span class="default">
+            
+              &mdash; default:
+              <tt>&#39;events&#39;</tt>
+            
+          </span>
+          
+            &mdash; <div class='inline'>
+<p>name of AMQP exchange used for listening to event messages</p>
+</div>
+          
+        </li>
+      
+        <li>
+          <span class="name">:models_exchange</span>
+          <span class="type">(<tt>String</tt>)</span>
+          <span class="default">
+            
+              &mdash; default:
+              <tt>&#39;models&#39;</tt>
+            
+          </span>
+          
+            &mdash; <div class='inline'>
+<p>name of AMQP exchange used for listening to EventObserver instance create,
+update, and destroy messages</p>
+</div>
+          
+        </li>
+      
+        <li>
+          <span class="name">:name</span>
+          <span class="type">(<tt>String</tt>)</span>
+          <span class="default">
+            
+              &mdash; default:
+              <tt>&quot;#{Rails.application.class.parent_name.downcase}-listener&quot;</tt>
+            
+          </span>
+          
+            &mdash; <div class='inline'>
+<p>daemon instance name.</p>
+</div>
+          
+        </li>
+      
+    </ul>
+  
+
 
 </div><table class="source_code">
   <tr>
@@ -563,49 +686,51 @@
       <pre class="lines">
 
 
-16
-17
-18
-19
-20
-21
-22
-23
-24
-25
-26
-27
-28
-29
-30
-31
-32
-33
-34
-35</pre>
+70
+71
+72
+73
+74
+75
+76
+77
+78
+79
+80
+81
+82
+83
+84
+85
+86
+87
+88
+89
+90</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 16</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 70</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span><span class='lparen'>(</span><span class='id identifier rubyid_options'>options</span> <span class='op'>=</span> <span class='lbrace'>{</span><span class='rbrace'>}</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_default_options'>default_options</span> <span class='op'>=</span> <span class='lbrace'>{</span>
-      <span class='label'>error_limit:</span>     <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_listener_error_limit'>listener_error_limit</span> <span class='op'>||</span> <span class='const'>DEFAULT_ERROR_LIMIT</span><span class='comma'>,</span>
-      <span class='label'>error_interval:</span>  <span class='const'>DEFAULT_ERROR_INTERVAL</span><span class='comma'>,</span>
-      <span class='label'>events_exchange:</span> <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_events_exchange'>events_exchange</span> <span class='op'>||</span> <span class='const'>DEFAULT_EVENTS_EXCHANGE</span><span class='comma'>,</span>
-      <span class='label'>models_exchange:</span> <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_model_watcher_exchange'>model_watcher_exchange</span> <span class='op'>||</span> <span class='const'>DEFAULT_MODELS_EXCHANGE</span><span class='comma'>,</span>
-      <span class='label'>name:</span>            <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='const'>Rails</span><span class='period'>.</span><span class='id identifier rubyid_application'>application</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_parent_name'>parent_name</span><span class='period'>.</span><span class='id identifier rubyid_downcase'>downcase</span><span class='embexpr_end'>}</span><span class='tstring_content'>-listener</span><span class='tstring_end'>&quot;</span></span>
+      <span class='label'>error_limit:</span>      <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_listener_error_limit'>listener_error_limit</span> <span class='op'>||</span> <span class='const'>DEFAULT_ERROR_LIMIT</span><span class='comma'>,</span>
+      <span class='label'>error_interval:</span>   <span class='const'>DEFAULT_ERROR_INTERVAL</span><span class='comma'>,</span>
+      <span class='label'>events_exchange:</span>  <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_events_exchange'>events_exchange</span> <span class='op'>||</span> <span class='const'>DEFAULT_EVENTS_EXCHANGE</span><span class='comma'>,</span>
+      <span class='label'>models_exchange:</span>  <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_model_watcher_exchange'>model_watcher_exchange</span> <span class='op'>||</span> <span class='const'>DEFAULT_MODELS_EXCHANGE</span><span class='comma'>,</span>
+      <span class='label'>name:</span>             <span class='tstring'><span class='tstring_beg'>&quot;</span><span class='embexpr_beg'>#{</span><span class='const'>Rails</span><span class='period'>.</span><span class='id identifier rubyid_application'>application</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='period'>.</span><span class='id identifier rubyid_parent_name'>parent_name</span><span class='period'>.</span><span class='id identifier rubyid_downcase'>downcase</span><span class='embexpr_end'>}</span><span class='tstring_content'>-listener</span><span class='tstring_end'>&quot;</span></span>
   <span class='rbrace'>}</span>
   <span class='id identifier rubyid_options'>options</span><span class='period'>.</span><span class='id identifier rubyid_reverse_merge!'>reverse_merge!</span><span class='lparen'>(</span><span class='id identifier rubyid_default_options'>default_options</span><span class='rparen'>)</span>
-  <span class='ivar'>@error_count</span>     <span class='op'>=</span> <span class='int'>0</span>
-  <span class='ivar'>@observers</span>       <span class='op'>=</span> <span class='const'>Hash</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
-  <span class='ivar'>@observed_models</span> <span class='op'>=</span> <span class='const'>Set</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
-  <span class='ivar'>@events_exchange</span> <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:events_exchange</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='const'>DEFAULT_EVENTS_EXCHANGE</span>
-  <span class='ivar'>@models_exchange</span> <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:models_exchange</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='const'>DEFAULT_MODELS_EXCHANGE</span>
-  <span class='ivar'>@error_limit</span>     <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:error_limit</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='const'>DEFAULT_ERROR_LIMIT</span>
-  <span class='ivar'>@error_interval</span>  <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:error_interval</span><span class='rbracket'>]</span> <span class='op'>||</span> <span class='const'>DEFAULT_ERROR_INTERVAL</span>
-  <span class='ivar'>@name</span>            <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:name</span><span class='rbracket'>]</span>
-  <span class='ivar'>@observer_mutex</span>  <span class='op'>=</span> <span class='const'>Mutex</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
-  <span class='ivar'>@running</span>         <span class='op'>=</span> <span class='kw'>false</span>
+  <span class='ivar'>@error_count</span>          <span class='op'>=</span> <span class='int'>0</span>
+  <span class='ivar'>@observers</span>            <span class='op'>=</span> <span class='const'>Hash</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='ivar'>@observed_models</span>      <span class='op'>=</span> <span class='const'>Set</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='ivar'>@error_limit</span>          <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:error_limit</span><span class='rbracket'>]</span>
+  <span class='ivar'>@error_interval</span>       <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:error_interval</span><span class='rbracket'>]</span>
+  <span class='ivar'>@events_exchange</span>      <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:events_exchange</span><span class='rbracket'>]</span>
+  <span class='ivar'>@models_exchange</span>      <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:models_exchange</span><span class='rbracket'>]</span>
+  <span class='ivar'>@name</span>                 <span class='op'>=</span> <span class='id identifier rubyid_options'>options</span><span class='lbracket'>[</span><span class='symbol'>:name</span><span class='rbracket'>]</span>
+  <span class='ivar'>@observer_mutex</span>       <span class='op'>=</span> <span class='const'>Mutex</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='ivar'>@error_counter_mutex</span>  <span class='op'>=</span> <span class='const'>Mutex</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span>
+  <span class='ivar'>@running</span>              <span class='op'>=</span> <span class='kw'>false</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -622,7 +747,7 @@
       <div class="method_details first">
   <h3 class="signature first" id="error_count-instance_method">
   
-    - (<tt>Object</tt>) <strong>error_count</strong>  <span class="extras">(readonly)</span>
+    - (<tt>Integer</tt>) <strong>error_count</strong>  <span class="extras">(readonly)</span>
   
 
   
@@ -631,13 +756,33 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Returns the value of attribute error_count</p>
+<p>Returns count of errors (uncaught exceptions) that have occurred in the
+current error interval</p>
 
 
   </div>
 </div>
 <div class="tags">
   
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Integer</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>count of errors (uncaught exceptions) that have occurred in the current
+error interval</p>
+</div>
+      
+    </li>
+  
+</ul>
 
 </div><table class="source_code">
   <tr>
@@ -645,12 +790,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_error_count'>error_count</span>
   <span class='ivar'>@error_count</span>
@@ -688,12 +833,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_error_interval'>error_interval</span>
   <span class='ivar'>@error_interval</span>
@@ -731,12 +876,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_error_limit'>error_limit</span>
   <span class='ivar'>@error_limit</span>
@@ -774,12 +919,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_events_exchange'>events_exchange</span>
   <span class='ivar'>@events_exchange</span>
@@ -817,12 +962,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_models_exchange'>models_exchange</span>
   <span class='ivar'>@models_exchange</span>
@@ -860,12 +1005,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_name'>name</span>
   <span class='ivar'>@name</span>
@@ -903,12 +1048,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_queues'>queues</span>
   <span class='ivar'>@queues</span>
@@ -946,12 +1091,12 @@
       <pre class="lines">
 
 
-7
-8
-9</pre>
+52
+53
+54</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 7</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 52</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_running'>running</span>
   <span class='ivar'>@running</span>
@@ -969,9 +1114,9 @@
 
     
       <div class="method_details first">
-  <h3 class="signature first" id="bind_queues-instance_method">
+  <h3 class="signature first" id="bind_event_queues-instance_method">
   
-    - (<tt>Object</tt>) <strong>bind_queues</strong> 
+    - (<tt>Object</tt>) <strong>bind_event_queues</strong> 
   
 
   
@@ -980,7 +1125,8 @@
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Override this method to set up message observers</p>
+<p>Hook for setting up custom queues in your application. Override in your
+subclass.</p>
 
 
   </div>
@@ -994,23 +1140,13 @@
       <pre class="lines">
 
 
-61
-62
-63
-64
-65
-66
-67</pre>
+111
+112</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 61</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 111</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_bind_queues'>bind_queues</span>
-  <span class='const'>EventObserver</span><span class='period'>.</span><span class='id identifier rubyid_observed_models'>observed_models</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_model_class'>model_class</span><span class='op'>|</span>
-    <span class='id identifier rubyid_model_class'>model_class</span><span class='period'>.</span><span class='id identifier rubyid_find_active_observers'>find_active_observers</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_model'>model</span><span class='op'>|</span>
-      <span class='id identifier rubyid_register_observer'>register_observer</span><span class='lparen'>(</span><span class='id identifier rubyid_model'>model</span><span class='rparen'>)</span>
-    <span class='kw'>end</span>
-  <span class='kw'>end</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_bind_event_queues'>bind_event_queues</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -1018,9 +1154,9 @@
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="has_observer?-instance_method">
+  <h3 class="signature " id="run-instance_method">
   
-    - (<tt>Boolean</tt>) <strong>has_observer?</strong>(observer) 
+    - (<tt>Object</tt>) <strong>run</strong> 
   
 
   
@@ -1029,24 +1165,14 @@
 </h3><div class="docstring">
   <div class="discussion">
     
+<p>Run the daemon process. This creates the event, error counter, and shutdown
+threads</p>
+
 
   </div>
 </div>
 <div class="tags">
   
-<p class="tag_title">Returns:</p>
-<ul class="return">
-  
-    <li>
-      
-      
-        <span class='type'>(<tt>Boolean</tt>)</span>
-      
-      
-      
-    </li>
-  
-</ul>
 
 </div><table class="source_code">
   <tr>
@@ -1054,153 +1180,45 @@
       <pre class="lines">
 
 
-69
-70
-71</pre>
+93
+94
+95
+96
+97
+98
+99
+100
+101
+102
+103
+104
+105
+106
+107
+108</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 69</span>
-
-<span class='kw'>def</span> <span class='id identifier rubyid_has_observer?'>has_observer?</span><span class='lparen'>(</span><span class='id identifier rubyid_observer'>observer</span><span class='rparen'>)</span>
-  <span class='ivar'>@observers</span><span class='period'>.</span><span class='id identifier rubyid_has_key?'>has_key?</span><span class='lparen'>(</span><span class='id identifier rubyid_observer_key_for'>observer_key_for</span><span class='lparen'>(</span><span class='id identifier rubyid_observer'>observer</span><span class='period'>.</span><span class='id identifier rubyid_class'>class</span><span class='comma'>,</span> <span class='id identifier rubyid_observer'>observer</span><span class='period'>.</span><span class='id identifier rubyid_id'>id</span><span class='rparen'>)</span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="max_errors-instance_method">
-  
-    - (<tt>Object</tt>) <strong>max_errors</strong> 
-  
-
-  
-
-  
-</h3><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-
-
-37
-38
-39</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 37</span>
-
-<span class='kw'>def</span> <span class='id identifier rubyid_max_errors'>max_errors</span>
-  <span class='const'>Isimud</span><span class='period'>.</span><span class='id identifier rubyid_listener_error_limit'>listener_error_limit</span> <span class='op'>||</span> <span class='const'>DEFAULT_ERROR_LIMIT</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="run-instance_method">
-  
-    - (<tt>Object</tt>) <strong>run</strong> 
-  
-
-  
-
-  
-</h3><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-
-
-45
-46
-47
-48
-49
-50
-51
-52
-53
-54
-55
-56
-57
-58</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 45</span>
+      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 93</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_run'>run</span>
   <span class='ivar'>@running</span> <span class='op'>=</span> <span class='kw'>true</span>
   <span class='id identifier rubyid_bind_queues'>bind_queues</span> <span class='kw'>and</span> <span class='kw'>return</span> <span class='kw'>if</span> <span class='id identifier rubyid_test_env?'>test_env?</span>
   <span class='id identifier rubyid_start_shutdown_thread'>start_shutdown_thread</span>
   <span class='id identifier rubyid_start_error_counter_thread'>start_error_counter_thread</span>
+  <span class='id identifier rubyid_client'>client</span><span class='period'>.</span><span class='id identifier rubyid_on_exception'>on_exception</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_e'>e</span><span class='op'>|</span>
+    <span class='id identifier rubyid_count_error'>count_error</span><span class='lparen'>(</span><span class='id identifier rubyid_e'>e</span><span class='rparen'>)</span>
+  <span class='kw'>end</span>
   <span class='id identifier rubyid_client'>client</span><span class='period'>.</span><span class='id identifier rubyid_connect'>connect</span>
-  <span class='id identifier rubyid_client'>client</span><span class='period'>.</span><span class='id identifier rubyid_exception_handler'>exception_handler</span><span class='lparen'>(</span><span class='op'>&amp;</span><span class='id identifier rubyid_method'>method</span><span class='lparen'>(</span><span class='symbol'>:count_error</span><span class='rparen'>)</span><span class='rparen'>)</span>
   <span class='id identifier rubyid_start_event_thread'>start_event_thread</span>
 
   <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>EventListener started. Hit Ctrl-C to exit</span><span class='tstring_end'>&#39;</span></span>
   <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_stop'>stop</span>
-  <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Exiting.</span><span class='tstring_end'>&#39;</span></span>
+  <span class='id identifier rubyid_puts'>puts</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>Main thread wakeup - exiting.</span><span class='tstring_end'>&#39;</span></span>
   <span class='id identifier rubyid_client'>client</span><span class='period'>.</span><span class='id identifier rubyid_close'>close</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
 </table>
-</div>
-    
-      <div class="method_details ">
-  <h3 class="signature " id="test_env?-instance_method">
-  
-    - (<tt>Boolean</tt>) <strong>test_env?</strong> 
-  
-
-  
-
-  
-</h3><div class="docstring">
-  <div class="discussion">
-    
-
-  </div>
-</div>
-<div class="tags">
-  
-<p class="tag_title">Returns:</p>
-<ul class="return">
-  
-    <li>
-      
-      
-        <span class='type'>(<tt>Boolean</tt>)</span>
-      
-      
-      
-    </li>
-  
-</ul>
-
-</div><table class="source_code">
-  <tr>
-    <td>
-      <pre class="lines">
-
-
-41
-42
-43</pre>
-    </td>
-    <td>
-      <pre class="code"><span class="info file"># File 'lib/isimud/event_listener.rb', line 41</span>
-
-<span class='kw'>def</span> <span class='id identifier rubyid_test_env?'>test_env?</span>
-  <span class='lbracket'>[</span><span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>cucumber</span><span class='tstring_end'>&#39;</span></span><span class='comma'>,</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>test</span><span class='tstring_end'>&#39;</span></span><span class='rbracket'>]</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span><span class='lparen'>(</span><span class='const'>Rails</span><span class='period'>.</span><span class='id identifier rubyid_env'>env</span><span class='rparen'>)</span>
-<span class='kw'>end</span></pre>
-    </td>
-  </tr>
-</table>
 </div>
     
   </div>
@@ -1208,9 +1226,9 @@
 </div>
 
     <div id="footer">
-  Generated on Fri Apr  3 09:28:09 2015 by
+  Generated on Wed Jan 13 16:27:29 2016 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.8.7.6 (ruby-2.2.1).
+  0.8.7.6 (ruby-2.2.3).
 </div>
 
   </body>