ionian 0.6.11 → 0.6.12

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: e26c23c377fd8040799e0402c9b158b349b1d214
-  data.tar.gz: e14513b53b83104a714628e5c90858bc3a91107e
+  metadata.gz: e1530db96be4407d57fc89cc8046d9f92b97f54e
+  data.tar.gz: b180870567aa3ed43f417748e22a1082154b3fd9
 SHA512:
-  metadata.gz: bc4340836f0686884445e7c27f213952fc3791b7d8aec7f508818fc3c8a02e786a1f0245ede4380b6b152848d3a28373467970718f0b15775116fce160588a06
-  data.tar.gz: c9b71ce2de0646eddd164342ee6f84d156d603b58c0e882b79088e6fadf77f00126b716577ff75f80ba5574680f6dff3d8551a5723e6dd4c20e5884086b28908
+  metadata.gz: ee0d50045eca52b78c7ad2ddd7caacd31256555f6686517b25fff52c39a4dcc8f57232634820e201408a84b2efa6a518baac0605efc97b5075e75feff2eb3662
+  data.tar.gz: 2e715c46f0edd97eae342951a54106d4e0574e37af0fa94b5325e7bc674555fe0e1ebef79574718f8f5270d939c0dd5e7db3e7182a6ca1006d62fa4bcfc17e78

data/doc/Ionian/Extension/IO.html

@@ -350,7 +350,33 @@ implement the standard library IO class. my_socket.extend Ionian::IO</p>
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#register_observer-instance_method" title="#register_observer (instance method)">- (Object) <strong>register_observer</strong>(&amp;block) </a>
+      <a href="#register_error_handler-instance_method" title="#register_error_handler (instance method)">- (Block) <strong>register_error_handler</strong> {|Exception, self| ... }</a>
+    
+
+    
+      (also: #on_error)
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Register a block to be called when <span class='object_link'><a href="#run_match-instance_method" title="Ionian::Extension::IO#run_match (method)">#run_match</a></span> raises an error.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#register_match_handler-instance_method" title="#register_match_handler (instance method)">- (Block) <strong>register_match_handler</strong> {|MatchData, self| ... }</a>
     
 
     
@@ -370,6 +396,30 @@ implement the standard library IO class. my_socket.extend Ionian::IO</p>
 <p>Register a block to be called when <span class='object_link'><a href="#run_match-instance_method" title="Ionian::Extension::IO#run_match (method)">#run_match</a></span> receives matched data.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public deprecated">
+  <span class="summary_signature">
+    
+      <a href="#register_observer-instance_method" title="#register_observer (instance method)">- (Object) <strong>register_observer</strong>(&amp;block) </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  <span class="deprecated note title">deprecated</span>
+  
+
+  
+    <span class="summary_desc"><strong>Deprecated.</strong> <div class='inline'>
+<p>Use <span class='object_link'><a href="#register_match_handler-instance_method" title="Ionian::Extension::IO#register_match_handler (method)">#register_match_handler</a></span> instead.</p>
+</div></span>
+  
 </li>
 
       
@@ -391,8 +441,7 @@ implement the standard library IO class. my_socket.extend Ionian::IO</p>
 
   
     <span class="summary_desc"><div class='inline'>
-<p>Start a thread that checks for data and notifies listeners (do |match,
-socket|).</p>
+<p>Start a thread that checks for data and notifies match and error handlers.</p>
 </div></span>
   
 </li>
@@ -401,7 +450,31 @@ socket|).</p>
         <li class="public ">
   <span class="summary_signature">
     
-      <a href="#unregister_observer-instance_method" title="#unregister_observer (instance method)">- (Object) <strong>unregister_observer</strong>(&amp;block) </a>
+      <a href="#unregister_error_handler-instance_method" title="#unregister_error_handler (instance method)">- (Object) <strong>unregister_error_handler</strong>(&amp;block) </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Unregister a block from being called when a <span class='object_link'><a href="#run_match-instance_method" title="Ionian::Extension::IO#run_match (method)">#run_match</a></span> error is raised.</p>
+</div></span>
+  
+</li>
+
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#unregister_match_handler-instance_method" title="#unregister_match_handler (instance method)">- (Object) <strong>unregister_match_handler</strong>(&amp;block) </a>
     
 
     
@@ -419,6 +492,30 @@ socket|).</p>
 <p>Unregister a block from being called when matched data is received.</p>
 </div></span>
   
+</li>
+
+      
+        <li class="public deprecated">
+  <span class="summary_signature">
+    
+      <a href="#unregister_observer-instance_method" title="#unregister_observer (instance method)">- (Object) <strong>unregister_observer</strong>(&amp;block) </a>
+    
+
+    
+  </span>
+  
+  
+  
+  
+  
+  <span class="deprecated note title">deprecated</span>
+  
+
+  
+    <span class="summary_desc"><strong>Deprecated.</strong> <div class='inline'>
+<p>Use <span class='object_link'><a href="#unregister_match_handler-instance_method" title="Ionian::Extension::IO#unregister_match_handler (method)">#unregister_match_handler</a></span> instead.</p>
+</div></span>
+  
 </li>
 
       
@@ -553,12 +650,12 @@ standard library IO::select.</p>
       <pre class="lines">
 
 
-42
 43
-44</pre>
+44
+45</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 42</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 43</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_expression'>expression</span>
   <span class='ivar'>@ionian_expression</span>
@@ -598,13 +695,13 @@ href=":parameter">match</a>.</p>
       <pre class="lines">
 
 
-52
 53
 54
-55</pre>
+55
+56</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 52</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 53</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_expression='>expression=</span> <span class='id identifier rubyid_exp'>exp</span>
   <span class='ivar'>@ionian_expression</span> <span class='op'>=</span> <span class='id identifier rubyid_exp'>exp</span>
@@ -680,12 +777,12 @@ blocking.</p>
       <pre class="lines">
 
 
-37
 38
-39</pre>
+39
+40</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 37</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 38</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_has_data?'>has_data?</span> <span class='label'>timeout:</span> <span class='int'>0</span>
   <span class='op'>::</span><span class='const'>IO</span><span class='period'>.</span><span class='id identifier rubyid_select'>select</span><span class='lparen'>(</span><span class='lbracket'>[</span><span class='kw'>self</span><span class='rbracket'>]</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='kw'>nil</span><span class='comma'>,</span> <span class='id identifier rubyid_timeout'>timeout</span><span class='rparen'>)</span> <span class='op'>?</span> <span class='kw'>true</span> <span class='op'>:</span> <span class='kw'>false</span>
@@ -729,18 +826,20 @@ blocking.</p>
 27
 28
 29
-30</pre>
+30
+31</pre>
     </td>
     <td>
       <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 23</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_initialize_ionian'>initialize_ionian</span>
-  <span class='ivar'>@ionian_listeners</span>     <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
-  <span class='ivar'>@ionian_buf</span>           <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span>
-  <span class='ivar'>@ionian_expression</span>    <span class='op'>=</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(.*?)[\r\n]+</span><span class='regexp_end'>/</span></span>
-  <span class='ivar'>@ionian_timeout</span>       <span class='op'>=</span> <span class='kw'>nil</span>
-  <span class='ivar'>@ionian_skip_select</span>   <span class='op'>=</span> <span class='kw'>false</span>
-  <span class='ivar'>@ionian_build_methods</span> <span class='op'>=</span> <span class='kw'>true</span>
+  <span class='ivar'>@ionian_match_handlers</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+  <span class='ivar'>@ionian_error_handlers</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+  <span class='ivar'>@ionian_buf</span>            <span class='op'>=</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_end'>&#39;</span></span>
+  <span class='ivar'>@ionian_expression</span>     <span class='op'>=</span> <span class='tstring'><span class='regexp_beg'>/</span><span class='tstring_content'>(.*?)[\r\n]+</span><span class='regexp_end'>/</span></span>
+  <span class='ivar'>@ionian_timeout</span>        <span class='op'>=</span> <span class='kw'>nil</span>
+  <span class='ivar'>@ionian_skip_select</span>    <span class='op'>=</span> <span class='kw'>false</span>
+  <span class='ivar'>@ionian_build_methods</span>  <span class='op'>=</span> <span class='kw'>true</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
@@ -774,14 +873,14 @@ automatically.</p>
       <pre class="lines">
 
 
-172
 173
 174
 175
-176</pre>
+176
+177</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 172</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 173</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_purge'>purge</span>
   <span class='comment'># Erase IO buffer.
@@ -821,7 +920,6 @@ nonblocking, returns nil if no data available.</p>
       <pre class="lines">
 
 
-61
 62
 63
 64
@@ -829,10 +927,11 @@ nonblocking, returns nil if no data available.</p>
 66
 67
 68
-69</pre>
+69
+70</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 61</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 62</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_read_all'>read_all</span> <span class='label'>nonblocking:</span> <span class='kw'>false</span>
   <span class='kw'>return</span> <span class='kw'>nil</span> <span class='kw'>if</span> <span class='id identifier rubyid_nonblocking'>nonblocking</span> <span class='kw'>and</span> <span class='kw'>not</span> <span class='id identifier rubyid_has_data?'>has_data?</span>
@@ -943,7 +1042,7 @@ Set to 0 for nonblocking.</p>
           </span>
           
             &mdash; <div class='inline'>
-<p>Set to false to skip notifying match listener procs.</p>
+<p>Set to false to skip notifying match handler procs.</p>
 </div>
           
         </li>
@@ -1030,7 +1129,6 @@ timeout period.</p>
       <pre class="lines">
 
 
-106
 107
 108
 109
@@ -1074,10 +1172,11 @@ timeout period.</p>
 147
 148
 149
-150</pre>
+150
+151</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 106</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 107</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_read_match'>read_match</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span><span class='comma'>,</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
   <span class='id identifier rubyid_timeout'>timeout</span>       <span class='op'>=</span> <span class='id identifier rubyid_kwargs'>kwargs</span><span class='period'>.</span><span class='id identifier rubyid_fetch'>fetch</span> <span class='symbol'>:timeout</span><span class='comma'>,</span>        <span class='ivar'>@ionian_timeout</span>
@@ -1118,9 +1217,9 @@ timeout period.</p>
   <span class='comment'># Pass each match to block.
 </span>  <span class='ivar'>@matches</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_match'>match</span><span class='op'>|</span> <span class='kw'>yield</span> <span class='id identifier rubyid_match'>match</span> <span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_block_given?'>block_given?</span>
   
-  <span class='comment'># Notify on_match listeners unless the #run_match thread is active.
-</span>  <span class='ivar'>@matches</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_match'>match</span><span class='op'>|</span> <span class='id identifier rubyid_notify_listeners'>notify_listeners</span> <span class='id identifier rubyid_match'>match</span> <span class='rbrace'>}</span> \
-    <span class='kw'>if</span> <span class='id identifier rubyid_notify'>notify</span> <span class='kw'>and</span> <span class='kw'>not</span> <span class='ivar'>@match_listener</span>
+  <span class='comment'># Notify on_match handlers unless the #run_match thread is active.
+</span>  <span class='ivar'>@matches</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_match'>match</span><span class='op'>|</span> <span class='id identifier rubyid_notify_match_handlers'>notify_match_handlers</span> <span class='id identifier rubyid_match'>match</span> <span class='rbrace'>}</span> \
+    <span class='kw'>if</span> <span class='id identifier rubyid_notify'>notify</span> <span class='kw'>and</span> <span class='kw'>not</span> <span class='ivar'>@run_match_thread</span>
   
   <span class='ivar'>@matches</span>
 <span class='kw'>end</span></pre>
@@ -1130,9 +1229,88 @@ timeout period.</p>
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="register_observer-instance_method">
+  <h3 class="signature " id="register_error_handler-instance_method">
   
-    - (<tt>Object</tt>) <strong>register_observer</strong>(&amp;block) 
+    - (<tt>Block</tt>) <strong>register_error_handler</strong> {|Exception, self| ... }
+  
+
+  
+    <span class="aliases">Also known as:
+    <span class="names"><span id='on_error-instance_method'>on_error</span></span>
+    </span>
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Register a block to be called when <span class='object_link'><a href="#run_match-instance_method" title="Ionian::Extension::IO#run_match (method)">#run_match</a></span> raises an error. Method
+callbacks can be registered with &amp;object.method(:method).</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+<p class="tag_title">Yields:</p>
+<ul class="yield">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Exception</tt>, <tt>self</tt>)</span>
+      
+      
+      
+    </li>
+  
+</ul>
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Block</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>a reference to the given block.</p>
+</div>
+      
+    </li>
+  
+</ul>
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+216
+217
+218
+219</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 216</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_register_error_handler'>register_error_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+  <span class='ivar'>@ionian_error_handlers</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_block'>block</span> <span class='kw'>unless</span> <span class='ivar'>@ionian_error_handlers</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_block'>block</span>
+  <span class='id identifier rubyid_block'>block</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="register_match_handler-instance_method">
+  
+    - (<tt>Block</tt>) <strong>register_match_handler</strong> {|MatchData, self| ... }
   
 
   
@@ -1146,8 +1324,7 @@ timeout period.</p>
   <div class="discussion">
     
 <p>Register a block to be called when <span class='object_link'><a href="#run_match-instance_method" title="Ionian::Extension::IO#run_match (method)">#run_match</a></span> receives matched data.
-Method callbacks can be registered with &amp;object.method(:method).
-Returns a reference to the given block.</p>
+Method callbacks can be registered with &amp;object.method(:method).</p>
 
 
   </div>
@@ -1158,13 +1335,49 @@ Returns a reference to the given block.</p>
     <p class="tag_title">Examples:</p>
     
       
-      <pre class="example code"><code>registered_block = ionian_socket.register_observer { |match| ... }</code></pre>
+      <pre class="example code"><code>registered_block = ionian_socket.register_match_handler { |match| ... }</code></pre>
     
       
-      <pre class="example code"><code><span class='id identifier rubyid_registered_block'>registered_block</span> <span class='op'>=</span> <span class='id identifier rubyid_ionian_socket'>ionian_socket</span><span class='period'>.</span><span class='id identifier rubyid_register_observer'>register_observer</span> <span class='op'>&amp;</span><span class='id identifier rubyid_my_object'>my_object</span><span class='period'>.</span><span class='id identifier rubyid_method'>method</span><span class='lparen'>(</span><span class='symbol'>:foo</span><span class='rparen'>)</span></code></pre>
+      <pre class="example code"><code><span class='id identifier rubyid_registered_block'>registered_block</span> <span class='op'>=</span> <span class='id identifier rubyid_ionian_socket'>ionian_socket</span><span class='period'>.</span><span class='id identifier rubyid_register_match_handler'>register_match_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_my_object'>my_object</span><span class='period'>.</span><span class='id identifier rubyid_method'>method</span><span class='lparen'>(</span><span class='symbol'>:foo</span><span class='rparen'>)</span></code></pre>
     
   </div>
 
+<p class="tag_title">Yields:</p>
+<ul class="yield">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>MatchData</tt>, <tt>self</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>Regex match.</p>
+</div>
+      
+    </li>
+  
+</ul>
+<p class="tag_title">Returns:</p>
+<ul class="return">
+  
+    <li>
+      
+      
+        <span class='type'>(<tt>Block</tt>)</span>
+      
+      
+      
+        &mdash;
+        <div class='inline'>
+<p>a reference to the given block.</p>
+</div>
+      
+    </li>
+  
+</ul>
 
 </div><table class="source_code">
   <tr>
@@ -1172,21 +1385,63 @@ Returns a reference to the given block.</p>
       <pre class="lines">
 
 
-187
-188
 189
-190</pre>
+190
+191
+192</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 187</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 189</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_register_observer'>register_observer</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
-  <span class='ivar'>@ionian_listeners</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_block'>block</span> <span class='kw'>unless</span> <span class='ivar'>@ionian_listeners</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_block'>block</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_register_match_handler'>register_match_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+  <span class='ivar'>@ionian_match_handlers</span> <span class='op'>&lt;&lt;</span> <span class='id identifier rubyid_block'>block</span> <span class='kw'>unless</span> <span class='ivar'>@ionian_match_handlers</span><span class='period'>.</span><span class='id identifier rubyid_include?'>include?</span> <span class='id identifier rubyid_block'>block</span>
   <span class='id identifier rubyid_block'>block</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="register_observer-instance_method">
+  
+    - (<tt>Object</tt>) <strong>register_observer</strong>(&amp;block) 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <div class="note deprecated"><strong>Deprecated.</strong> <div class='inline'>
+<p>Use <span class='object_link'><a href="#register_match_handler-instance_method" title="Ionian::Extension::IO#register_match_handler (method)">#register_match_handler</a></span> instead.</p>
+</div></div>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+197
+198
+199</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 197</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_register_observer'>register_observer</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+  <span class='id identifier rubyid_register_match_handler'>register_match_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
       <div class="method_details ">
@@ -1201,8 +1456,8 @@ Returns a reference to the given block.</p>
 </h3><div class="docstring">
   <div class="discussion">
     
-<p>Start a thread that checks for data and notifies listeners (do |match,
-socket|). Passes kwargs to <span class='object_link'><a href="#read_match-instance_method" title="Ionian::Extension::IO#read_match (method)">#read_match</a></span>. This method SHOULD NOT be used if
+<p>Start a thread that checks for data and notifies match and error handlers.
+Passes kwargs to <span class='object_link'><a href="#read_match-instance_method" title="Ionian::Extension::IO#read_match (method)">#read_match</a></span>. This method SHOULD NOT be used if
 <span class='object_link'><a href="#read_match-instance_method" title="Ionian::Extension::IO#read_match (method)">#read_match</a></span> is used.</p>
 
 
@@ -1217,7 +1472,6 @@ socket|). Passes kwargs to <span class='object_link'><a href="#read_match-instan
       <pre class="lines">
 
 
-155
 156
 157
 158
@@ -1230,22 +1484,23 @@ socket|). Passes kwargs to <span class='object_link'><a href="#read_match-instan
 165
 166
 167
-168</pre>
+168
+169</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 155</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 156</span>
 
 <span class='kw'>def</span> <span class='id identifier rubyid_run_match'>run_match</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span>
-  <span class='ivar'>@match_listener</span> <span class='op'>||=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='kw'>do</span>
+  <span class='ivar'>@run_match_thread</span> <span class='op'>||=</span> <span class='const'>Thread</span><span class='period'>.</span><span class='id identifier rubyid_new'>new</span> <span class='kw'>do</span>
     <span class='kw'>begin</span>
       <span class='kw'>while</span> <span class='kw'>not</span> <span class='id identifier rubyid_closed?'>closed?</span> <span class='kw'>do</span>
         <span class='id identifier rubyid_matches'>matches</span> <span class='op'>=</span> <span class='id identifier rubyid_read_match'>read_match</span> <span class='op'>**</span><span class='id identifier rubyid_kwargs'>kwargs</span>
-        <span class='id identifier rubyid_matches'>matches</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_match'>match</span><span class='op'>|</span> <span class='id identifier rubyid_notify_listeners'>notify_listeners</span> <span class='id identifier rubyid_match'>match</span> <span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_matches'>matches</span>
+        <span class='id identifier rubyid_matches'>matches</span><span class='period'>.</span><span class='id identifier rubyid_each'>each</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_match'>match</span><span class='op'>|</span> <span class='id identifier rubyid_notify_match_handlers'>notify_match_handlers</span> <span class='id identifier rubyid_match'>match</span> <span class='rbrace'>}</span> <span class='kw'>if</span> <span class='id identifier rubyid_matches'>matches</span>
       <span class='kw'>end</span>
-    <span class='kw'>rescue</span> <span class='const'>EOFError</span>
-    <span class='kw'>rescue</span> <span class='const'>IOError</span>
+    <span class='kw'>rescue</span> <span class='const'>Exception</span> <span class='op'>=&gt;</span> <span class='id identifier rubyid_e'>e</span>
+      <span class='id identifier rubyid_notify_error_handlers'>notify_error_handlers</span> <span class='id identifier rubyid_e'>e</span>
     <span class='kw'>ensure</span>
-      <span class='ivar'>@match_listener</span> <span class='op'>=</span> <span class='kw'>nil</span>
+      <span class='ivar'>@run_match_thread</span> <span class='op'>=</span> <span class='kw'>nil</span>
     <span class='kw'>end</span>
   <span class='kw'>end</span>
 <span class='kw'>end</span></pre>
@@ -1255,9 +1510,52 @@ socket|). Passes kwargs to <span class='object_link'><a href="#read_match-instan
 </div>
     
       <div class="method_details ">
-  <h3 class="signature " id="unregister_observer-instance_method">
+  <h3 class="signature " id="unregister_error_handler-instance_method">
   
-    - (<tt>Object</tt>) <strong>unregister_observer</strong>(&amp;block) 
+    - (<tt>Object</tt>) <strong>unregister_error_handler</strong>(&amp;block) 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Unregister a block from being called when a <span class='object_link'><a href="#run_match-instance_method" title="Ionian::Extension::IO#run_match (method)">#run_match</a></span> error is raised.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+224
+225
+226
+227</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 224</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_unregister_error_handler'>unregister_error_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+  <span class='ivar'>@ionian_error_handlers</span><span class='period'>.</span><span class='id identifier rubyid_delete_if'>delete_if</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='id identifier rubyid_o'>o</span> <span class='op'>==</span> <span class='id identifier rubyid_block'>block</span> <span class='rbrace'>}</span>
+  <span class='id identifier rubyid_block'>block</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="unregister_match_handler-instance_method">
+  
+    - (<tt>Object</tt>) <strong>unregister_match_handler</strong>(&amp;block) 
   
 
   
@@ -1280,21 +1578,63 @@ socket|). Passes kwargs to <span class='object_link'><a href="#read_match-instan
       <pre class="lines">
 
 
-195
-196
-197
-198</pre>
+202
+203
+204
+205</pre>
     </td>
     <td>
-      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 195</span>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 202</span>
 
-<span class='kw'>def</span> <span class='id identifier rubyid_unregister_observer'>unregister_observer</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
-  <span class='ivar'>@ionian_listeners</span><span class='period'>.</span><span class='id identifier rubyid_delete_if'>delete_if</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='id identifier rubyid_o'>o</span> <span class='op'>==</span> <span class='id identifier rubyid_block'>block</span> <span class='rbrace'>}</span>
+<span class='kw'>def</span> <span class='id identifier rubyid_unregister_match_handler'>unregister_match_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+  <span class='ivar'>@ionian_match_handlers</span><span class='period'>.</span><span class='id identifier rubyid_delete_if'>delete_if</span> <span class='lbrace'>{</span> <span class='op'>|</span><span class='id identifier rubyid_o'>o</span><span class='op'>|</span> <span class='id identifier rubyid_o'>o</span> <span class='op'>==</span> <span class='id identifier rubyid_block'>block</span> <span class='rbrace'>}</span>
   <span class='id identifier rubyid_block'>block</span>
 <span class='kw'>end</span></pre>
     </td>
   </tr>
 </table>
+</div>
+    
+      <div class="method_details ">
+  <h3 class="signature " id="unregister_observer-instance_method">
+  
+    - (<tt>Object</tt>) <strong>unregister_observer</strong>(&amp;block) 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    <div class="note deprecated"><strong>Deprecated.</strong> <div class='inline'>
+<p>Use <span class='object_link'><a href="#unregister_match_handler-instance_method" title="Ionian::Extension::IO#unregister_match_handler (method)">#unregister_match_handler</a></span> instead.</p>
+</div></div>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+208
+209
+210</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/ionian/extension/io.rb', line 208</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_unregister_observer'>unregister_observer</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+  <span class='id identifier rubyid_unregister_match_handler'>unregister_match_handler</span> <span class='op'>&amp;</span><span class='id identifier rubyid_block'>block</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
 </div>
     
   </div>
@@ -1302,7 +1642,7 @@ socket|). Passes kwargs to <span class='object_link'><a href="#read_match-instan
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:48 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/Ionian/Extension/Socket.html

@@ -2530,7 +2530,7 @@ true.</p>
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:48 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/Ionian/Extension.html

@@ -119,7 +119,7 @@
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/Ionian/Server.html

@@ -930,7 +930,7 @@ connected client is passed to the block as an Ionain::Client.</p>
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:48 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/Ionian/Socket.html

@@ -1854,7 +1854,7 @@ reference to the given block. block = ionian_socket.register_observer { … }</p
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:48 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/Ionian.html

@@ -123,7 +123,7 @@ Features regular expression matching and notification of received data.</p>
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/_index.html

@@ -155,7 +155,7 @@
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:47 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/file.README.html

@@ -139,7 +139,7 @@ data.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/file.license.html

@@ -64,7 +64,7 @@
     <div id="content"><div id='filecontents'>The MIT License (MIT)<br/><br/>Copyright (c) 2013-2015 Alex McLain<br/><br/>Permission is hereby granted, free of charge, to any person obtaining a copy<br/>of this software and associated documentation files (the &quot;Software&quot;), to deal<br/>in the Software without restriction, including without limitation the rights<br/>to use, copy, modify, merge, publish, distribute, sublicense, and/or sell<br/>copies of the Software, and to permit persons to whom the Software is<br/>furnished to do so, subject to the following conditions:<br/><br/>The above copyright notice and this permission notice shall be included in<br/>all copies or substantial portions of the Software.<br/><br/>THE SOFTWARE IS PROVIDED &quot;AS IS&quot;, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR<br/>IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,<br/>FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE<br/>AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER<br/>LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,<br/>OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN<br/>THE SOFTWARE.
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/index.html

@@ -139,7 +139,7 @@ data.</p>
 </div></div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/doc/method_list.html

@@ -76,14 +76,14 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ionian/Server.html#closed%3F-instance_method" title="Ionian::Server#closed? (method)">#closed?</a></span>
-    <small>Ionian::Server</small>
+    <span class='object_link'><a href="Ionian/Socket.html#closed%3F-instance_method" title="Ionian::Socket#closed? (method)">#closed?</a></span>
+    <small>Ionian::Socket</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ionian/Socket.html#closed%3F-instance_method" title="Ionian::Socket#closed? (method)">#closed?</a></span>
-    <small>Ionian::Socket</small>
+    <span class='object_link'><a href="Ionian/Server.html#closed%3F-instance_method" title="Ionian::Server#closed? (method)">#closed?</a></span>
+    <small>Ionian::Server</small>
   </li>
   
 
@@ -118,14 +118,14 @@
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ionian/Extension/IO.html#expression%3D-instance_method" title="Ionian::Extension::IO#expression= (method)">#expression=</a></span>
-    <small>Ionian::Extension::IO</small>
+    <span class='object_link'><a href="Ionian/Socket.html#expression%3D-instance_method" title="Ionian::Socket#expression= (method)">#expression=</a></span>
+    <small>Ionian::Socket</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ionian/Socket.html#expression%3D-instance_method" title="Ionian::Socket#expression= (method)">#expression=</a></span>
-    <small>Ionian::Socket</small>
+    <span class='object_link'><a href="Ionian/Extension/IO.html#expression%3D-instance_method" title="Ionian::Extension::IO#expression= (method)">#expression=</a></span>
+    <small>Ionian::Extension::IO</small>
   </li>
   
 
@@ -148,14 +148,14 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ionian/Socket.html#has_data%3F-instance_method" title="Ionian::Socket#has_data? (method)">#has_data?</a></span>
-    <small>Ionian::Socket</small>
+    <span class='object_link'><a href="Ionian/Extension/IO.html#has_data%3F-instance_method" title="Ionian::Extension::IO#has_data? (method)">#has_data?</a></span>
+    <small>Ionian::Extension::IO</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ionian/Extension/IO.html#has_data%3F-instance_method" title="Ionian::Extension::IO#has_data? (method)">#has_data?</a></span>
-    <small>Ionian::Extension::IO</small>
+    <span class='object_link'><a href="Ionian/Socket.html#has_data%3F-instance_method" title="Ionian::Socket#has_data? (method)">#has_data?</a></span>
+    <small>Ionian::Socket</small>
   </li>
   
 
@@ -352,26 +352,26 @@
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ionian/Socket.html#port-instance_method" title="Ionian::Socket#port (method)">#port</a></span>
-    <small>Ionian::Socket</small>
+    <span class='object_link'><a href="Ionian/Server.html#port-instance_method" title="Ionian::Server#port (method)">#port</a></span>
+    <small>Ionian::Server</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ionian/Server.html#port-instance_method" title="Ionian::Server#port (method)">#port</a></span>
-    <small>Ionian::Server</small>
+    <span class='object_link'><a href="Ionian/Socket.html#port-instance_method" title="Ionian::Socket#port (method)">#port</a></span>
+    <small>Ionian::Socket</small>
   </li>
   
 
   <li class="r1 ">
-    <span class='object_link'><a href="Ionian/Server.html#protocol-instance_method" title="Ionian::Server#protocol (method)">#protocol</a></span>
-    <small>Ionian::Server</small>
+    <span class='object_link'><a href="Ionian/Socket.html#protocol-instance_method" title="Ionian::Socket#protocol (method)">#protocol</a></span>
+    <small>Ionian::Socket</small>
   </li>
   
 
   <li class="r2 ">
-    <span class='object_link'><a href="Ionian/Socket.html#protocol-instance_method" title="Ionian::Socket#protocol (method)">#protocol</a></span>
-    <small>Ionian::Socket</small>
+    <span class='object_link'><a href="Ionian/Server.html#protocol-instance_method" title="Ionian::Server#protocol (method)">#protocol</a></span>
+    <small>Ionian::Server</small>
   </li>
   
 
@@ -412,6 +412,18 @@
   
 
   <li class="r1 ">
+    <span class='object_link'><a href="Ionian/Extension/IO.html#register_error_handler-instance_method" title="Ionian::Extension::IO#register_error_handler (method)">#register_error_handler</a></span>
+    <small>Ionian::Extension::IO</small>
+  </li>
+  
+
+  <li class="r2 ">
+    <span class='object_link'><a href="Ionian/Extension/IO.html#register_match_handler-instance_method" title="Ionian::Extension::IO#register_match_handler (method)">#register_match_handler</a></span>
+    <small>Ionian::Extension::IO</small>
+  </li>
+  
+
+  <li class="r1 deprecated">
     <span class='object_link'><a href="Ionian/Extension/IO.html#register_observer-instance_method" title="Ionian::Extension::IO#register_observer (method)">#register_observer</a></span>
     <small>Ionian::Extension::IO</small>
   </li>
@@ -460,6 +472,18 @@
   
 
   <li class="r1 ">
+    <span class='object_link'><a href="Ionian/Extension/IO.html#unregister_error_handler-instance_method" title="Ionian::Extension::IO#unregister_error_handler (method)">#unregister_error_handler</a></span>
+    <small>Ionian::Extension::IO</small>
+  </li>
+  
+
+  <li class="r2 ">
+    <span class='object_link'><a href="Ionian/Extension/IO.html#unregister_match_handler-instance_method" title="Ionian::Extension::IO#unregister_match_handler (method)">#unregister_match_handler</a></span>
+    <small>Ionian::Extension::IO</small>
+  </li>
+  
+
+  <li class="r1 deprecated">
     <span class='object_link'><a href="Ionian/Extension/IO.html#unregister_observer-instance_method" title="Ionian::Extension::IO#unregister_observer (method)">#unregister_observer</a></span>
     <small>Ionian::Extension::IO</small>
   </li>

data/doc/top-level-namespace.html

@@ -103,7 +103,7 @@
 </div>
 
     <div id="footer">
-  Generated on Fri Jan 23 20:34:47 2015 by
+  Generated on Mon Jan 26 21:45:48 2015 by
   <a href="http://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
   0.8.7.6 (ruby-2.1.5).
 </div>

data/lib/ionian/extension/io.rb

@@ -21,12 +21,13 @@ module Ionian
       # Initialize the Ionian instance variables.
       # This is called automatically if #extend is called on an object.
       def initialize_ionian
-        @ionian_listeners     = []
-        @ionian_buf           = ''
-        @ionian_expression    = /(.*?)[\r\n]+/
-        @ionian_timeout       = nil
-        @ionian_skip_select   = false
-        @ionian_build_methods = true
+        @ionian_match_handlers = []
+        @ionian_error_handlers = []
+        @ionian_buf            = ''
+        @ionian_expression     = /(.*?)[\r\n]+/
+        @ionian_timeout        = nil
+        @ionian_skip_select    = false
+        @ionian_build_methods  = true
       end
       
       # @return [Boolean] True if there is data in the receive buffer.
@@ -94,7 +95,7 @@ module Ionian
       #   match for this single method call.
       # 
       # @option kwargs [Boolean] :notify (true) Set to false to skip notifying
-      #   match listener procs.
+      #   match handler procs.
       # 
       # @option kwargs [Boolean] :skip_select (false) Skip over the
       #   IO::select statement. Use if you are calling IO::select ahead of
@@ -142,27 +143,27 @@ module Ionian
         # Pass each match to block.
         @matches.each { |match| yield match } if block_given?
         
-        # Notify on_match listeners unless the #run_match thread is active.
-        @matches.each { |match| notify_listeners match } \
-          if notify and not @match_listener
+        # Notify on_match handlers unless the #run_match thread is active.
+        @matches.each { |match| notify_match_handlers match } \
+          if notify and not @run_match_thread
         
         @matches
       end
      
-      # Start a thread that checks for data and notifies listeners (do |match, socket|).
+      # Start a thread that checks for data and notifies match and error handlers.
       # Passes kwargs to {#read_match}.
       # This method SHOULD NOT be used if {#read_match} is used.
       def run_match **kwargs
-        @match_listener ||= Thread.new do
+        @run_match_thread ||= Thread.new do
           begin
             while not closed? do
               matches = read_match **kwargs
-              matches.each { |match| notify_listeners match } if matches
+              matches.each { |match| notify_match_handlers match } if matches
             end
-          rescue EOFError
-          rescue IOError
+          rescue Exception => e
+            notify_error_handlers e
           ensure
-            @match_listener = nil
+            @run_match_thread = nil
           end
         end
       end
@@ -177,23 +178,51 @@ module Ionian
       
       # Register a block to be called when {#run_match} receives matched data.
       # Method callbacks can be registered with &object.method(:method).
-      # Returns a reference to the given block.
+      # @return [Block] a reference to the given block.
+      # @yield [MatchData, self] Regex match.
       # 
       # @example
-      #   registered_block = ionian_socket.register_observer { |match| ... }
+      #   registered_block = ionian_socket.register_match_handler { |match| ... }
       # 
       # @example
-      #   registered_block = ionian_socket.register_observer &my_object.method(:foo)
-      def register_observer &block
-        @ionian_listeners << block unless @ionian_listeners.include? block
+      #   registered_block = ionian_socket.register_match_handler &my_object.method(:foo)
+      def register_match_handler &block
+        @ionian_match_handlers << block unless @ionian_match_handlers.include? block
         block
       end
       
-      alias_method :on_match, :register_observer
+      alias_method :on_match, :register_match_handler
+      
+      # @deprecated Use {#register_match_handler} instead.
+      def register_observer &block
+        register_match_handler &block
+      end
       
       # Unregister a block from being called when matched data is received.
+      def unregister_match_handler &block
+        @ionian_match_handlers.delete_if { |o| o == block }
+        block
+      end
+      
+      # @deprecated Use {#unregister_match_handler} instead.
       def unregister_observer &block
-        @ionian_listeners.delete_if { |o| o == block }
+        unregister_match_handler &block
+      end
+      
+      # Register a block to be called when {#run_match} raises an error.
+      # Method callbacks can be registered with &object.method(:method).
+      # @return [Block] a reference to the given block.
+      # @yield [Exception, self]
+      def register_error_handler &block
+        @ionian_error_handlers << block unless @ionian_error_handlers.include? block
+        block
+      end
+      
+      alias_method :on_error, :register_error_handler
+      
+      # Unregister a block from being called when a {#run_match} error is raised.
+      def unregister_error_handler &block
+        @ionian_error_handlers.delete_if { |o| o == block }
         block
       end
       
@@ -202,8 +231,14 @@ module Ionian
       
       # Send match to each of the registered observers. Includes self
       # as the second block parameter.
-      def notify_listeners match
-        @ionian_listeners.each { |listener| listener.call match, self }
+      def notify_match_handlers match
+        @ionian_match_handlers.each { |handler| handler.call match, self }
+      end
+      
+      # Send exception to each of the registered observers. Includes self
+      # as the second block parameter.
+      def notify_error_handlers exception
+        @ionian_error_handlers.each { |handler| handler.call exception, self }
       end
     
     end

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: ionian
 version: !ruby/object:Gem::Version
-  version: 0.6.11
+  version: 0.6.12
 platform: ruby
 authors:
 - Alex McLain
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2015-01-23 00:00:00.000000000 Z
+date: 2015-01-26 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rake