backtracie 0.1.0 → 0.2.0

data/ext/backtracie_native_extension/ruby_shards.h

@@ -0,0 +1,175 @@
+// backtracie: Ruby gem for beautiful backtraces
+// Copyright (C) 2021 Ivo Anjo <ivo@ivoanjo.me>
+//
+// This file is part of backtracie.
+//
+// backtracie is free software: you can redistribute it and/or modify
+// it under the terms of the GNU Lesser General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+//
+// backtracie is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU Lesser General Public License for more details.
+//
+// You should have received a copy of the GNU Lesser General Public License
+// along with backtracie.  If not, see <http://www.gnu.org/licenses/>.
+
+// -----------------------------------------------------------------------------
+// The file below has modified versions of code extracted from the Ruby project.
+// The Ruby project copyright and license follow:
+// -----------------------------------------------------------------------------
+
+// Ruby is copyrighted free software by Yukihiro Matsumoto <matz@netlab.jp>.
+// You can redistribute it and/or modify it under either the terms of the
+// 2-clause BSDL (see the file BSDL), or the conditions below:
+
+// 1. You may make and give away verbatim copies of the source form of the
+//    software without restriction, provided that you duplicate all of the
+//    original copyright notices and associated disclaimers.
+
+// 2. You may modify your copy of the software in any way, provided that
+//    you do at least ONE of the following:
+
+//    a. place your modifications in the Public Domain or otherwise
+//       make them Freely Available, such as by posting said
+//       modifications to Usenet or an equivalent medium, or by allowing
+//       the author to include your modifications in the software.
+
+//    b. use the modified software only within your corporation or
+//       organization.
+
+//    c. give non-standard binaries non-standard names, with
+//       instructions on where to get the original software distribution.
+
+//    d. make other distribution arrangements with the author.
+
+// 3. You may distribute the software in object code or binary form,
+//    provided that you do at least ONE of the following:
+
+//    a. distribute the binaries and library files of the software,
+//       together with instructions (in the manual page or equivalent)
+//       on where to get the original distribution.
+
+//    b. accompany the distribution with the machine-readable source of
+//       the software.
+
+//    c. give non-standard binaries non-standard names, with
+//       instructions on where to get the original software distribution.
+
+//    d. make other distribution arrangements with the author.
+
+// 4. You may modify and include the part of the software into any other
+//    software (possibly commercial).  But some files in the distribution
+//    are not written by the author, so that they are not under these terms.
+
+//    For the list of those files and their copying conditions, see the
+//    file LEGAL.
+
+// 5. The scripts and library files supplied as input to or produced as
+//    output from the software do not automatically fall under the
+//    copyright of the software, but belong to whomever generated them,
+//    and may be sold commercially, and may be aggregated with this
+//    software.
+
+// 6. THIS SOFTWARE IS PROVIDED "AS IS" AND WITHOUT ANY EXPRESS OR
+//    IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
+//    WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
+//    PURPOSE.
+
+#ifndef RUBY_SHARDS_H
+#define RUBY_SHARDS_H
+
+// -----------------------------------------------------------------------------
+
+/**********************************************************************
+  method.h -
+  created at: Wed Jul 15 20:02:33 2009
+  Copyright (C) 2009 Koichi Sasada
+**********************************************************************/
+
+  #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;
+    #define VM_METHOD_TYPE_MINIMUM_BITS 4
+
+    // Needed for Ruby 2.6 as this is not defined on any public header
+    void rb_hash_bulk_insert(long, const VALUE *, VALUE);
+  #endif
+
+// -----------------------------------------------------------------------------
+
+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;
+  unsigned int should_use_cfunc_name : 1;
+
+  rb_method_type_t vm_method_type : VM_METHOD_TYPE_MINIMUM_BITS;
+  int line_number;
+  VALUE iseq;
+  VALUE callable_method_entry;
+  VALUE self;
+  VALUE cfunc_name;
+} raw_location;
+
+  #ifndef PRE_MJIT_RUBY
+    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);
+  #endif
+VALUE backtracie_called_id(raw_location *the_location);
+VALUE backtracie_defined_class(raw_location *the_location);
+VALUE backtracie_rb_vm_top_self();
+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);
+
+  #ifdef PRE_MJIT_RUBY
+    int backtracie_profile_frames_from_ruby_locations(VALUE ruby_locations_array, raw_location *raw_locations);
+  #endif
+
+// -----------------------------------------------------------------------------
+
+  // 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
+
+#endif

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.2.0"
 end

metadata

@@ -1,41 +1,33 @@
 --- !ruby/object:Gem::Specification
 name: backtracie
 version: !ruby/object:Gem::Version
-  version: 0.1.0
+  version: 0.2.0
 platform: ruby
 authors:
 - Ivo Anjo
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-03-12 00:00:00.000000000 Z
+date: 2021-06-29 00:00:00.000000000 Z
 dependencies: []
 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 +44,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