enhanced_errors 3.0.2 → 3.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: dbb09107f2f0aa86f1d75a293adaa6088123f46bec7b93d2e521e27a7619b829
-  data.tar.gz: a735a7ae935b3718d24f391e55ca7685fafe507ed8ca72a6f79aca07422aad5e
+  metadata.gz: fcc0ec081a5d0c8971d430b9d87a241c5678d07037a661fc3202b9b5cc416840
+  data.tar.gz: c136809b9cb0927ec57f95df48a30020875dd0725c6c0efd3983235d8ae2cc82
 SHA512:
-  metadata.gz: 8de7cf2dddc8b575d191605a060a55c56fe13867edbd3b81de2c4fd21905f28de88695dd5e5b5de7a36dce5195165587977f1d3151edd2e19207efe8aac93ee7
-  data.tar.gz: 227b68eaeaa3050e9566067041d322ec121ae9331dad1e6bbed8686766efdcdc2608ab25dadce266acd04190ea490b8b347f5fb0710d785d9c7b0aedccc452c9
+  metadata.gz: 4d7c0b9e0ae3d02b32442b9a02c9c1b29f35051e2c0c4c9de085a60c11fa7d05b132602ebabfdc438f4721b579deefd561efa13c470324fa5ccd341015eabeee
+  data.tar.gz: b004525dd0f9dfa3327067b78b3cdf2a9db98bbfa75bd85dc348e220c7ab966d6b8360c0157e8bc23d39a8e8f65219e53c069ad242dda10cf83c5756e96fadf1

data/README.md

@@ -33,7 +33,6 @@ end
 <img src="./doc/images/enhanced-spec.png" style="height: 369px; width: 712px;"></img>
 
 
-
 The RSpec test-time only approach constrained only to test-time.
 
 ### RSpec Setup
@@ -148,6 +147,7 @@ EnhancedErrors use-cases:
 * Handle CI failures faster by skipping reproduction steps.
 * Address elusive "Heisenbugs" by capturing error context preemptively.
 * Debug cron jobs and daemons with rich, failure-specific logs.
+* LLM-food - Feed debug info with variables into an LLM, making state examine-able for it
 
 ## Installation
 
@@ -452,9 +452,10 @@ I would not enable it in production *yet*.
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at [https://github.com/your_username/enhanced_errors](https://github.com/your_username/enhanced_errors).
+Bug reports and pull requests are welcome on GitHub. 
+
+* Please include tests to demonstrate your contribution working.
 
 ## License
 
 The gem is available as open-source under the terms of the [MIT License](https://opensource.org/licenses/MIT).
-

data/benchmark/benchmark.rb

@@ -1,8 +1,15 @@
 require 'benchmark'
-require_relative '../lib/enhanced/enhanced' # Adjust the path if necessary
+require_relative '../lib/enhanced_errors' # Adjust the path if necessary
+
+#require 'profile'
+
+# In general, the results of this are--catching exception bindings is pretty cheap.
+# However, catching :call, :return, :b_return, :b_call are 100x more expensive.
+# Makes sense if you think about the relative frequency of things.
+
 
 # Define the number of iterations
-ITERATIONS = 10_000
+ITERATIONS = 1_000
 EXCEPTIONS_PER_BATCH = 100
 
 class Boo < StandardError; end
@@ -12,20 +19,8 @@ def calculate_cost(time_in_seconds)
   (milliseconds / (ITERATIONS / EXCEPTIONS_PER_BATCH)).round(2)
 end
 
-def with_enhanced_errors
-  EnhancedErrors.enhance_exceptions!(debug: false)
-  ITERATIONS.times do
-    begin
-      foo = 'bar'
-      @boo = 'baz'
-      raise 'Test exception with EnhancedErrors'
-    rescue => e
-      e.message
-    end
-  end
-end
 
-def without_enhanced_errors
+def raise_errors
   ITERATIONS.times do
     begin
       foo = 'bar'
@@ -38,8 +33,9 @@ def without_enhanced_errors
 end
 
 def when_capture_only_regexp_matched
+  rxp = /Boo/
   EnhancedErrors.enhance_exceptions!(debug: false) do
-    eligible_for_capture { |exception| !!/Boo/.match(exception.class.to_s) }
+    eligible_for_capture { |exception| !!rxp.match(exception.class.to_s) }
   end
 
   ITERATIONS.times do
@@ -54,8 +50,9 @@ def when_capture_only_regexp_matched
 end
 
 def when_capture_only_regexp_did_not_match
-  EnhancedErrors.enhance_exceptions!(debug: false) do
-    eligible_for_capture { |exception| !!/Baz/.match(exception.class.to_s) }
+  rxp = /Baz/
+  EnhancedErrors.enhance_exceptions!(override_messages: true) do
+    eligible_for_capture { |exception| !!rxp.match(exception.class.to_s) }
   end
 
   ITERATIONS.times do
@@ -71,18 +68,23 @@ end
 
 puts "Cost Exploration\n"
 Benchmark.bm(35) do |x|
-  without_time = x.report('10k Without EnhancedErrors:') { without_enhanced_errors }
-  with_time = x.report('10k With EnhancedErrors:') { with_enhanced_errors }
-
-  puts "\nCost per 100 exceptions (Without EnhancedErrors): #{calculate_cost(without_time.real)} ms"
-  puts "Cost per 100 exceptions (With EnhancedErrors): #{calculate_cost(with_time.real)} ms"
+  without_time = x.report('Baseline 1k (NO EnhancedErrors, tight error raise loop):') { raise_errors }
 end
 
-puts "\nProof that if you only match the classes you care about, the cost is nominal\n"
-Benchmark.bm(35) do |x|
-  matched_time = x.report('10k With capture_only_regexp match:') { when_capture_only_regexp_matched }
-  not_matched_time = x.report('10k Without capture_only_regexp match:') { when_capture_only_regexp_did_not_match }
+puts "\n"
+EnhancedErrors.enhance_exceptions!(debug: false)
 
-  puts "\nCost per 100 exceptions (Capture Only Match): #{calculate_cost(matched_time.real)} ms"
-  puts "Cost per 100 exceptions (No Match): #{calculate_cost(not_matched_time.real)} ms"
+Benchmark.bm(35) do |x|
+  with_time = x.report('Stress 1k EnhancedErrors  (Tight error raising loop w/ EnhancedErrors):') { raise_errors }
+  puts "Cost per 100 raised exceptions: #{calculate_cost(with_time.real)} ms"
 end
+
+
+# puts "\nProof that if you only match the classes you care about, the cost is nominal\n"
+# Benchmark.bm(35) do |x|
+#   matched_time = x.report('1k capture_only_regexp match (same as always-on) :') { when_capture_only_regexp_matched }
+#   not_matched_time = x.report('1k capture_only_regexp not matching (low-cost):') { when_capture_only_regexp_did_not_match }
+#
+#   puts "\nCost per 100 exceptions (Capture Only Match): #{calculate_cost(matched_time.real)} ms"
+#   puts "Cost per 100 exceptions (No Match): #{calculate_cost(not_matched_time.real)} ms"
+# end

data/benchmark/memory_bench.rb

@@ -71,7 +71,7 @@ def test_exception_with_large_variable(iterations, large_string)
   puts "Memory usage after exceptions: #{memory_usage} KB"
 end
 
-iterations = 10  # Adjust iterations as needed
+iterations = 10000  # Adjust iterations as needed
 
 test_with_tracepoint(iterations, large_string)
 test_without_tracepoint(iterations, large_string)

data/benchmark/result.txt

@@ -0,0 +1,13 @@
+Result from MacOs, Ruby 3.3.6 for benchmark.rb
+
+--------------------------------------------
+
+Cost Exploration
+                                                              user     system      total        real
+Baseline 1k (NO EnhancedErrors, tight error raise loop):  0.000296   0.000040   0.000336 (  0.000334)
+
+Cost per 100 raised exceptions: 0.56 ms
+                                                                             user     system      total        real
+Stress 1k EnhancedErrors  (Tight error raising loop w/ EnhancedErrors):  0.005498   0.000147   0.005645 (  0.005647)
+
+

data/doc/Enhanced/Colors.html

@@ -381,9 +381,9 @@
 </div>
 
       <div id="footer">
-  Generated on Tue Dec 17 21:43:58 2024 by
+  Generated on Tue Dec 24 15:27:20 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.1.3).
 </div>
 
     </div>

data/doc/Enhanced/Context.html

@@ -0,0 +1,283 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <meta charset="utf-8">
+<meta name="viewport" content="width=device-width, initial-scale=1.0">
+<title>
+  Class: Enhanced::Context
+  
+    &mdash; Documentation by YARD 0.9.37
+  
+</title>
+
+  <link rel="stylesheet" href="../css/style.css" type="text/css" />
+
+  <link rel="stylesheet" href="../css/common.css" type="text/css" />
+
+<script type="text/javascript">
+  pathId = "Enhanced::Context";
+  relpath = '../';
+</script>
+
+
+  <script type="text/javascript" charset="utf-8" src="../js/jquery.js"></script>
+
+  <script type="text/javascript" charset="utf-8" src="../js/app.js"></script>
+
+
+  </head>
+  <body>
+    <div class="nav_wrap">
+      <iframe id="nav" src="../class_list.html?1"></iframe>
+      <div id="resizer"></div>
+    </div>
+
+    <div id="main" tabindex="-1">
+      <div id="header">
+        <div id="menu">
+  
+    <a href="../_index.html">Index (C)</a> &raquo;
+    <span class='title'><span class='object_link'><a href="../Enhanced.html" title="Enhanced (module)">Enhanced</a></span></span>
+     &raquo; 
+    <span class="title">Context</span>
+  
+</div>
+
+        <div id="search">
+  
+    <a class="full_list_link" id="class_list_link"
+        href="../class_list.html">
+
+        <svg width="24" height="24">
+          <rect x="0" y="4" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="12" width="24" height="4" rx="1" ry="1"></rect>
+          <rect x="0" y="20" width="24" height="4" rx="1" ry="1"></rect>
+        </svg>
+    </a>
+  
+</div>
+        <div class="clear"></div>
+      </div>
+
+      <div id="content"><h1>Class: Enhanced::Context
+  
+  
+  
+</h1>
+<div class="box_info">
+  
+  <dl>
+    <dt>Inherits:</dt>
+    <dd>
+      <span class="inheritName">Object</span>
+      
+        <ul class="fullTree">
+          <li>Object</li>
+          
+            <li class="next">Enhanced::Context</li>
+          
+        </ul>
+        <a href="#" class="inheritanceTree">show all</a>
+      
+    </dd>
+  </dl>
+  
+
+  
+  
+  
+  
+  
+
+  
+
+  
+  <dl>
+    <dt>Defined in:</dt>
+    <dd>lib/enhanced/context.rb</dd>
+  </dl>
+  
+</div>
+
+
+
+
+
+  <h2>Instance Attribute Summary <small><a href="#" class="summary_toggle">collapse</a></small></h2>
+  <ul class="summary">
+    
+      <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#binding_infos-instance_method" title="#binding_infos (instance method)">#<strong>binding_infos</strong>  &#x21d2; Object </a>
+    
+
+    
+  </span>
+  
+  
+  
+    
+    
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>Returns the value of attribute binding_infos.</p>
+</div></span>
+  
+</li>
+
+    
+  </ul>
+
+
+
+
+  
+    <h2>
+      Instance Method Summary
+      <small><a href="#" class="summary_toggle">collapse</a></small>
+    </h2>
+
+    <ul class="summary">
+      
+        <li class="public ">
+  <span class="summary_signature">
+    
+      <a href="#initialize-instance_method" title="#initialize (instance method)">#<strong>initialize</strong>  &#x21d2; Context </a>
+    
+
+    
+  </span>
+  
+  
+    <span class="note title constructor">constructor</span>
+  
+  
+  
+  
+  
+  
+
+  
+    <span class="summary_desc"><div class='inline'>
+<p>A new instance of Context.</p>
+</div></span>
+  
+</li>
+
+      
+    </ul>
+  
+
+<div id="constructor_details" class="method_details_list">
+  <h2>Constructor Details</h2>
+  
+    <div class="method_details first">
+  <h3 class="signature first" id="initialize-instance_method">
+  
+    #<strong>initialize</strong>  &#x21d2; <tt><span class='object_link'><a href="" title="Enhanced::Context (class)">Context</a></span></tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Returns a new instance of Context.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+5
+6
+7</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/enhanced/context.rb', line 5</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_initialize'>initialize</span>
+  <span class='ivar'>@binding_infos</span> <span class='op'>=</span> <span class='lbracket'>[</span><span class='rbracket'>]</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+  
+</div>
+
+  <div id="instance_attr_details" class="attr_details">
+    <h2>Instance Attribute Details</h2>
+    
+      
+      <span id="binding_infos=-instance_method"></span>
+      <div class="method_details first">
+  <h3 class="signature first" id="binding_infos-instance_method">
+  
+    #<strong>binding_infos</strong>  &#x21d2; <tt>Object</tt> 
+  
+
+  
+
+  
+</h3><div class="docstring">
+  <div class="discussion">
+    
+<p>Returns the value of attribute binding_infos.</p>
+
+
+  </div>
+</div>
+<div class="tags">
+  
+
+</div><table class="source_code">
+  <tr>
+    <td>
+      <pre class="lines">
+
+
+3
+4
+5</pre>
+    </td>
+    <td>
+      <pre class="code"><span class="info file"># File 'lib/enhanced/context.rb', line 3</span>
+
+<span class='kw'>def</span> <span class='id identifier rubyid_binding_infos'>binding_infos</span>
+  <span class='ivar'>@binding_infos</span>
+<span class='kw'>end</span></pre>
+    </td>
+  </tr>
+</table>
+</div>
+    
+  </div>
+
+
+</div>
+
+      <div id="footer">
+  Generated on Tue Dec 24 15:27:20 2024 by
+  <a href="https://yardoc.org" title="Yay! A Ruby Documentation Tool" target="_parent">yard</a>
+  0.9.37 (ruby-3.1.3).
+</div>
+
+    </div>
+  </body>
+</html>