readapt 0.3.1

data/lib/readapt/finder.rb

@@ -0,0 +1,20 @@
+require 'pathname'
+
+module Readapt
+  module Finder
+    module_function
+
+    def find program
+      return program if File.exist?(program)
+      which(program) || raise(LoadError, "#{program} is not a valid Ruby file or program")
+    end
+
+    def which program
+      ENV['PATH'].split(File::PATH_SEPARATOR).each do |path|
+        exe = File.join(path, program)
+        return exe if File.file?(exe)
+      end
+      nil
+    end
+  end
+end

data/lib/readapt/frame.rb

@@ -0,0 +1,68 @@
+# frozen_string_literal: true
+
+module Readapt
+  class Frame
+    attr_reader :location
+
+    def initialize location, binding_id
+      @location = location
+      @binding = ObjectSpace._id2ref(binding_id)
+    end
+
+    def local_id
+      @binding.object_id
+    end
+
+    def locals
+      return [] if @binding.nil?
+      result = []
+      @binding.local_variables.each do |sym|
+        var = @binding.local_variable_get(sym)
+        result.push Variable.new(sym, var)
+      end
+      if @binding.receiver != TOPLEVEL_BINDING.receiver
+        result.push Variable.new(:self, @binding.receiver)
+      end
+      result
+    end
+
+    def variables
+      return [] if @binding.nil?
+      result = []
+      @binding.local_variables.each do |sym|
+        var = @binding.local_variable_get(sym)
+        result.push Variable.new(sym, var)
+      end
+      if @binding.receiver != TOPLEVEL_BINDING.receiver
+        @binding.instance_variables.each do |sym|
+          var = @binding.receiver.instance_variable_get(sym)
+          result.push Variable.new(sym, var)
+        end
+        @binding.class.class_variables.each do |sym|
+          var = @binding.receiver.class.class_variable_get(sym)
+          result.push Variable.new(sym, var)
+        end
+      end
+      result
+    end
+
+    def local sym
+      return @binding.receiver if sym == :self
+      @binding.local_variable_get sym
+    end
+
+    def globals
+      global_variables
+    end
+
+    def global sym
+      global sym
+    end
+
+    def evaluate code
+      @binding.eval code
+    end
+
+    NULL_FRAME = Frame.new(nil, nil.object_id)
+  end
+end

data/lib/readapt/location.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Readapt
+  # A simple file/line reference.
+  #
+  class Location
+    # @return [String]
+    attr_reader :file
+
+    # @return [Integer]
+    attr_reader :line
+
+    # @param file [String]
+    # @param line [Integer]
+    def initialize file, line
+      @file = file
+      @line = line
+    end
+
+    def match? other
+      return false unless other.is_a?(Location)
+      file == other.file && line == other.line
+    end
+  end
+end

data/lib/readapt/message.rb

@@ -0,0 +1,57 @@
+# frozen_string_literal: true
+
+require 'readapt/message/base'
+require 'readapt/message/initialize'
+require 'readapt/message/launch'
+require 'readapt/message/set_breakpoints'
+require 'readapt/message/set_exception_breakpoints'
+require 'readapt/message/configuration_done'
+require 'readapt/message/threads'
+require 'readapt/message/stack_trace'
+require 'readapt/message/scopes'
+require 'readapt/message/continue'
+require 'readapt/message/variables'
+require 'readapt/message/next'
+require 'readapt/message/step_in'
+require 'readapt/message/step_out'
+require 'readapt/message/disconnect'
+require 'readapt/message/attach'
+require 'readapt/message/pause'
+
+module Readapt
+  module Message
+    @@messages = {}
+    @@seq = 0
+
+    def self.register name, klass
+      @@messages[name] = klass
+    end
+
+    def self.process arguments, debugger
+      message = @@messages[arguments['command']].new(arguments['arguments'], debugger)
+      message.run
+      message
+    rescue Exception => e
+      STDERR.puts "Skipping error: #{e.message}"
+      STDERR.puts "Received: #{arguments}"
+      STDERR.puts e.backtrace
+    end
+
+    register 'initialize', Message::Initialize
+    register 'attach', Message::Attach
+    register 'launch', Message::Launch
+    register 'setBreakpoints', Message::SetBreakpoints
+    register 'setExceptionBreakpoints', Message::SetExceptionBreakpoints
+    register 'configurationDone', Message::ConfigurationDone
+    register 'threads', Message::Threads
+    register 'stackTrace', Message::StackTrace
+    register 'scopes', Message::Scopes
+    register 'continue', Message::Continue
+    register 'variables', Message::Variables
+    register 'next', Message::Next
+    register 'stepIn', Message::StepIn
+    register 'stepOut', Message::StepOut
+    register 'disconnect', Message::Disconnect
+    register 'pause', Message::Pause
+  end
+end

data/lib/readapt/message/attach.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Attach < Base
+      def run
+        debugger.config arguments, :attach
+      end
+    end
+  end
+end

data/lib/readapt/message/base.rb

@@ -0,0 +1,32 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Base
+      # @return [Hash]
+      attr_reader :arguments
+
+      # @return [Debugger]
+      attr_reader :debugger
+
+      def initialize arguments, debugger
+        @arguments = arguments
+        @debugger = debugger
+      end
+
+      def run; end
+
+      def body
+        @body ||= {}
+      end
+
+      def set_body hash
+        @body = hash
+      end
+
+      def self.run arguments, debugger
+        new(arguments, debugger).run
+      end
+    end
+  end
+end

data/lib/readapt/message/configuration_done.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class ConfigurationDone < Base
+      def run
+        debugger.start
+      end
+    end
+  end
+end

data/lib/readapt/message/continue.rb

@@ -0,0 +1,15 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Continue < Base
+      def run
+        thread = debugger.thread(arguments['threadId'])
+        thread.control = :continue
+        set_body({
+          allThreadsContinued: false
+        })
+      end
+    end
+  end
+end

data/lib/readapt/message/disconnect.rb

@@ -0,0 +1,14 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Disconnect < Base
+      def run
+        # HACK: Wait a moment to make sure the output is flushed
+        # @todo Find a better way
+        sleep 1
+        debugger.disconnect
+      end
+    end
+  end
+end

data/lib/readapt/message/initialize.rb

@@ -0,0 +1,13 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Initialize < Base
+      def run
+        set_body({
+          supportsConfigurationDoneRequest: true
+        })
+      end
+    end
+  end
+end

data/lib/readapt/message/launch.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Launch < Base
+      def run
+        debugger.config arguments, :launch
+      end
+    end
+  end
+end

data/lib/readapt/message/next.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Next < Base
+      def run
+        thread = debugger.thread(arguments['threadId'])
+        thread.control = :next
+      end
+    end
+  end
+end

data/lib/readapt/message/pause.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Pause < Base
+      def run
+        Monitor.pause arguments['threadId']
+      end
+    end
+  end
+end

data/lib/readapt/message/scopes.rb

@@ -0,0 +1,25 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Scopes < Base
+      def run
+        frame = debugger.frame(arguments['frameId'])
+        set_body({
+          scopes: [
+            {
+              name: 'Local',
+              variablesReference: frame.local_id,
+              expensive: false
+            },
+            {
+              name: 'Global',
+              variablesReference: TOPLEVEL_BINDING.receiver.object_id,
+              expensive: true
+            }
+          ]
+        })
+      end
+    end
+  end
+end

data/lib/readapt/message/set_breakpoints.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class SetBreakpoints < Base
+      def run
+        path = Readapt.normalize_path(arguments['source']['path'])
+        Monitor.breakpoints.clear path
+        result = arguments['lines'].map do |l|
+          # @todo Assuming breakpoints are verified
+          Breakpoint.new(path, l, true)
+        end
+        Monitor.breakpoints.concat result
+        set_body({
+          breakpoints: result.map { |bp|
+            {
+              verified: bp.verified,
+              source: arguments['source'],
+              line: bp.line
+            }
+          }
+        })
+      end
+    end
+  end
+end

data/lib/readapt/message/set_exception_breakpoints.rb

@@ -0,0 +1,8 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class SetExceptionBreakpoints < Base
+    end
+  end
+end

data/lib/readapt/message/stack_trace.rb

@@ -0,0 +1,26 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class StackTrace < Base
+      def run
+        frames = debugger.thread(arguments['threadId']).frames
+        set_body({
+          stackFrames: frames.map do |frm|
+            {
+              name: "#{File.basename(frm.location.file)}:#{frm.location.line}",
+              source: {
+                name: File.basename(frm.location.file),
+                path: frm.location.file
+              },
+              id: frm.local_id,
+              line: frm.location.line,
+              column: 0
+            }
+          end,
+          totalFrames: frames.length
+        })
+      end
+    end
+  end
+end

data/lib/readapt/message/step_in.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class StepIn < Base
+      def run
+        debugger.thread(arguments['threadId']).control = :step_in
+      end
+    end
+  end
+end

data/lib/readapt/message/step_out.rb

@@ -0,0 +1,11 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class StepOut < Base
+      def run
+        debugger.thread(arguments['threadId']).control = :step_out
+      end
+    end
+  end
+end

data/lib/readapt/message/threads.rb

@@ -0,0 +1,18 @@
+# frozen_string_literal: true
+
+module Readapt
+  module Message
+    class Threads < Base
+      def run
+        set_body({
+          threads: debugger.threads.map do |thr|
+            {
+              id: thr.id,
+              name: thr.name
+            }
+          end
+        })
+      end
+    end
+  end
+end