trace_eval 0.1.1 → 0.1.5

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5e00d98b99b9bc995793f17e525a6829b206e586691cf15fee85d041604aef1b
-  data.tar.gz: e9310b0debe64c04fac46e79b2c9c4466242c444f97aa7fd0b8a09b699f71a60
+  metadata.gz: b32d9cc35ebe136968c891eb8806e579c88116301f8f2e74dbce59847de2fe04
+  data.tar.gz: effd109d975752c4428acefee763830916b9d7fe1e4bd96f80c409f454ece571
 SHA512:
-  metadata.gz: 75a8c4000beff2f1ed36d5208d56a549ecf8a66c322dcf819b8f05a1781266480919419939caaa2a55001ee14b9bfb7d4947fede6ab54093f09e675db6c225a4
-  data.tar.gz: 3f2a61b564ed1261bc150f3b7ebd2c7daafad31a032fcfb73af55beffbf76bbdfcf678b72592372b64375e05e81a130028f3b98481017f143412e8c6a5396f35
+  metadata.gz: 98aedb41439c4221bb0aa7611d0411cbbf62aa106632d1cfa1adfcf771113bcdd86aeab528832a355191fc8f686631c45378ac377e9de5129d6f104695983aaa
+  data.tar.gz: 4093cfda441ddf9fbeade79f0c9035bc3f4112cbe3f8c0ffb69c4a9bc3c9f5feaae3e56b99003d09b78ce263cd82d5358e1eaba308d3ff69502584a420ce4283

data/Gemfile.lock

@@ -1,14 +1,12 @@
 PATH
   remote: .
   specs:
-    trace_eval (0.1.1)
-      chunky_png
+    trace_eval (0.1.5)
 
 GEM
   remote: https://rubygems.org/
   specs:
     ast (2.4.2)
-    chunky_png (1.4.0)
     minitest (5.14.4)
     parallel (1.21.0)
     parser (3.0.2.0)

data/README.md

@@ -1,11 +1,21 @@
 # TraceEval
 
-Welcome to your new gem! In this directory, you'll find the files you
-need to be able to package up your Ruby library into a gem. Put your
-Ruby code in the file `lib/trace_eval`. To experiment with that code,
-run `bin/console` for an interactive prompt.
+Evaluates the Ruby expression(s) in string and prints each executing line.
 
-TODO: Delete this and the text above, and describe your gem
+The standard ruby `tracer` does not display the source inside an `eval`:
+
+```
+$ ruby -rtracer foo.rb 
+#0:foo.rb:1::-: puts 1+2
+3
+#0:foo.rb:2::-: eval "puts 3+4\nputs 5+6\n"
+#0:(eval):1::-: -
+7
+#0:(eval):2::-: -
+11
+#0:foo.rb:3::-: puts 7+8
+15
+```
 
 ## Installation
 
@@ -25,7 +35,58 @@ Or install it yourself as:
 
 ## Usage
 
-TODO: Write usage instructions here
+```
+$ ./bin/console 
+irb(main):001:0> extend TraceEval
+=> main
+irb(main):002:0> trace_eval "a = 2\nb = 2\nputs a+b\n"
+a = 2
+b = 2
+puts a+b
+4
+=> nil
+```
+
+### Bugs
+
+If the traced eval in turn evals, the trace will be nonsense:
+
+```
+irb(main):001:0> extend TraceEval
+=> main
+irb(main):002:0> trace_eval "0+1\neval \"2+3\n4+5\n\"\n6+7\n"
+0+1
+eval "2+3
+0+1
+eval "2+3
+6+7
+=> 13
+```
+
+Nested `trace_eval` does work:
+
+```
+irb(main):001:0> extend TraceEval
+=> main
+irb(main):002:0> trace_eval "0+1\ntrace_eval \"2+3\n4+5\n\"\n6+7\n"
+0+1
+trace_eval "2+3
+2+3
+4+5
+6+7
+=> 13
+```
+
+## Concept of Operation
+
+- Save a random value in a magic variable to distinguish this eval
+  from others
+- Save an array of the lines of the eval string
+- Set a `TracePoint` for `:line` events (execute code on a new line)
+- When the trace point is activated
+  - Only proceed if the line's `path` is '(eval)'
+  - Only proceed if the magic variable matches the expected value
+  - Print the appropriate line from the array by `lineno`
 
 ## Development
 
@@ -41,7 +102,8 @@ push the `.gem` file to [rubygems.org](https://rubygems.org).
 
 ## Contributing
 
-Bug reports and pull requests are welcome on GitHub at https://gitlab.com/fjc/trace_eval.
+Bug reports and pull requests are welcome on GitLab at
+https://gitlab.com/fjc/trace_eval.
 
 ## License
 

data/lib/trace_eval/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module TraceEval
-  VERSION = '0.1.1'
+  VERSION = '0.1.5'
 end

data/lib/trace_eval.rb

@@ -14,15 +14,12 @@ module TraceEval
     ] + code.lines
 
     tp = TracePoint.new(:line) do |tp|
-      tp.disable
       next unless tp.path == '(eval)'
       next unless tp.binding.local_variable_get(
         :__wzpxmnrjafemvlrwflblbbyenywk__
       )==__wzpxmnrjafemvlrwflblbbyenywk__
-      print lines[tp.lineno]
+      $stderr.print lines[tp.lineno]
     rescue NameError
-    ensure
-      tp.enable
     end
 
     begin

data/trace_eval.gemspec

@@ -8,7 +8,7 @@ Gem::Specification.new do |spec|
   spec.authors       = ['Frank J. Cameron']
   spec.email         = ['fjc@fastmail.net']
 
-  spec.summary       = ''
+  spec.summary       = 'Evaluates the Ruby expression(s) in string and prints each executing line.'
   spec.homepage      = 'https://gitlab.com/fjc/trace_eval'
   spec.license       = 'MIT'
   spec.required_ruby_version = '>= 2.7.0'
@@ -26,6 +26,4 @@ Gem::Specification.new do |spec|
   spec.bindir        = 'exe'
   spec.executables   = spec.files.grep(%r{\Aexe/}) { |f| File.basename(f) }
   spec.require_paths = ['lib']
-
-  spec.add_dependency 'chunky_png'
 end

metadata

@@ -1,29 +1,15 @@
 --- !ruby/object:Gem::Specification
 name: trace_eval
 version: !ruby/object:Gem::Version
-  version: 0.1.1
+  version: 0.1.5
 platform: ruby
 authors:
 - Frank J. Cameron
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2021-11-02 00:00:00.000000000 Z
-dependencies:
-- !ruby/object:Gem::Dependency
-  name: chunky_png
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: '0'
+date: 2021-11-08 00:00:00.000000000 Z
+dependencies: []
 description:
 email:
 - fjc@fastmail.net
@@ -66,5 +52,5 @@ requirements: []
 rubygems_version: 3.1.6
 signing_key:
 specification_version: 4
-summary: ''
+summary: Evaluates the Ruby expression(s) in string and prints each executing line.
 test_files: []