im-lost 1.0.0 → 1.0.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 39160aff2b7fa8320ae12c5d035fa40fbf6f96a2fbe0418ddfb31ac700c2bf72
-  data.tar.gz: 044bf4b9b4f9288f418b0cc5344cc82d1a88839d08a8ef1b8008d616ef11481c
+  metadata.gz: 5f3add8daa7364ab1a0f1a5058a09b529e448db9bfeda20c9f35e9e69fccbc90
+  data.tar.gz: 8bfad384dc5dfd659bb5a49eda611e90b9ee090d0bfa5dfbfd9979289591bac8
 SHA512:
-  metadata.gz: 5d76261aafb61289cf56c23fb2acb0c0e6a0b8cc834b4e28b72d80cf0f6dfdf7966a8b613c7a0f4e8ee005eae2ba4064fe9aeb7b7520cbd53ce8e99671e33f0f
-  data.tar.gz: da598803cf6e2ee4e4baa92f8e702796050f279645daf80fccffa16c2be2eaa314cee7a69742691dde5d798f44f75d610dcb7db71d223a72c0fcabb2e65c7030
+  metadata.gz: a2fa68b037ca862fc7754b9f613743e6c358aaf9ec2c299a3dc0b3fc8612ab9537696d21c2212e292530e258470db970f4e6bd2e724c38f1fea22f7b22af3376
+  data.tar.gz: 6c47d670e625de3a386cf1412278bb5e6382e8b3809a7bb0678ee7f4ef99983cddfd805655198ad931bb735a336343837c3b4b4e9887ba7bc6dd0064dd168bfc

data/README.md

@@ -53,11 +53,28 @@ When you like to know if and when a code point is reached, `ImLost.here` will he
 ImLost.here
 ```
 
+If you like to know the instance variables values of an object, use
+`ImLost.vars`:
+
+```ruby
+ImLost.vars(self)
+```
+
+Or you can print the current local variables:
+
+```ruby
+ImLost.vars(binding)
+```
+
+See the [online help](https://rubydoc.info/gems/im-lost/ImLost) for more!
+
 ## Example
 
 ```ruby
 require 'im-lost'
 
+require_relative '../lib/im-lost'
+
 class Foo
   def self.create(value:) = new(value)
 
@@ -82,43 +99,40 @@ my_foo = Foo.create(value: :foo!)
 ImLost.trace(my_foo)
 
 my_foo.foo(1, key: :none)
+ImLost.vars(my_foo)
+
 my_foo.foo(2, :a, :b, :c, key: :some, name: :value)
+ImLost.vars(my_foo)
+
 my_foo.foo(3) { puts _1 }
+ImLost.vars(my_foo)
 
 # output will look like
-#   > Foo.create(:foo!)
-#     /projects/foo.rb:25
-#   > Foo.new(*)
-#     /projects/foo.rb:6
-#   < Foo.new(*)
-#     = #<Foo:0x0000000100902418 @value=:foo!>
-#   < Foo.create(:foo!)
-#     = #<Foo:0x0000000100902418 @value=:foo!>
-#   > Foo#foo(1, *[], :none, **{}, &nil)
-#     /projects/foo.rb:28
-#   > Foo#bar()
-#     /projects/foo.rb:15
-#   < Foo#bar()
-#     = :bar
-#   < Foo#foo(1, *[], :none, **{}, &nil)
-#     = "1-none-[]-{}-bar"
-#   > Foo#foo(2, *[:a, :b, :c], :some, **{:name=>:value}, &nil)
-#     /projects/foo.rb:29
-#   > Foo#bar()
-#     /projects/foo.rb:15
-#   < Foo#bar()
-#     = :bar
-#   < Foo#foo(2, *[:a, :b, :c], :some, **{:name=>:value}, &nil)
-#     = "2-some-[a,b,c]-{:name=>:value}-bar"
-#   > Foo#foo(3, *[], nil, **{}, &#<Proc:0x0000000100900578 /projects/foo.rb:30>)
-#     /projects/foo.rb:30
-#   > Foo#bar()
-#     /projects/foo.rb:15
-#   < Foo#bar()
-#     = :bar
-#   3--[]-{}-bar
-#   < Foo#foo(3, *[], nil, **{}, &#<Proc:0x0000000100900578 /projects/foo.rb:30>)
-#     = nil
+#  > Foo.create(:foo!)
+#    /projects/foo.rb25
+#  > Foo.new(*)
+#    /projects/foo.rb6
+#  < Foo.new(*)
+#    = #<Foo:0x0000000100ab1188 @value=:foo!>
+#  < Foo.create(:foo!)
+#    = #<Foo:0x0000000100ab1188 @value=:foo!>
+#  > Foo#foo(1, *[], :none, **{}, &nil)
+#    /projects/foo.rb28
+#  > Foo#bar()
+#    /projects/foo.rb15
+#  < Foo#bar()
+#    = :bar
+#  < Foo#foo(1, *[], :none, **{}, &nil)
+#    = "1-none-[]-{}-bar"
+#  = /projects/foo.rb29
+#    instance variables:
+#    @value: "1-none-[]-{}-bar"
+#  = /projects/foo.rb32
+#    instance variables:
+#    @value: "2-some-[a,b,c]-{:name=>:value}-bar"
+#  = /projects/foo.rb35
+#    instance variables:
+#    @value: "3--[]-{}-bar"
 ```
 
 See [examples dir](./examples) for more…

data/examples/foo.rb

@@ -26,40 +26,37 @@ my_foo = Foo.create(value: :foo!)
 ImLost.trace(my_foo)
 
 my_foo.foo(1, key: :none)
+ImLost.vars(my_foo)
+
 my_foo.foo(2, :a, :b, :c, key: :some, name: :value)
+ImLost.vars(my_foo)
+
 my_foo.foo(3) { puts _1 }
+ImLost.vars(my_foo)
 
 # output will look like
-#   > Foo.create(:foo!)
-#     /projects/foo.rb:25
-#   > Foo.new(*)
-#     /projects/foo.rb:6
-#   < Foo.new(*)
-#     = #<Foo:0x0000000100902418 @value=:foo!>
-#   < Foo.create(:foo!)
-#     = #<Foo:0x0000000100902418 @value=:foo!>
-#   > Foo#foo(1, *[], :none, **{}, &nil)
-#     /projects/foo.rb:28
-#   > Foo#bar()
-#     /projects/foo.rb:15
-#   < Foo#bar()
-#     = :bar
-#   < Foo#foo(1, *[], :none, **{}, &nil)
-#     = "1-none-[]-{}-bar"
-#   > Foo#foo(2, *[:a, :b, :c], :some, **{:name=>:value}, &nil)
-#     /projects/foo.rb:29
-#   > Foo#bar()
-#     /projects/foo.rb:15
-#   < Foo#bar()
-#     = :bar
-#   < Foo#foo(2, *[:a, :b, :c], :some, **{:name=>:value}, &nil)
-#     = "2-some-[a,b,c]-{:name=>:value}-bar"
-#   > Foo#foo(3, *[], nil, **{}, &#<Proc:0x0000000100900578 /projects/foo.rb:30>)
-#     /projects/foo.rb:30
-#   > Foo#bar()
-#     /projects/foo.rb:15
-#   < Foo#bar()
-#     = :bar
-#   3--[]-{}-bar
-#   < Foo#foo(3, *[], nil, **{}, &#<Proc:0x0000000100900578 /projects/foo.rb:30>)
-#     = nil
+#  > Foo.create(:foo!)
+#    /projects/foo.rb25
+#  > Foo.new(*)
+#    /projects/foo.rb6
+#  < Foo.new(*)
+#    = #<Foo:0x0000000100ab1188 @value=:foo!>
+#  < Foo.create(:foo!)
+#    = #<Foo:0x0000000100ab1188 @value=:foo!>
+#  > Foo#foo(1, *[], :none, **{}, &nil)
+#    /projects/foo.rb28
+#  > Foo#bar()
+#    /projects/foo.rb15
+#  < Foo#bar()
+#    = :bar
+#  < Foo#foo(1, *[], :none, **{}, &nil)
+#    = "1-none-[]-{}-bar"
+#  = /projects/foo.rb29
+#    instance variables:
+#    @value: "1-none-[]-{}-bar"
+#  = /projects/foo.rb32
+#    instance variables:
+#    @value: "2-some-[a,b,c]-{:name=>:value}-bar"
+#  = /projects/foo.rb35
+#    instance variables:
+#    @value: "3--[]-{}-bar"

data/lib/im-lost/version.rb

@@ -2,5 +2,5 @@
 
 module ImLost
   # The version number of the gem.
-  VERSION = '1.0.0'
+  VERSION = '1.0.1'
 end

data/lib/im-lost.rb

@@ -1,5 +1,14 @@
 # frozen_string_literal: true
 
+# If you have overlooked something again and don't really understand what your
+# code is doing. If you have to maintain this application but can't really find
+# your way around and certainly can't track down that stupid error. If you feel
+# lost in all that code, here's the gem to help you out!
+#
+# ImLost helps you by analyzing function calls of objects, informing you about
+# exceptions and logging your way through your code. In short, ImLost is your
+# debugging helper!
+#
 module ImLost
   class << self
     #
@@ -226,6 +235,28 @@ module ImLost
       self
     end
 
+    #
+    # Inspect internal variables.
+    #
+    # @overload vars(binding)
+    #   Inspect local variables of given Binding.
+    #   @param binding [Binding] which local variables should be print
+    #   @return [self] itself
+    #
+    # @overload vars(object)
+    #   Inspect instance variables of given object.
+    #   @param object [Object] which instance variables should be print
+    #   @return [Object] the given object
+    #
+    def vars(object)
+      traced = @trace.delete(object.__id__)
+      return _local_vars(object) if object.is_a?(Binding)
+      return unless object.respond_to?(:instance_variables)
+      _vars(object, Kernel.caller_locations(1, 1)[0])
+    ensure
+      @trace[traced] = 1 if traced
+    end
+
     protected
 
     def as_sig(prefix, info, args)
@@ -270,6 +301,34 @@ module ImLost
     ensure
       ids.each { @trace.delete(_1) }
     end
+
+    def _vars(obj, location)
+      @output.puts("= #{location.path}:#{location.lineno}")
+      vars = obj.instance_variables
+      if vars.empty?
+        @output.puts('  <no instance variables defined>')
+      else
+        @output.puts('  instance variables:')
+        vars.sort!.each do |name|
+          @output.puts("  #{name}: #{obj.instance_variable_get(name).inspect}")
+        end
+      end
+      obj
+    end
+
+    def _local_vars(binding)
+      @output.puts("= #{binding.source_location.join(':')}")
+      vars = binding.local_variables
+      if vars.empty?
+        @output.puts('  <no local variables>')
+      else
+        @output.puts('  local variables:')
+        vars.sort!.each do |name|
+          @output.puts("  #{name}: #{binding.local_variable_get(name).inspect}")
+        end
+      end
+      self
+    end
   end
 
   ARG_SIG = { rest: '*', keyrest: '**', block: '&' }.compare_by_identity.freeze
@@ -283,12 +342,12 @@ module ImLost
 
   @trace_calls = [
     TracePoint.new(:c_call) do |tp|
-      next unless @trace.key?(tp.self.__id__)
+      next if !@trace.key?(tp.self.__id__) || tp.path == __FILE__
       @output.puts(as_sig('>', tp, tp.parameters.map { ARG_SIG[_1[0]] || '?' }))
       @output.puts("  #{tp.path}:#{tp.lineno}") if @caller_locations
     end,
     TracePoint.new(:call) do |tp|
-      next unless @trace.key?(tp.self.__id__)
+      next if !@trace.key?(tp.self.__id__) || tp.path == __FILE__
       ctx = tp.binding
       @output.puts(
         as_sig(
@@ -308,12 +367,12 @@ module ImLost
 
   @trace_results = [
     TracePoint.new(:c_return) do |tp|
-      next unless @trace.key?(tp.self.__id__)
+      next if !@trace.key?(tp.self.__id__) || tp.path == __FILE__
       @output.puts(as_sig('<', tp, tp.parameters.map { ARG_SIG[_1[0]] || '?' }))
       @output.puts("  = #{tp.return_value.inspect}")
     end,
     TracePoint.new(:return) do |tp|
-      next unless @trace.key?(tp.self.__id__)
+      next if !@trace.key?(tp.self.__id__) || tp.path == __FILE__
       ctx = tp.binding
       @output.puts(
         as_sig(

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: im-lost
 version: !ruby/object:Gem::Version
-  version: 1.0.0
+  version: 1.0.1
 platform: ruby
 authors:
 - Mike Blumtritt
@@ -56,7 +56,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.5.10
+rubygems_version: 3.2.33
 signing_key:
 specification_version: 4
 summary: Your debugging helper.