enhanced_errors 3.0.3 → 3.0.5

data/doc/index.html

@@ -97,29 +97,41 @@
 
 <p>Use EnhancedErrors with RSpec for test-specific exception capturing, ideal for CI and local testing without impacting production.</p>
 
-<pre class="code ruby"><code class="ruby">
+<pre class="code ruby"><code class="ruby"><span class='comment'># usually in spec_helper.rb or rails_helper.rb
+</span>
+<span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>enhanced_errors</span><span class='tstring_end'>&#39;</span></span>
+<span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>awesome_print</span><span class='tstring_end'>&#39;</span></span> <span class='comment'># Optional, for better output
+</span>
 <span class='const'>RSpec</span><span class='period'>.</span><span class='id identifier rubyid_configure'>configure</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_config'>config</span><span class='op'>|</span>
-  <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_before'>before</span><span class='lparen'>(</span><span class='symbol'>:example</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid__example'>_example</span><span class='op'>|</span>
-    <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_start_rspec_binding_capture'><span class='object_link'><a href="EnhancedErrors.html#start_rspec_binding_capture-class_method" title="EnhancedErrors.start_rspec_binding_capture (method)">start_rspec_binding_capture</a></span></span>
-  <span class='kw'>end</span>
-
-  <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_before'>before</span><span class='lparen'>(</span><span class='symbol'>:example</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid__example'>_example</span><span class='op'>|</span>
-    <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_start_rspec_binding_capture'><span class='object_link'><a href="EnhancedErrors.html#start_rspec_binding_capture-class_method" title="EnhancedErrors.start_rspec_binding_capture (method)">start_rspec_binding_capture</a></span></span>
-  <span class='kw'>end</span>
-
-  <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_after'>after</span><span class='lparen'>(</span><span class='symbol'>:example</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_example'>example</span><span class='op'>|</span>
-    <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_override_rspec_message'><span class='object_link'><a href="EnhancedErrors.html#override_rspec_message-class_method" title="EnhancedErrors.override_rspec_message (method)">override_rspec_message</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_example'>example</span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_stop_rspec_binding_capture'><span class='object_link'><a href="EnhancedErrors.html#stop_rspec_binding_capture-class_method" title="EnhancedErrors.stop_rspec_binding_capture (method)">stop_rspec_binding_capture</a></span></span><span class='rparen'>)</span>
-  <span class='kw'>end</span>
+  
+  <span class='comment'># Along with the requires, add this to your RSpec config to enhance your RSpec output
+</span>  <span class='comment'># Consider driving the config with an environment variable like this to make it configurable per-user or run
+</span>  <span class='comment'># if ENV[&#39;enhanced_errors&#39;] == &#39;true&#39;
+</span>      <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_before'>before</span><span class='lparen'>(</span><span class='symbol'>:example</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid__example'>_example</span><span class='op'>|</span>
+        <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_start_rspec_binding_capture'><span class='object_link'><a href="EnhancedErrors.html#start_rspec_binding_capture-class_method" title="EnhancedErrors.start_rspec_binding_capture (method)">start_rspec_binding_capture</a></span></span>
+      <span class='kw'>end</span>
+    
+      <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_before'>before</span><span class='lparen'>(</span><span class='symbol'>:example</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid__example'>_example</span><span class='op'>|</span>
+        <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_start_rspec_binding_capture'><span class='object_link'><a href="EnhancedErrors.html#start_rspec_binding_capture-class_method" title="EnhancedErrors.start_rspec_binding_capture (method)">start_rspec_binding_capture</a></span></span>
+      <span class='kw'>end</span>
+    
+      <span class='id identifier rubyid_config'>config</span><span class='period'>.</span><span class='id identifier rubyid_after'>after</span><span class='lparen'>(</span><span class='symbol'>:example</span><span class='rparen'>)</span> <span class='kw'>do</span> <span class='op'>|</span><span class='id identifier rubyid_example'>example</span><span class='op'>|</span>
+        <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_override_rspec_message'><span class='object_link'><a href="EnhancedErrors.html#override_rspec_message-class_method" title="EnhancedErrors.override_rspec_message (method)">override_rspec_message</a></span></span><span class='lparen'>(</span><span class='id identifier rubyid_example'>example</span><span class='comma'>,</span> <span class='const'><span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span></span><span class='period'>.</span><span class='id identifier rubyid_stop_rspec_binding_capture'><span class='object_link'><a href="EnhancedErrors.html#stop_rspec_binding_capture-class_method" title="EnhancedErrors.stop_rspec_binding_capture (method)">stop_rspec_binding_capture</a></span></span><span class='rparen'>)</span>
+      <span class='kw'>end</span>
+  <span class='comment'># end
+</span>  
 <span class='kw'>end</span>
 </code></pre>
 
 <p><br></p>
 
+<p>”””</p>
+
 <h2 id="label-MiniTest+Setup">MiniTest Setup</h2>
 
 <pre class="code ruby"><code class="ruby"><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>enhanced_errors</span><span class='tstring_end'>&#39;</span></span>
-<span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>enhanced/minitest_patch</span><span class='tstring_end'>&#39;</span></span>
-
+<span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>awesome_print</span><span class='tstring_end'>&#39;</span></span> <span class='comment'># Optional, for better output
+</span><span class='id identifier rubyid_require'>require</span> <span class='tstring'><span class='tstring_beg'>&#39;</span><span class='tstring_content'>enhanced/minitest_patch</span><span class='tstring_end'>&#39;</span></span>
 <span class='comment'># Once the patch is loaded, it should just work!
 </span></code></pre>
 
@@ -169,10 +181,14 @@
 
 <p>&lt;img src=“./doc/images/enhanced-error.png” style=“height: 215px; width: 429px;”&gt;&lt;/img&gt; <br></p>
 
+<p>EnhancedErrors use-cases: * Handle test and CI failures faster by skipping that pesky “reproduction” step. * LLM-candy - Feed debug output with variable values into your LLM, making state examine-able * Debug deep-stack errors and reduce mean time to resolution (MTTR). * Address elusive “Heisenbugs” by capturing full error context preemptively. * Debug cron jobs and daemons with rich, failure-specific logs. * Catch data-driven bugs in long jobs without re-runs or extensive logging.</p>
+
 <h2 id="label-Features">Features</h2>
 <ul><li>
 <p><strong>Pure Ruby</strong>: No external dependencies, C extensions, or C API calls.</p>
 </li><li>
+<p>**Improved RSpec and Minitest errors for straight-to-fix–look-ma-no-debugging, look-ma-no-reproducing</p>
+</li><li>
 <p><strong>Customizable Output</strong>: Supports multiple output formats (<code>:json</code>, <code>:plaintext</code>, <code>:terminal</code>).</p>
 </li><li>
 <p><strong>Flexible Hooks</strong>: Redact or modifying captured data via the <code>on_capture</code> hook. Update the final string with on_format.</p>
@@ -190,19 +206,6 @@
 <p><strong>Lightweight</strong>: Minimal performance impact, as tracing is only active during exception raising.</p>
 </li></ul>
 
-<p>EnhancedErrors use-cases:</p>
-<ul><li>
-<p>Catch data-driven bugs without needing re-runs or extensive logging.</p>
-</li><li>
-<p>Debug deep-stack errors and reduce mean time to resolution (MTTR).</p>
-</li><li>
-<p>Handle CI failures faster by skipping reproduction steps.</p>
-</li><li>
-<p>Address elusive “Heisenbugs” by capturing error context preemptively.</p>
-</li><li>
-<p>Debug cron jobs and daemons with rich, failure-specific logs.</p>
-</li></ul>
-
 <h2 id="label-Installation">Installation</h2>
 
 <p>Add this line to your <code>Gemfile</code>:</p>
@@ -267,13 +270,6 @@
 <p>Terminal Color output: Enabled</p>
 </li></ul>
 </li><li>
-<p><strong>Production</strong>:</p>
-<ul><li>
-<p>Output format: <code>:json</code></p>
-</li><li>
-<p>Terminal Color output: Disabled</p>
-</li></ul>
-</li><li>
 <p><strong>CI Environment</strong>:</p>
 <ul><li>
 <p>Output format: <code>:plaintext</code></p>
@@ -368,10 +364,6 @@
 <p>These exceptions are always ignored:</p>
 
 <pre class="code ruby"><code class="ruby"><span class='const'>SystemExit</span> <span class='const'>NoMemoryError</span> <span class='const'>SignalException</span> <span class='const'>Interrupt</span>
-<span class='const'>ScriptError</span> <span class='const'>LoadError</span> <span class='const'>NotImplementedError</span> <span class='const'>SyntaxError</span>
-<span class='const'>RSpec</span><span class='op'>::</span><span class='const'>Expectations</span><span class='op'>::</span><span class='const'>ExpectationNotMetError</span>
-<span class='const'>RSpec</span><span class='op'>::</span><span class='const'>Matchers</span><span class='op'>::</span><span class='const'>BuiltIn</span><span class='op'>::</span><span class='const'>RaiseError</span>
-<span class='const'>SystemStackError</span> <span class='const'>Psych</span><span class='op'>::</span><span class='const'>BadAlias</span>
 </code></pre>
 
 <p>While this is close to “Things that don’t descend from StandardError”, it’s not exactly that.</p>
@@ -458,7 +450,7 @@
 <ul><li>
 <p>EnhancedErrors won’t interrupt CI, but it lets me know what happened <em>without</em> reproduction steps</p>
 </li><li>
-<p>EnhancedErrors could, theoretically, also be fine in production (if data security, redaction, PII, access, and encryption concerns were all addressed. Big list, but another option is to selectively enable targeted capture.</p>
+<p>EnhancedErrors could, theoretically, be fine in production (if data security, redaction, PII, access, and encryption concerns were addressed). Big list, but another option is to selectively enable targeted capture. The hooks provide a place to handle things of this sort.</p>
 </li><li>
 <p>Has decent performance characteristics</p>
 </li><li>
@@ -471,14 +463,17 @@
 <ul><li>
 <p><strong>Small Overhead</strong>: Since TracePoint is only activated during exception raising and rescuing, the performance impact is negligible during normal operation. (Benchmark included)</p>
 </li><li>
-<p><strong>TBD</strong>: Memory considerations. This does capture data when an exception happens. EnhancedErrors hides under the bed when it sees <strong>NoMemoryError</strong>.</p>
+<p><strong>TBD</strong>: Memory considerations. This does capture data when an exception happens. EnhancedErrors hides under the bed when it sees the scariest exceptions.</p>
 </li><li>
-<p><strong>Goal: Production Safety</strong>: The gem is designed to, eventually, be made safe for production use, giving you valuable insights without compromising performance. I would not enable it in production <em>yet</em>.</p>
+<p><strong>Goal: Production Safety</strong>: The gem is designed to, eventually, be suitable for production use. I might not enable it in production <em>yet</em> as it is pretty new. It would require a thoughtful approach (perhaps behind a feature flag, or only capturing targeted exceptions via the eligible for capture feature).</p>
 </li></ul>
 
 <h2 id="label-Contributing">Contributing</h2>
 
-<p>Bug reports and pull requests are welcome on GitHub at <a href="https://github.com/your_username/enhanced_errors">github.com/your_username/enhanced_errors</a>.</p>
+<p>Bug reports and pull requests are welcome on GitHub.</p>
+<ul><li>
+<p>Please include tests to demonstrate your contribution working.</p>
+</li></ul>
 
 <h2 id="label-License">License</h2>
 
@@ -486,9 +481,9 @@
 </div></div>
 
       <div id="footer">
-  Generated on Tue Dec 17 21:43:58 2024 by
+  Generated on Wed Dec 25 13:01:48 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.3.6).
+  0.9.37 (ruby-3.4.1).
 </div>
 
     </div>

data/doc/method_list.html

@@ -73,16 +73,16 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="Context.html#binding_infos-instance_method" title="Context#binding_infos (method)">#binding_infos</a></span>
-      <small>Context</small>
+      <span class='object_link'><a href="Enhanced/Context.html#binding_infos-instance_method" title="Enhanced::Context#binding_infos (method)">#binding_infos</a></span>
+      <small>Enhanced::Context</small>
     </div>
   </li>
   
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="ExceptionBindingInfos.html#binding_infos-instance_method" title="ExceptionBindingInfos#binding_infos (method)">#binding_infos</a></span>
-      <small>ExceptionBindingInfos</small>
+      <span class='object_link'><a href="Enhanced/ExceptionBindingInfos.html#binding_infos-instance_method" title="Enhanced::ExceptionBindingInfos#binding_infos (method)">#binding_infos</a></span>
+      <small>Enhanced::ExceptionBindingInfos</small>
     </div>
   </li>
   
@@ -113,8 +113,8 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="ExceptionBindingInfos.html#captured_variables-instance_method" title="ExceptionBindingInfos#captured_variables (method)">#captured_variables</a></span>
-      <small>ExceptionBindingInfos</small>
+      <span class='object_link'><a href="Enhanced/ExceptionBindingInfos.html#captured_variables-instance_method" title="Enhanced::ExceptionBindingInfos#captured_variables (method)">#captured_variables</a></span>
+      <small>Enhanced::ExceptionBindingInfos</small>
     </div>
   </li>
   
@@ -129,16 +129,16 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="EnhancedExceptionContext.html#clear_all-instance_method" title="EnhancedExceptionContext#clear_all (method)">#clear_all</a></span>
-      <small>EnhancedExceptionContext</small>
+      <span class='object_link'><a href="Enhanced/ExceptionContext.html#clear_all-instance_method" title="Enhanced::ExceptionContext#clear_all (method)">#clear_all</a></span>
+      <small>Enhanced::ExceptionContext</small>
     </div>
   </li>
   
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="EnhancedExceptionContext.html#clear_context-instance_method" title="EnhancedExceptionContext#clear_context (method)">#clear_context</a></span>
-      <small>EnhancedExceptionContext</small>
+      <span class='object_link'><a href="Enhanced/ExceptionContext.html#clear_context-instance_method" title="Enhanced::ExceptionContext#clear_context (method)">#clear_context</a></span>
+      <small>Enhanced::ExceptionContext</small>
     </div>
   </li>
   
@@ -169,8 +169,8 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="EnhancedExceptionContext.html#context_for-instance_method" title="EnhancedExceptionContext#context_for (method)">#context_for</a></span>
-      <small>EnhancedExceptionContext</small>
+      <span class='object_link'><a href="Enhanced/ExceptionContext.html#context_for-instance_method" title="Enhanced::ExceptionContext#context_for (method)">#context_for</a></span>
+      <small>Enhanced::ExceptionContext</small>
     </div>
   </li>
   
@@ -257,8 +257,8 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="Context.html#initialize-instance_method" title="Context#initialize (method)">#initialize</a></span>
-      <small>Context</small>
+      <span class='object_link'><a href="Enhanced/Context.html#initialize-instance_method" title="Enhanced::Context#initialize (method)">#initialize</a></span>
+      <small>Enhanced::Context</small>
     </div>
   </li>
   
@@ -401,7 +401,7 @@
 
   <li class="odd ">
     <div class="item">
-      <span class='object_link'><a href="EnhancedErrors.html#skip_list-class_method" title="EnhancedErrors.skip_list (method)">skip_list</a></span>
+      <span class='object_link'><a href="EnhancedErrors.html#safe_to_inspect%3F-class_method" title="EnhancedErrors.safe_to_inspect? (method)">safe_to_inspect?</a></span>
       <small>EnhancedErrors</small>
     </div>
   </li>
@@ -409,13 +409,21 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="EnhancedErrors.html#start_minitest_binding_capture-class_method" title="EnhancedErrors.start_minitest_binding_capture (method)">start_minitest_binding_capture</a></span>
+      <span class='object_link'><a href="EnhancedErrors.html#skip_list-class_method" title="EnhancedErrors.skip_list (method)">skip_list</a></span>
       <small>EnhancedErrors</small>
     </div>
   </li>
   
 
   <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="EnhancedErrors.html#start_minitest_binding_capture-class_method" title="EnhancedErrors.start_minitest_binding_capture (method)">start_minitest_binding_capture</a></span>
+      <small>EnhancedErrors</small>
+    </div>
+  </li>
+  
+
+  <li class="even ">
     <div class="item">
       <span class='object_link'><a href="EnhancedErrors.html#start_rspec_binding_capture-class_method" title="EnhancedErrors.start_rspec_binding_capture (method)">start_rspec_binding_capture</a></span>
       <small>EnhancedErrors</small>
@@ -423,6 +431,14 @@
   </li>
   
 
+  <li class="odd ">
+    <div class="item">
+      <span class='object_link'><a href="EnhancedErrors.html#start_rspec_binding_trap-class_method" title="EnhancedErrors.start_rspec_binding_trap (method)">start_rspec_binding_trap</a></span>
+      <small>EnhancedErrors</small>
+    </div>
+  </li>
+  
+
   <li class="even ">
     <div class="item">
       <span class='object_link'><a href="EnhancedErrors.html#stop_minitest_binding_capture-class_method" title="EnhancedErrors.stop_minitest_binding_capture (method)">stop_minitest_binding_capture</a></span>
@@ -441,8 +457,8 @@
 
   <li class="even ">
     <div class="item">
-      <span class='object_link'><a href="EnhancedExceptionContext.html#store_context-instance_method" title="EnhancedExceptionContext#store_context (method)">#store_context</a></span>
-      <small>EnhancedExceptionContext</small>
+      <span class='object_link'><a href="Enhanced/ExceptionContext.html#store_context-instance_method" title="Enhanced::ExceptionContext#store_context (method)">#store_context</a></span>
+      <small>Enhanced::ExceptionContext</small>
     </div>
   </li>
   

data/doc/top-level-namespace.html

@@ -82,11 +82,11 @@
 <p class="children">
   
     
-      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Enhanced.html" title="Enhanced (module)">Enhanced</a></span>, <span class='object_link'><a href="EnhancedExceptionContext.html" title="EnhancedExceptionContext (module)">EnhancedExceptionContext</a></span>, <span class='object_link'><a href="ExceptionBindingInfos.html" title="ExceptionBindingInfos (module)">ExceptionBindingInfos</a></span>, <span class='object_link'><a href="Minitest.html" title="Minitest (module)">Minitest</a></span>
+      <strong class="modules">Modules:</strong> <span class='object_link'><a href="Enhanced.html" title="Enhanced (module)">Enhanced</a></span>, <span class='object_link'><a href="Minitest.html" title="Minitest (module)">Minitest</a></span>
     
   
     
-      <strong class="classes">Classes:</strong> <span class='object_link'><a href="Context.html" title="Context (class)">Context</a></span>, <span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span>, <span class='object_link'><a href="Exception.html" title="Exception (class)">Exception</a></span>
+      <strong class="classes">Classes:</strong> <span class='object_link'><a href="EnhancedErrors.html" title="EnhancedErrors (class)">EnhancedErrors</a></span>, <span class='object_link'><a href="Exception.html" title="Exception (class)">Exception</a></span>
     
   
 </p>
@@ -100,11 +100,21 @@
     <dl class="constants">
       
         <dt id="IGNORED_EXCEPTIONS-constant" class="">IGNORED_EXCEPTIONS =
-          
+          <div class="docstring">
+  <div class="discussion">
+    
+<p>Exceptions we could handle but overlook for other reasons. These class constants are not always loaded and generally are only be available when ‘required`, so we detect them by strings.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div>
         </dt>
-        <dd><pre class="code"><span class='qwords_beg'>%w[</span><span class='tstring_content'>SystemExit</span><span class='words_sep'> </span><span class='tstring_content'>NoMemoryError</span><span class='words_sep'> </span><span class='tstring_content'>SignalException</span><span class='words_sep'> </span><span class='tstring_content'>Interrupt</span><span class='words_sep'> </span><span class='tstring_content'>ScriptError</span><span class='words_sep'> </span><span class='tstring_content'>LoadError</span><span class='words_sep'>
-</span><span class='tstring_content'>NotImplementedError</span><span class='words_sep'> </span><span class='tstring_content'>SyntaxError</span><span class='words_sep'> </span><span class='tstring_content'>RSpec::Expectations::ExpectationNotMetError</span><span class='words_sep'>
-</span><span class='tstring_content'>RSpec::Matchers::BuiltIn::RaiseError</span><span class='words_sep'> </span><span class='tstring_content'>SystemStackError</span><span class='words_sep'> </span><span class='tstring_content'>Psych::BadAlias</span><span class='tstring_end'>]</span></span></pre></dd>
+        <dd><pre class="code"><span class='qwords_beg'>%w[</span><span class='tstring_content'>RSpec::Expectations::ExpectationNotMetError</span><span class='words_sep'> </span><span class='tstring_content'>RSpec::Matchers::BuiltIn::RaiseError</span><span class='words_sep'>
+</span><span class='tstring_content'>JSON::ParserError</span><span class='words_sep'> </span><span class='tstring_content'>Zlib::Error</span><span class='words_sep'> </span><span class='tstring_content'>OpenSSL::SSL::SSLError</span><span class='words_sep'> </span><span class='tstring_content'>Psych::Exception</span><span class='tstring_end'>]</span></span></pre></dd>
       
     </dl>
   
@@ -120,9 +130,9 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Dec 17 21:43:58 2024 by
+  Generated on Wed Dec 25 13:01:48 2024 by
   <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
-  0.9.37 (ruby-3.3.6).
+  0.9.37 (ruby-3.4.1).
 </div>
 
     </div>

data/enhanced_errors.gemspec

@@ -1,6 +1,6 @@
 Gem::Specification.new do |spec|
   spec.name = "enhanced_errors"
-  spec.version = "3.0.3"
+  spec.version = "3.0.5"
   spec.authors = ["Eric Beland"]
 
   spec.summary = "Automatically enhance your errors with messages containing variable values from the moment they were raised."

data/lib/enhanced/context.rb

@@ -1,7 +1,9 @@
-class Context
-  attr_accessor :binding_infos
+module Enhanced
+  class Context
+    attr_accessor :binding_infos
 
-  def initialize
-    @binding_infos = []
+    def initialize
+      @binding_infos = []
+    end
   end
-end
+end

data/lib/enhanced/exception.rb

@@ -1,55 +1,54 @@
 # exception.rb
-require_relative 'enhanced_exception_context'
-
-module ExceptionBindingInfos
-  def binding_infos
-    ctx = EnhancedExceptionContext.context_for(self)
-    unless ctx
-      ctx = Context.new
-      EnhancedExceptionContext.store_context(self, ctx)
+require_relative 'exception_context'
+
+module Enhanced
+  module ExceptionBindingInfos
+    def binding_infos
+      ctx = Enhanced::ExceptionContext.context_for(self)
+      unless ctx
+        ctx = Context.new
+        Enhanced::ExceptionContext.store_context(self, ctx)
+      end
+      ctx.binding_infos
     end
-    ctx.binding_infos
-  end
 
-  def captured_variables
-    if binding_infos.any?
+    def captured_variables
+      return '' unless binding_infos&.any?
       bindings_of_interest = select_binding_infos
       EnhancedErrors.format(bindings_of_interest)
-    else
+    rescue
       ''
     end
-  rescue
-    ''
-  end
 
-  private
+    private
 
-  def select_binding_infos
-    # Preference:
-    # 1. First 'raise' binding that isn't from a library (gem).
-    # 2. If none, the first binding.
-    # 3. The last 'rescue' binding if available.
+    def select_binding_infos
+      # Preference:
+      # 1. First 'raise' binding that isn't from a library (gem).
+      # 2. If none, the first binding.
+      # 3. The last 'rescue' binding if available.
 
-    bindings_of_interest = []
+      bindings_of_interest = []
 
-    first_app_raise = binding_infos.find do |info|
-      info[:capture_event] == 'raise' && !info[:library]
-    end
-    bindings_of_interest << first_app_raise if first_app_raise
+      first_app_raise = binding_infos.find do |info|
+        info[:capture_event] == 'raise' && !info[:library]
+      end
+      bindings_of_interest << first_app_raise if first_app_raise
 
-    if bindings_of_interest.empty? && binding_infos.first
-      bindings_of_interest << binding_infos.first
-    end
+      if bindings_of_interest.empty? && binding_infos.first
+        bindings_of_interest << binding_infos.first
+      end
 
-    last_rescue = binding_infos.reverse.find do |info|
-      info[:capture_event] == 'rescue'
-    end
-    bindings_of_interest << last_rescue if last_rescue
+      last_rescue = binding_infos.reverse.find do |info|
+        info[:capture_event] == 'rescue'
+      end
+      bindings_of_interest << last_rescue if last_rescue
 
-    bindings_of_interest.compact
+      bindings_of_interest.compact
+    end
   end
 end
 
 class Exception
-  prepend ExceptionBindingInfos
+  prepend Enhanced::ExceptionBindingInfos
 end

data/lib/enhanced/exception_context.rb

@@ -0,0 +1,49 @@
+require 'weakref'
+
+require_relative 'context'
+
+require 'weakref'
+require 'monitor'
+
+module Enhanced
+  module ExceptionContext
+    extend self
+
+    REGISTRY = {}
+    MUTEX = Monitor.new
+
+    def store_context(exception, context)
+      MUTEX.synchronize do
+        REGISTRY[exception.object_id] = { weak_exc: WeakRef.new(exception), context: context }
+      end
+    end
+
+    def context_for(exception)
+      MUTEX.synchronize do
+        entry = REGISTRY[exception.object_id]
+        return nil unless entry
+
+        begin
+          _ = entry[:weak_exc].__getobj__ # ensure exception is still alive
+          entry[:context]
+        rescue RefError
+          # Exception no longer alive, clean up
+          REGISTRY.delete(exception.object_id)
+          nil
+        end
+      end
+    end
+
+    def clear_context(exception)
+      MUTEX.synchronize do
+        REGISTRY.delete(exception.object_id)
+      end
+    end
+
+    def clear_all
+      MUTEX.synchronize do
+        REGISTRY.clear
+      end
+    end
+  end
+end

data/lib/enhanced/minitest_patch.rb

@@ -9,7 +9,7 @@ module Minitest
       begin
         binding_infos = EnhancedErrors.stop_minitest_binding_capture
         EnhancedErrors.override_exception_message(result.failures.last, binding_infos) if result.failures.any?
-        EnhancedExceptionContext.clear_all
+        Enhanced::ExceptionContext.clear_all
       rescue => e
         puts "Ignored error during error enhancement: #{e}"
       end