tracer 0.2.2 → 0.2.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: c764c7aa6783d3fb081718acd01a2cac909ea95bc8295206560469658cee5a80
-  data.tar.gz: 748f9c168bca973deee9b27e6b29b87e26e09c1bf190fdd09e8c38703498c8f6
+  metadata.gz: 2384a62a824cb7906cd027700d16844a6b666e5dc7b04749fcb2d69ece9a2a85
+  data.tar.gz: 762568e03d81d9dafa2ad6735f9901d53507aaeaa350aac53ef3989325136757
 SHA512:
-  metadata.gz: 0ce73f5cfcdaa82595d3abead931fa0d400025f87f7bf3e6f46bdc40856d9310b573f453c6096c40f0d47e326542801f4be849be9643bb877d03a0cfb5774abb
-  data.tar.gz: fe2b4c36c2b4ea19421fea09732dbc8c70323d7957fe9122d364f63c8cd453e0adb9b806856fed5f537994187c5f5df382623e244963ccb2f57da670a1dc5b92
+  metadata.gz: bbdccfb4cf5054d554a76e22f9bbffd21aa8f3e9a13e366cbfb41d076803c4de4b019697b81d8dd1278655390f7c1949190e7d7c72b2fcdc7ffa83622b89a71d
+  data.tar.gz: b0a8142e250b24964d9fbcbc674d052107061725b6673b7d573553faf55afc722559396c0b878f3639c051dcfd1a9794e285116ba38e2f493d4be9b8d17c11ae

data/README.md

@@ -8,6 +8,7 @@ The `tracer` gem provides helpful tracing utilities to help users observe their
 The currently supported tracers are:
 
 - [`ObjectTracer`](#objecttracer)
+- [`IvarTracer`](#ivartracer)
 - [`CallTracer`](#calltracer)
 - [`ExceptionTracer`](#exceptiontracer)
 - [`LineTracer`](#linetracer)
@@ -103,6 +104,30 @@ end
  #depth:4  #<User:0x000000010696cad8 @name="John"> receives #name (User#name) at test.rb:8:in `authorized?'
 ```
 
+#### IvarTracer
+
+> **Note**
+> Ruby 3.0 and below's accessor calls don't trigger TracePoint properly so the result may be inaccurate with those versions.
+
+```rb
+require "tracer"
+
+class Cat
+  attr_accessor :name
+end
+
+cat = Cat.new
+
+tracer = IvarTracer.new(cat, :@name)
+tracer.start do
+  cat.name = "Kitty"
+  cat.instance_variable_set(:@name, "Ketty")
+end
+
+#depth:3 Cat#name= sets @name = "Kitty" at test.rb:11
+#depth:3 Kernel#instance_variable_set sets @name = "Ketty" at test.rb:12
+```
+
 #### ExceptionTracer
 
 ```rb
@@ -114,7 +139,8 @@ rescue StandardError
   nil
 end
 
- #depth:1  #<RuntimeError: boom> at test.rb:4
+#depth:0  #<RuntimeError: boom> raised at test.rb:4
+#depth:1  #<RuntimeError: boom> rescued at test.rb:6
 ```
 
 #### CallTracer

data/lib/tracer/base.rb

@@ -10,6 +10,7 @@ module Tracer
     M_INSPECT = Object.instance_method(:inspect)
     M_CLASS = Object.instance_method(:class)
     M_IS_A = Object.instance_method(:is_a?)
+    M_INSTANCE_VARIABLE_GET = Object.instance_method(:instance_variable_get)
     HOME = ENV["HOME"] ? (ENV["HOME"] + "/") : nil
 
     include Color

data/lib/tracer/exception_tracer.rb

@@ -4,16 +4,32 @@ require_relative "base"
 
 class ExceptionTracer < Tracer::Base
   def setup_tp
-    TracePoint.new(:raise) do |tp|
-      next if skip?(tp)
+    if RUBY_VERSION >= "3.3.0"
+      TracePoint.new(:raise, :rescue) do |tp|
+        next if skip?(tp)
 
-      exc = tp.raised_exception
+        exc = tp.raised_exception
 
-      out tp,
-          " #{colorize_magenta(exc.inspect)}",
-          depth: caller.size - (1 + @depth_offset)
-    rescue Exception => e
-      p e
+        action = tp.event == :raise ? "raised" : "rescued"
+
+        out tp,
+            " #{colorize_magenta(exc.inspect)} #{action}",
+            depth: caller.size - (1 + @depth_offset)
+      rescue Exception => e
+        p e
+      end
+    else
+      TracePoint.new(:raise) do |tp|
+        next if skip?(tp)
+
+        exc = tp.raised_exception
+
+        out tp,
+            " #{colorize_magenta(exc.inspect)} raised",
+            depth: caller.size - (1 + @depth_offset)
+      rescue Exception => e
+        p e
+      end
     end
   end
 

data/lib/tracer/ivar_tracer.rb

@@ -0,0 +1,49 @@
+# frozen_string_literal: true
+
+require_relative "base"
+
+class IvarTracer < Tracer::Base
+  def initialize(target, var_name, **kw)
+    @target = target
+    @var_name = var_name
+    @original_value = M_INSTANCE_VARIABLE_GET.bind_call(target, var_name)
+    super(**kw)
+  end
+
+  def key
+    [@type, @target, @var_name, @pattern, @into].freeze
+  end
+
+  def description
+    "for #{@var_name} of #{@target} #{super}"
+  end
+
+  def setup_tp
+    TracePoint.new(:a_return) do |tp|
+      next if skip?(tp)
+
+      if tp.self == @target &&
+           value = M_INSTANCE_VARIABLE_GET.bind_call(@target, @var_name)
+        if tp.event == :c_return
+          location = nil
+        else
+          location = caller_locations(2, 1).first.to_s
+          next if location.match?(DIR) || location.match?(/<internal:/)
+        end
+
+        depth = caller.size
+        call_identifier_str = (tp.defined_class ? minfo(tp) : "block")
+        call_identifier_str = colorize_blue(call_identifier_str)
+        depth += 1 if tp.event == :c_return
+        value = safe_inspect(value)
+
+        if value != @original_value
+          out tp,
+              "#{call_identifier_str} sets #{colorize_cyan(@var_name)} = #{colorize_magenta(value)}",
+              depth: depth - 2 - @depth_offset,
+              location: location
+        end
+      end
+    end
+  end
+end

data/lib/tracer/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Tracer
-  VERSION = "0.2.2"
+  VERSION = "0.2.3"
 end

data/lib/tracer.rb

@@ -5,6 +5,7 @@ require_relative "tracer/line_tracer"
 require_relative "tracer/call_tracer"
 require_relative "tracer/exception_tracer"
 require_relative "tracer/object_tracer"
+require_relative "tracer/ivar_tracer"
 
 module Tracer
   module Helper

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: tracer
 version: !ruby/object:Gem::Version
-  version: 0.2.2
+  version: 0.2.3
 platform: ruby
 authors:
 - Stan Lo
@@ -9,7 +9,7 @@ authors:
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2023-05-28 00:00:00.000000000 Z
+date: 2024-03-22 00:00:00.000000000 Z
 dependencies: []
 description: A Ruby tracer
 email:
@@ -21,11 +21,8 @@ extra_rdoc_files: []
 files:
 - CHANGELOG.md
 - CODE_OF_CONDUCT.md
-- Gemfile
-- Gemfile.lock
 - LICENSE.txt
 - README.md
-- Rakefile
 - lib/tracer.rb
 - lib/tracer/base.rb
 - lib/tracer/call_tracer.rb
@@ -33,10 +30,10 @@ files:
 - lib/tracer/exception_tracer.rb
 - lib/tracer/helper.rb
 - lib/tracer/irb.rb
+- lib/tracer/ivar_tracer.rb
 - lib/tracer/line_tracer.rb
 - lib/tracer/object_tracer.rb
 - lib/tracer/version.rb
-- tracer.gemspec
 homepage: https://github.com/ruby/tracer
 licenses:
 - Ruby
@@ -60,7 +57,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.4.10
+rubygems_version: 3.5.4
 signing_key:
 specification_version: 4
 summary: A Ruby tracer

data/Gemfile

@@ -1,11 +0,0 @@
-# frozen_string_literal: true
-
-source "https://rubygems.org"
-
-# Specify your gem's dependencies in ruby-tracer.gemspec
-gemspec
-
-gem "rake", "~> 13.0"
-gem "irb"
-
-gem "test-unit", "~> 3.0"

data/Gemfile.lock

@@ -1,31 +0,0 @@
-PATH
-  remote: .
-  specs:
-    tracer (0.2.2)
-
-GEM
-  remote: https://rubygems.org/
-  specs:
-    io-console (0.6.0)
-    irb (1.6.2)
-      reline (>= 0.3.0)
-    power_assert (2.0.2)
-    rake (13.0.6)
-    reline (0.3.2)
-      io-console (~> 0.5)
-    test-unit (3.5.5)
-      power_assert
-
-PLATFORMS
-  arm64-darwin-21
-  arm64-darwin-22
-  x86_64-linux
-
-DEPENDENCIES
-  irb
-  rake (~> 13.0)
-  test-unit (~> 3.0)
-  tracer!
-
-BUNDLED WITH
-   2.4.2

data/Rakefile

@@ -1,12 +0,0 @@
-# frozen_string_literal: true
-
-require "bundler/gem_tasks"
-require "rake/testtask"
-
-Rake::TestTask.new(:test) do |t|
-  t.libs << "test"
-  t.libs << "lib"
-  t.test_files = FileList["test/**/*_test.rb"]
-end
-
-task default: :test

data/tracer.gemspec

@@ -1,43 +0,0 @@
-# frozen_string_literal: true
-
-require_relative "lib/tracer/version"
-
-Gem::Specification.new do |spec|
-  spec.name = "tracer"
-  spec.version = Tracer::VERSION
-  spec.authors = ["Stan Lo", "Keiju ISHITSUKA"]
-  spec.email = %w[stan001212@gmail.com keiju@ruby-lang.org]
-
-  spec.summary = "A Ruby tracer"
-  spec.description = "A Ruby tracer"
-  spec.homepage = "https://github.com/ruby/tracer"
-  spec.licenses = %w[Ruby BSD-2-Clause]
-  spec.required_ruby_version = ">= 2.7.0"
-
-  spec.metadata["homepage_uri"] = spec.homepage
-  spec.metadata["source_code_uri"] = "https://github.com/ruby/tracer"
-  spec.metadata[
-    "changelog_uri"
-  ] = "https://github.com/ruby/tracer/blob/main/CHANGELOG.md"
-
-  # Specify which files should be added to the gem when it is released.
-  # The `git ls-files -z` loads the files in the RubyGem that have been added into git.
-  spec.files =
-    Dir.chdir(__dir__) do
-      `git ls-files -z`.split("\x0")
-        .reject do |f|
-          (f == __FILE__) ||
-            f.match(
-              %r{\A(?:(?:bin|test|spec|features)/|\.(?:git|circleci)|appveyor)}
-            )
-        end
-    end
-  spec.bindir = "exe"
-  spec.executables = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
-  spec.require_paths = ["lib"]
-
-  # Uncomment to register a new dependency of your gem
-
-  # For more information and examples about making a new gem, check out our
-  # guide at: https://bundler.io/guides/creating_gem.html
-end