backtracie 0.1.0 → 0.3.0

data/ext/backtracie_native_extension/{ruby_3.0.0.c → ruby_shards.h}

@@ -78,119 +78,93 @@
 //    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
 //    PURPOSE.
 
-#include "rb_mjit_min_header-3.0.0.h"
+#ifndef RUBY_SHARDS_H
+#define RUBY_SHARDS_H
 
-#include "ruby_3.0.0.h"
+// -----------------------------------------------------------------------------
 
 /**********************************************************************
+  method.h -
+  created at: Wed Jul 15 20:02:33 2009
+  Copyright (C) 2009 Koichi Sasada
+**********************************************************************/
+
+  #ifdef PRE_MJIT_RUBY
+    #include <stdbool.h>
+    #include <vm_core.h>
+    #include <method.h>
+  #else
+  #ifndef RUBY_MJIT_HEADER_INCLUDED
+    typedef enum {
+      VM_METHOD_TYPE_ISEQ,      /*!< Ruby method */
+      VM_METHOD_TYPE_CFUNC,     /*!< C method */
+      VM_METHOD_TYPE_ATTRSET,   /*!< attr_writer or attr_accessor */
+      VM_METHOD_TYPE_IVAR,      /*!< attr_reader or attr_accessor */
+      VM_METHOD_TYPE_BMETHOD,
+      VM_METHOD_TYPE_ZSUPER,
+      VM_METHOD_TYPE_ALIAS,
+      VM_METHOD_TYPE_UNDEF,
+      VM_METHOD_TYPE_NOTIMPLEMENTED,
+      VM_METHOD_TYPE_OPTIMIZED, /*!< Kernel#send, Proc#call, etc */
+      VM_METHOD_TYPE_MISSING,   /*!< wrapper for method_missing(id) */
+      VM_METHOD_TYPE_REFINED,   /*!< refinement */
+    } rb_method_type_t;
+  #endif
+  #endif
 
-  vm_backtrace.c -
+// -----------------------------------------------------------------------------
 
-  $Author: ko1 $
-  created at: Sun Jun 03 00:14:20 2012
+typedef struct {
+  unsigned int is_ruby_frame : 1; // 1 -> ruby frame / 0 -> cfunc frame
+
+  // for ruby frames where the callable_method_entry is not of type VM_METHOD_TYPE_ISEQ, most of the metadata we
+  // want can be found by querying the iseq, and there may not even be an callable_method_entry
+  unsigned int should_use_iseq : 1;
+
+  rb_method_type_t vm_method_type;
+  int line_number;
+  VALUE iseq;
+  VALUE callable_method_entry;
+  VALUE self;
+  VALUE original_id;
+} raw_location;
+
+int backtracie_rb_profile_frames(int limit, raw_location *raw_locations);
+int backtracie_rb_profile_frames_for_thread(VALUE thread, int limit, raw_location *raw_locations);
+bool backtracie_is_thread_alive(VALUE thread);
+VALUE backtracie_called_id(raw_location *the_location);
+VALUE backtracie_defined_class(raw_location *the_location);
+bool backtracie_iseq_is_block(raw_location *the_location);
+bool backtracie_iseq_is_eval(raw_location *the_location);
+VALUE backtracie_refinement_name(raw_location *the_location);
 
-  Copyright (C) 1993-2012 Yukihiro Matsumoto
+// -----------------------------------------------------------------------------
 
-**********************************************************************/
+  // Ruby 3.0 finally added support for showing "cfunc frames" (frames for methods written in C) in stack traces:
+  // https://github.com/ruby/ruby/pull/3299/files
+  //
+  // The diff is rather trivial, and it makes a world of difference, given how most of Ruby's core classes are written in C.
+  // Thus, the methods below are copied from that PR so that we can make use of this functionality on older Ruby versions.
+  #ifdef CFUNC_FRAMES_BACKPORT_NEEDED
+    #define backtracie_rb_profile_frame_method_name backported_rb_profile_frame_method_name
+
+    VALUE backported_rb_profile_frame_method_name(VALUE frame);
+  #else // Ruby > 3.0, just use the stock functionality
+    #define backtracie_rb_profile_frame_method_name rb_profile_frame_method_name
+  #endif
+
+  // Backport https://github.com/ruby/ruby/pull/3084 (present in 2.7 and 3.0) to Ruby <= 2.6
+  // The interesting bit is actually the fix to rb_profile_frame_classpath BUT since rb_profile_frame_qualified_method_name
+  // internally relies on rb_profile_frame_classpath we also need to add a copy of that one as well.
+  #ifdef CLASSPATH_BACKPORT_NEEDED
+    #define backtracie_rb_profile_frame_classpath backported_rb_profile_frame_classpath
+    #define backtracie_rb_profile_frame_qualified_method_name backported_rb_profile_frame_qualified_method_name
+
+    VALUE backported_rb_profile_frame_classpath(VALUE frame);
+    VALUE backported_rb_profile_frame_qualified_method_name(VALUE frame);
+  #else
+    #define backtracie_rb_profile_frame_classpath rb_profile_frame_classpath
+    #define backtracie_rb_profile_frame_qualified_method_name rb_profile_frame_qualified_method_name
+  #endif
 
-inline static int
-calc_lineno(const rb_iseq_t *iseq, const VALUE *pc)
-{
-    VM_ASSERT(iseq);
-    VM_ASSERT(iseq->body);
-    VM_ASSERT(iseq->body->iseq_encoded);
-    VM_ASSERT(iseq->body->iseq_size);
-    if (! pc) {
-        /* This can happen during VM bootup. */
-        VM_ASSERT(iseq->body->type == ISEQ_TYPE_TOP);
-        VM_ASSERT(! iseq->body->local_table);
-        VM_ASSERT(! iseq->body->local_table_size);
-        return 0;
-    }
-    else {
-        ptrdiff_t n = pc - iseq->body->iseq_encoded;
-        VM_ASSERT(n <= iseq->body->iseq_size);
-        VM_ASSERT(n >= 0);
-        ASSUME(n >= 0);
-        size_t pos = n; /* no overflow */
-        if (LIKELY(pos)) {
-            /* use pos-1 because PC points next instruction at the beginning of instruction */
-            pos--;
-        }
-#if VMDEBUG && defined(HAVE_BUILTIN___BUILTIN_TRAP)
-        else {
-            /* SDR() is not possible; that causes infinite loop. */
-            rb_print_backtrace();
-            __builtin_trap();
-        }
 #endif
-        return rb_iseq_line_no(iseq, pos);
-    }
-}
-
-int modified_rb_profile_frames_for_execution_context(
-  rb_execution_context_t *ec,
-  int start,
-  int limit,
-  VALUE *buff,
-  VALUE *correct_labels,
-  int *lines
-) {
-    int i;
-    const rb_control_frame_t *cfp = ec->cfp, *end_cfp = RUBY_VM_END_CONTROL_FRAME(ec);
-    const rb_callable_method_entry_t *cme;
-
-    for (i=0; i<limit && cfp != end_cfp;) {
-        if (VM_FRAME_RUBYFRAME_P(cfp)) {
-            if (start > 0) {
-                start--;
-                continue;
-            }
-
-            // Stash the iseq so we can use it for the label. Otherwise ./spec/unit/backtracie_spec.rb:53 used to fail with
-            //   expected: "block (3 levels) in fetch_or_store"
-            //   got: "fetch_or_store"
-            // ...but works with this hack.
-            correct_labels[i] = (VALUE) cfp->iseq;
-
-            /* record frame info */
-            cme = rb_vm_frame_method_entry(cfp);
-            if (cme && cme->def->type == VM_METHOD_TYPE_ISEQ) {
-                buff[i] = (VALUE)cme;
-            }
-            else {
-                buff[i] = (VALUE)cfp->iseq;
-            }
-
-            if (lines) lines[i] = calc_lineno(cfp->iseq, cfp->pc);
-
-            i++;
-        }
-        else {
-            cme = rb_vm_frame_method_entry(cfp);
-            if (cme && cme->def->type == VM_METHOD_TYPE_CFUNC) {
-                buff[i] = (VALUE)cme;
-                if (lines) lines[i] = 0;
-                i++;
-            }
-        }
-
-        cfp = RUBY_VM_PREVIOUS_CONTROL_FRAME(cfp);
-    }
-
-    return i;
-}
-
-int modified_rb_profile_frames(int start, int limit, VALUE *buff, VALUE *correct_labels, int *lines) {
-  return modified_rb_profile_frames_for_execution_context(GET_EC(), start, limit, buff, correct_labels, lines);
-}
-
-int modified_rb_profile_frames_for_thread(VALUE thread, int start, int limit, VALUE *buff, VALUE *correct_labels, int *lines) {
-  // In here we're assuming that what we got is really a Thread or its subclass. This assumption NEEDS to be verified by
-  // the caller, otherwise I see a segfault in your future.
-  rb_thread_t *thread_pointer = (rb_thread_t*) DATA_PTR(thread);
-
-  if (thread_pointer->to_kill || thread_pointer->status == THREAD_KILLED) return Qnil;
-
-  return modified_rb_profile_frames_for_execution_context(thread_pointer->ec, start, limit, buff, correct_labels, lines);
-}

data/lib/backtracie/location.rb

@@ -26,15 +26,17 @@ module Backtracie
     attr_accessor :label
     attr_accessor :lineno
     attr_accessor :path
+    attr_accessor :qualified_method_name
 
     # Note: The order of arguments is hardcoded in the native extension in the `new_location` function --
     # keep them in sync
-    def initialize(absolute_path, base_label, label, lineno, path, debug)
+    def initialize(absolute_path, base_label, label, lineno, path, qualified_method_name, debug)
       @absolute_path = absolute_path
       @base_label = base_label
       @label = label
       @lineno = lineno
       @path = path
+      @qualified_method_name = qualified_method_name
       @debug = debug
 
       freeze
@@ -47,5 +49,14 @@ module Backtracie
         "#{@path}:in `#{@label}'"
       end
     end
+
+    # Still WIP
+    def fancy_to_s
+      if @lineno != 0
+        "#{@path}:#{@lineno}:in #{@qualified_method_name}"
+      else
+        "#{@path}:in #{@qualified_method_name}"
+      end
+    end
   end
 end

data/lib/backtracie/version.rb

@@ -19,5 +19,5 @@
 # along with backtracie.  If not, see <http://www.gnu.org/licenses/>.
 
 module Backtracie
-  VERSION = "0.1.0"
+  VERSION = "0.3.0"
 end

data/lib/backtracie.rb

@@ -28,8 +28,17 @@ require "backtracie_native_extension"
 module Backtracie
   module_function
 
-  def caller_locations
-    Primitive.caller_locations
+  if RUBY_VERSION < "2.5"
+    def caller_locations
+      # FIXME: We're having some trouble getting the current thread on older Rubies, see the FIXME on
+      # backtracie_rb_profile_frames. A workaround is to just pass in the reference to the current thread explicitly
+      # (and slice off a few frames, since caller_locations is supposed to start from the caller of our caller)
+      backtrace_locations(Thread.current)[3..-1]
+    end
+  else
+    def caller_locations
+      Primitive.caller_locations
+    end
   end
 
   # Defined via native code only; not redirecting via Primitive to avoid an extra stack frame on the stack

metadata

@@ -1,41 +1,53 @@
 --- !ruby/object:Gem::Specification
 name: backtracie
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.3.0
 platform: ruby
 authors:
 - Ivo Anjo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-12 00:00:00.000000000 Z
-dependencies: []
+date: 2021-09-16 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: debase-ruby_core_source
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.10.12
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '0.10'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 0.10.12
 description: Ruby gem for beautiful backtraces
 email:
 - ivo@ivoanjo.me
 executables: []
-extensions: []
+extensions:
+- ext/backtracie_native_extension/extconf.rb
 extra_rdoc_files: []
 files:
 - ".editorconfig"
-- ".gitignore"
-- ".rspec"
-- ".ruby-version"
-- ".standard.yml"
 - CODE_OF_CONDUCT.adoc
 - COPYING
 - COPYING.LESSER
-- DEVELOPMENT_NOTES.adoc
 - README.adoc
-- Rakefile
 - backtracie.gemspec
-- bin/console
-- bin/setup
 - ext/backtracie_native_extension/backtracie.c
 - ext/backtracie_native_extension/extconf.rb
-- ext/backtracie_native_extension/ruby_3.0.0.c
-- ext/backtracie_native_extension/ruby_3.0.0.h
-- gems.rb
+- ext/backtracie_native_extension/ruby_shards.c
+- ext/backtracie_native_extension/ruby_shards.h
 - lib/backtracie.rb
 - lib/backtracie/location.rb
 - lib/backtracie/version.rb
@@ -52,14 +64,14 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: 3.0.0
+      version: 2.3.0
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.1.4
 signing_key: 
 specification_version: 4
 summary: Ruby gem for beautiful backtraces

data/.gitignore

@@ -1,33 +0,0 @@
-*.gem
-*.rbc
-/.config
-/coverage/
-/InstalledFiles
-/pkg/
-/spec/reports/
-/spec/examples.txt
-/test/tmp/
-/test/version_tmp/
-/tmp/
-
-# Used by dotenv library to load environment variables.
-# .env
-
-## Documentation cache and generated files:
-/.yardoc/
-/_yardoc/
-/doc/
-/rdoc/
-
-## Environment normalization:
-/.bundle/
-/vendor/bundle
-/lib/bundler/man/
-
-gems.locked
-Gemfile.lock
-
-*.o
-*.so
-ext/**/extconf.h
-ext/**/Makefile

data/.rspec

@@ -1,2 +0,0 @@
---require spec_helper
---order defined

data/.ruby-version

@@ -1 +0,0 @@
-ruby-3.0.0

data/.standard.yml

@@ -1,14 +0,0 @@
-# Currently we only support >= 3.0.0 but I suspect we'll be able to support as far back as the Ruby version that
-# introduced mjit without a lot of trouble, so let's avoid making the code dependent on 3.0-only features
-ruby_version: 2.6
-
-ignore:
-  - 'spec/unit/interesting_backtrace_helper.rb': # let's just say this file is special
-    - Lint/UselessTimes
-    - Style/EvalWithLocation
-    - Style/GlobalVars
-    - Style/MissingRespondToMissing
-  - 'ext/backtracie_native_extension/extconf.rb':
-    - Style/GlobalVars
-  - 'spec/unit/backtracie_spec.rb':
-    - Style/EvalWithLocation

data/DEVELOPMENT_NOTES.adoc

@@ -1,399 +0,0 @@
-= Development Notes
-
-== Ideas to explore
-
-=== Understand why `rb_profile_frames` does not return the correct iseq for a block.
-
-Given
-
-[source,ruby]
-----
-def run
-  puts "Backtracie: " + Backtracie.caller_locations.first.label
-  puts "Ruby:       " + caller_locations.first.label
-end
-
-def run2
-  1.times do
-    run
-  end
-end
-----
-
-the output is
-
-----
-Backtracie: run2
-Ruby:       block in run2
-----
-
-this is because inside `rb_profile_frames` the code goes
-
-[source,c]
-----
-/* record frame info */
-cme = rb_vm_frame_method_entry(cfp);
-if (cme && cme->def->type == VM_METHOD_TYPE_ISEQ) {
-  buff[i] = (VALUE)cme;
-}
-else {
-  buff[i] = (VALUE)cfp->iseq;
-}
-----
-
-and in this case the first branch is taken (we get the `cme`, not the `cfp->iseq`). I have no idea why.
-
-==== Update:
-
-When using the `cfp->iseq` instead of the `cme`, in many cases, the `full_label`, `classpath`, `qualified_method_name`, `singleton_method_p` and `first_lineno` become less accurate.
-
-Why "less accurate"? Consider the following slightly compacted diff taken with backtracie and either `cme` or `cfp->iseq usage`, using the `interesting_backtrace_helper.rb`, looking at the output in the debug fields for the `Backtracie::Location` instances:
-
-[source, diff]
-----
---- cfp->iseq
-+++ cme
-@@ -6,16 +6,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ClassA#hello",
-+    "hello",
-     18,
--    "ClassA",
-+    nil,
-     false,
-     "hello",
--    "ClassA#hello"],
-+    "hello"],
-@@ -23,16 +23,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ModuleB::ClassB#hello",
-+    "hello",
-     27,
--    "ModuleB::ClassB",
-+    nil,
-     false,
-     "hello",
--    "ModuleB::ClassB#hello"],
-+    "hello"],
-@@ -40,16 +40,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ModuleC.hello",
-+    "hello",
-     34,
--    "ModuleC",
--    true,
-+    nil,
-+    false,
-     "hello",
--    "ModuleC.hello"],
-+    "hello"],
-@@ -57,16 +57,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ClassWithStaticMethod.hello",
-+    "hello",
-     40,
--    "ClassWithStaticMethod",
--    true,
-+    nil,
-+    false,
-     "hello",
--    "ClassWithStaticMethod.hello"],
-+    "hello"],
-@@ -74,16 +74,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ModuleD#hello",
-+    "hello",
-     46,
--    "ModuleD",
-+    nil,
-     false,
-     "hello",
--    "ModuleD#hello"],
-+    "hello"],
-@@ -125,16 +125,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "#<ClassD:0x0000556485af28e8>.hello",
-+    "hello",
-     63,
--    "#<ClassD:0x0000556485af28e8>",
--    true,
-+    nil,
-+    false,
-     "hello",
--    "#<ClassD:0x0000556485af28e8>.hello"],
-+    "hello"],
-@@ -142,16 +142,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ClassE#hello",
-+    "hello",
-     68,
--    "ClassE",
-+    nil,
-     false,
-     "hello",
--    "ClassE#hello"],
-+    "hello"],
-@@ -176,16 +176,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "#<Module:0x0000556485af2140>#hello",
-+    "hello",
-     82,
--    "#<Module:0x0000556485af2140>",
-+    nil,
-     false,
-     "hello",
--    "#<Module:0x0000556485af2140>#hello"],
-+    "hello"],
-@@ -193,16 +193,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ModuleE.hello",
-+    "hello",
-     92,
--    "ModuleE",
--    true,
-+    nil,
-+    false,
-     "hello",
--    "ModuleE.hello"],
-+    "hello"],
-@@ -210,33 +210,33 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "method_missing",
-     "method_missing",
--    "ClassH#method_missing",
-+    "method_missing",
-     98,
--    "ClassH",
-+    nil,
-     false,
-     "method_missing",
--    "ClassH#method_missing"],
-+    "method_missing"],
-   @label="method_missing",
-   @lineno=101,
-   @path="/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb">,
-- #<Backtracie::Location:0x0000556486191a00
-+ #<Backtracie::Location:0x0000563ca3800df0
-   @absolute_path="/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-   @base_label="hello",
-   @debug=
-    ["/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-+    "block in hello",
-     "hello",
--    "hello",
--    "ClassF#hello",
--    106,
--    "ClassF",
-+    "block in hello",
-+    107,
-+    nil,
-     false,
-     "hello",
--    "ClassF#hello"],
--  @label="hello",
-+    "hello"],
-+  @label="block in hello",
-@@ -252,16 +252,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ClassF#hello",
-+    "hello",
-     106,
--    "ClassF",
-+    nil,
-     false,
-     "hello",
--    "ClassF#hello"],
-+    "hello"],
-@@ -286,16 +286,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "#<Class:0x0000556485af0a70>.hello",
-+    "hello",
-     121,
--    "#<Class:0x0000556485af0a70>",
--    true,
-+    nil,
-+    false,
-     "hello",
--    "#<Class:0x0000556485af0a70>.hello"],
-+    "hello"],
-@@ -303,16 +303,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "#<Class:0x0000556485af07a0>#hello",
-+    "hello",
-     126,
--    "#<Class:0x0000556485af07a0>",
-+    nil,
-     false,
-     "hello",
--    "#<Class:0x0000556485af07a0>#hello"],
-+    "hello"],
-@@ -320,16 +320,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "#<Module:0x0000556485af0430>.hello",
-+    "hello",
-     132,
--    "#<Module:0x0000556485af0430>",
--    true,
-+    nil,
-+    false,
-     "hello",
--    "#<Module:0x0000556485af0430>.hello"],
-+    "hello"],
-@@ -337,33 +337,33 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "method_with_complex_parameters",
-     "method_with_complex_parameters",
--    "Object#method_with_complex_parameters",
-+    "method_with_complex_parameters",
-     137,
--    "Object",
-+    nil,
-     false,
-     "method_with_complex_parameters",
--    "Object#method_with_complex_parameters"],
-+    "method_with_complex_parameters"],
-   @label="method_with_complex_parameters",
-   @lineno=138,
-   @path="/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb">,
-- #<Backtracie::Location:0x00005564861925e0
-+ #<Backtracie::Location:0x0000563ca3801d90
-   @absolute_path="/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-   @base_label="hello",
-   @debug=
-    ["/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-+    "block (2 levels) in hello",
-     "hello",
--    "hello",
--    "ClassJ#hello",
--    146,
--    "ClassJ",
-+    "block (2 levels) in hello",
-+    148,
-+    nil,
-     false,
-     "hello",
--    "ClassJ#hello"],
--  @label="hello",
-+    "hello"],
-@@ -371,33 +371,33 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello_helper",
-     "hello_helper",
--    "ClassJ#hello_helper",
-+    "hello_helper",
-     142,
--    "ClassJ",
-+    nil,
-     false,
-     "hello_helper",
--    "ClassJ#hello_helper"],
-+    "hello_helper"],
-   @label="hello_helper",
-   @lineno=143,
-   @path="/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb">,
-- #<Backtracie::Location:0x0000556486192928
-+ #<Backtracie::Location:0x0000563ca3801f70
-   @absolute_path="/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-   @base_label="hello",
-   @debug=
-    ["/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-+    "block in hello",
-     "hello",
--    "hello",
--    "ClassJ#hello",
--    146,
--    "ClassJ",
-+    "block in hello",
-+    147,
-+    nil,
-     false,
-     "hello",
--    "ClassJ#hello"],
--  @label="hello",
-+    "hello"],
-@@ -405,16 +405,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello_helper",
-     "hello_helper",
--    "ClassJ#hello_helper",
-+    "hello_helper",
-     142,
--    "ClassJ",
-+    nil,
-     false,
-     "hello_helper",
--    "ClassJ#hello_helper"],
-+    "hello_helper"],
-@@ -422,16 +422,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "hello",
-     "hello",
--    "ClassJ#hello",
-+    "hello",
-     146,
--    "ClassJ",
-+    nil,
-     false,
-     "hello",
--    "ClassJ#hello"],
-+    "hello"],
-@@ -439,16 +439,16 @@
-     "/ruby/backtracie/spec/unit/interesting_backtrace_helper.rb",
-     "top_level_hello",
-     "top_level_hello",
--    "Object#top_level_hello",
-+    "top_level_hello",
-     155,
--    "Object",
-+    nil,
-     false,
-     "top_level_hello",
--    "Object#top_level_hello"],
-+    "top_level_hello"],
-----
-
-We can see that we miss the information about module/class names (we only get methods), we lose the singleton info, etc. The `first_lineno` numbers that move (which is not very important since we get the exact line via a different method). The only thing that is correct in the `cfp->iseq` version is getting "block in method" in the few places where we were missing it.
-
-So clearly the `cme` version in upstream Ruby is correct almost all of the time, except for the `label` missing the "block in method" in a few cases.
-
-This seems to point to the "block in method" issue either being an implementation bug (I still don't quite understand what the two different objects being used here represent) OR more of a "limitation" -- perhaps it's awkward to provide the correct label on the objects that miss it, and since the current MRI object returns one `VALUE` per stack frame, not two, the slight issue is just ignored.
-
-== TODO
-
-* Benchmarking
-* Tackle FIXMEs
-* Support Ruby < 3.0
-* Support showing class name, e.g. https://ivoanjo.me/blog/2020/07/05/ruby-experiment-include-class-names-in-backtraces/
-* Go beyond class name, e.g. https://ivoanjo.me/blog/2020/07/19/better-backtraces-in-ruby-using-tracepoint/
-* Implement equivalents to `Kernel#caller`, `Thread#backtrace`
-* Implement limits (similar to the arguments passed to the regular Ruby APIs)
-* User documentation