tracy 0.0.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: fd60e31e3f6e8541482229b04bce7fe5965113e0
+  data.tar.gz: a395a7a7db2b9a6514a3c2ef2f07a7d91ce0b562
+SHA512:
+  metadata.gz: 3c0f8b853662f0a1c9bd886bd7ab4895d2b61a072baf29868628fbd8ac1e2a9c0a150709e764b973ca2a767821dc759173b918ba4ab77e98df3cf0666a5e5b05
+  data.tar.gz: a716884b8a957751392dd7503e8b27f707a5d861e108041157106362b4136594532ad5fa978324756c8c14081017ddfe980d7fe736b346576af3532c2fe23e0e

data/README.md

@@ -0,0 +1,40 @@
+# Fun with tracing
+
+A set of experiments to investigate the possibility of using tracing
+information gathered during, e.g., the running of a test suite to aid in
+refactoring.
+
+If the gem is not installed, you should run the commands listed below using
+`bundle exec`.
+
+## Gathering caller info
+
+Running `ruby experiment.rb` will generate `callsite-info.yml` containing a
+list of callers for each method in `experiment.rb`.
+
+## Showing caller info
+
+The `callsites` script simply fetches info from `callsites-info.yml`. The
+following will display callers of the method defined on line 7 of
+`experiment.rb`:
+
+    callsites experiment.rb:7
+
+Alternatively, you can fetch call sites for a method by name like so:
+
+    callsites Foo#baz
+
+## Renaming methods
+
+The `rename-method.rb` script performs a simple informed method renaming. It
+will only rename methods on the caller locations found in `callsites-info.yml`.
+
+Because this script currently does a simple string replace on the listed lines,
+it could get confused if the method name occurs more than once on the same
+line. Therefore, it aborts if this happens, rather than accidentally renaming
+the wrong thing.
+
+The following example will rename the method `Foo#baz`, but not `OtherFoo#baz`:
+
+    ruby rename-method.rb experiment.rb:17 baz foodeldoo
+

data/Rakefile

@@ -0,0 +1,5 @@
+require 'rake/clean'
+require 'bundler/gem_tasks'
+require 'cucumber/rake/task'
+
+Cucumber::Rake::Task.new

data/bin/callsites

@@ -0,0 +1,45 @@
+#!/usr/bin/env ruby
+require 'yaml'
+
+Location = Struct.new(:method_name, :class_name, :line, :file) do
+  def match(other)
+    (other.method_name.nil? || other.method_name == method_name) &&
+      (other.class_name.nil? || other.class_name == class_name) &&
+      (other.line.nil? || other.line == line) &&
+      (other.file.nil? || other.file == file)
+  end
+
+  def pretty_print
+    if method_name
+      name = "#{class_name}##{method_name}"
+    else
+      name = '<main>'
+    end
+    "#{name} at #{file}:#{line}"
+  end
+end
+
+location = ARGV[0]
+if location =~ /:/
+  file, line = location.split ':'
+  line = line.to_i
+else
+  class_name, method_name = location.split '#'
+  method_name = method_name.to_sym
+end
+
+target_location = Location.new(method_name, class_name, line, file)
+
+location_data = YAML.load(File.read('callsite-info.yml'))
+
+selection = location_data.select do |key, callers|
+  loc = Location.new(*key)
+  loc.match(target_location)
+end
+
+selection.each do |key, callers|
+  puts "#{Location.new(*key).pretty_print} is called by"
+  callers.each do |call_site|
+    puts "  #{Location.new(*call_site).pretty_print}"
+  end
+end

data/lib/tracy.rb

@@ -0,0 +1,31 @@
+require 'yaml'
+
+class Tracy
+  def initialize
+    @callers = Hash.new { |hash, key| hash[key] = [] }
+    @trace = TracePoint.new(:call, :line) do |tp|
+      case tp.event
+      when :call
+        @callers[data_array(tp)].push @current_location
+      when :line
+        @current_location = data_array(tp)
+      end
+    end
+  end
+
+  def start
+    @trace.enable
+  end
+
+  def done
+    @trace.disable
+    IO.write('callsite-info.yml', YAML.dump(@callers))
+  end
+
+  private
+
+  def data_array(trace_point)
+    klass = trace_point.defined_class
+    [trace_point.method_id, klass ? klass.name : '', trace_point.lineno, trace_point.path]
+  end
+end

metadata

@@ -0,0 +1,90 @@
+--- !ruby/object:Gem::Specification
+name: tracy
+version: !ruby/object:Gem::Version
+  version: 0.0.1
+platform: ruby
+authors:
+- Matijs van Zuijlen
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2016-01-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rake
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '10.3'
+- !ruby/object:Gem::Dependency
+  name: aruba
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.2
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: 0.10.2
+- !ruby/object:Gem::Dependency
+  name: cucumber
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+  type: :development
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '2.0'
+description: 
+email: matijs@matijs.net
+executables:
+- callsites
+extensions: []
+extra_rdoc_files: []
+files:
+- README.md
+- Rakefile
+- bin/callsites
+- lib/tracy.rb
+homepage: http://www.matijs.net
+licenses: []
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.4.5.1
+signing_key: 
+specification_version: 4
+summary: Fun with tracing
+test_files: []