gitlab-pry-byebug 3.9.0

data/lib/byebug/processors/pry_remote_processor.rb

@@ -0,0 +1,42 @@
+# frozen_string_literal: true
+
+require "byebug/core"
+
+module Byebug
+  #
+  # Extends the PryProcessor to make it work with Pry-Remote
+  #
+  class PryRemoteProcessor < PryProcessor
+    def self.start
+      super
+
+      Byebug.current_context.step_out(5, true)
+    end
+
+    def resume_pry
+      new_binding = frame._binding
+
+      run do
+        if defined?(@pry) && @pry
+          @pry.repl(new_binding)
+        else
+          @pry = Pry.start_without_pry_byebug(new_binding, input: input, output: output)
+        end
+      end
+    end
+
+    private
+
+    def input
+      server.client.input_proxy
+    end
+
+    def output
+      server.client.output
+    end
+
+    def server
+      PryByebug.current_remote_server
+    end
+  end
+end

data/lib/pry-byebug.rb

@@ -0,0 +1,4 @@
+# frozen_string_literal: true
+
+require "pry"
+require "pry-byebug/cli"

data/lib/pry-byebug/base.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/location"
+
+#
+# Main container module for Pry-Byebug functionality
+#
+module PryByebug
+  # Reference to currently running pry-remote server. Used by the processor.
+  class << self
+    attr_accessor :current_remote_server
+  end
+
+  module_function
+
+  #
+  # Checks that a target binding is in a local file context.
+  #
+  def file_context?(target)
+    file = Helpers::Location.current_file(target)
+    file == Pry.eval_path || !Pry::Helpers::BaseHelpers.not_a_real_file?(file)
+  end
+
+  #
+  # Ensures that a command is executed in a local file context.
+  #
+  def check_file_context(target, msg = nil)
+    msg ||= "Cannot find local context. Did you use `binding.pry`?"
+    raise(Pry::CommandError, msg) unless file_context?(target)
+  end
+end

data/lib/pry-byebug/cli.rb

@@ -0,0 +1,6 @@
+# frozen_string_literal: true
+
+require "pry-byebug/base"
+require "pry-byebug/pry_ext"
+require "pry-byebug/commands"
+require "pry-byebug/control_d_handler"

data/lib/pry-byebug/commands.rb

@@ -0,0 +1,12 @@
+# frozen_string_literal: true
+
+require "pry-byebug/commands/backtrace"
+require "pry-byebug/commands/next"
+require "pry-byebug/commands/step"
+require "pry-byebug/commands/continue"
+require "pry-byebug/commands/finish"
+require "pry-byebug/commands/up"
+require "pry-byebug/commands/down"
+require "pry-byebug/commands/frame"
+require "pry-byebug/commands/breakpoint"
+require "pry-byebug/commands/exit_all"

data/lib/pry-byebug/commands/backtrace.rb

@@ -0,0 +1,31 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/navigation"
+
+module PryByebug
+  #
+  # Display the current stack
+  #
+  class BacktraceCommand < Pry::ClassCommand
+    include Helpers::Navigation
+
+    match "backtrace"
+    group "Byebug"
+
+    description "Display the current stack."
+
+    banner <<-BANNER
+      Usage: backtrace
+
+      Display the current stack.
+    BANNER
+
+    def process
+      PryByebug.check_file_context(target)
+
+      breakout_navigation :backtrace
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::BacktraceCommand)

data/lib/pry-byebug/commands/breakpoint.rb

@@ -0,0 +1,137 @@
+# frozen_string_literal: true
+
+require "pry/byebug/breakpoints"
+require "pry-byebug/helpers/breakpoints"
+require "pry-byebug/helpers/location"
+require "pry-byebug/helpers/multiline"
+
+module PryByebug
+  #
+  # Add, show and remove breakpoints
+  #
+  class BreakCommand < Pry::ClassCommand
+    include Helpers::Breakpoints
+    include Helpers::Location
+    include Helpers::Multiline
+
+    match "break"
+    group "Byebug"
+    description "Set or edit a breakpoint."
+
+    banner <<-BANNER
+      Usage:   break <METHOD | FILE:LINE | LINE> [if CONDITION]
+               break --condition N [CONDITION]
+               break [--show | --delete | --enable | --disable] N
+               break [--delete-all | --disable-all]
+               break
+
+      Set a breakpoint. Accepts a line number in the current file, a file and
+      line number, or a method, and an optional condition.
+
+      Pass appropriate flags to manipulate existing breakpoints.
+
+      Examples:
+
+        break SomeClass#run         Break at the start of `SomeClass#run`.
+        break Foo#bar if baz?       Break at `Foo#bar` only if `baz?`.
+        break app/models/user.rb:15 Break at line 15 in user.rb.
+        break 14                    Break at line 14 in the current file.
+
+        break --condition 4 x > 2   Add/change condition on breakpoint #4.
+        break --condition 3         Remove the condition on breakpoint #3.
+
+        break --delete 5            Delete breakpoint #5.
+        break --disable-all         Disable all breakpoints.
+
+        break --show 2              Show details about breakpoint #2.
+        break                       List all breakpoints.
+    BANNER
+
+    def options(opt)
+      defaults = { argument: true, as: Integer }
+
+      opt.on :c, :condition, "Change condition of a breakpoint.", defaults
+      opt.on :s, :show, "Show breakpoint details and source.", defaults
+      opt.on :D, :delete, "Delete a breakpoint.", defaults
+      opt.on :d, :disable, "Disable a breakpoint.", defaults
+      opt.on :e, :enable, "Enable a disabled breakpoint.", defaults
+      opt.on :'disable-all', "Disable all breakpoints."
+      opt.on :'delete-all', "Delete all breakpoints."
+    end
+
+    def process
+      return if check_multiline_context
+
+      PryByebug.check_file_context(target)
+
+      option, = opts.to_hash.find { |key, _value| opts.present?(key) }
+      return send(option_to_method(option)) if option
+
+      return new_breakpoint unless args.empty?
+
+      print_all
+    end
+
+    private
+
+    %w[delete disable enable disable_all delete_all].each do |command|
+      define_method(:"process_#{command}") do
+        breakpoints.send(*[command, opts[command]].compact)
+        print_all
+      end
+    end
+
+    def process_show
+      print_full_breakpoint(breakpoints.find_by_id(opts[:show]))
+    end
+
+    def process_condition
+      expr = args.empty? ? nil : args.join(" ")
+      breakpoints.change(opts[:condition], expr)
+    end
+
+    def new_breakpoint
+      place = args.shift
+      condition = args.join(" ") if args.shift == "if"
+
+      bp = add_breakpoint(place, condition)
+
+      print_full_breakpoint(bp)
+    end
+
+    def option_to_method(option)
+      "process_#{option.to_s.tr('-', '_')}"
+    end
+
+    def print_all
+      print_breakpoints_header
+      breakpoints.each { |b| print_short_breakpoint(b) }
+    end
+
+    def add_breakpoint(place, condition)
+      case place
+      when /^(\d+)$/
+        errmsg = "Line number declaration valid only in a file context."
+        PryByebug.check_file_context(target, errmsg)
+
+        lineno = Regexp.last_match[1].to_i
+        breakpoints.add_file(current_file, lineno, condition)
+      when /^(.+):(\d+)$/
+        file = Regexp.last_match[1]
+        lineno = Regexp.last_match[2].to_i
+        breakpoints.add_file(file, lineno, condition)
+      when /^(.*)[.#].+$/ # Method or class name
+        if Regexp.last_match[1].strip.empty?
+          errmsg = "Method name declaration valid only in a file context."
+          PryByebug.check_file_context(target, errmsg)
+          place = target.eval("self.class.to_s") + place
+        end
+        breakpoints.add_method(place, condition)
+      else
+        raise(ArgumentError, "Cannot identify arguments as breakpoint")
+      end
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::BreakCommand)

data/lib/pry-byebug/commands/continue.rb

@@ -0,0 +1,43 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/navigation"
+require "pry-byebug/helpers/breakpoints"
+require "pry-byebug/helpers/location"
+
+module PryByebug
+  #
+  # Continue program execution until the next breakpoint
+  #
+  class ContinueCommand < Pry::ClassCommand
+    include Helpers::Navigation
+    include Helpers::Breakpoints
+    include Helpers::Location
+
+    match "continue"
+    group "Byebug"
+    description "Continue program execution and end the Pry session."
+
+    banner <<-BANNER
+      Usage: continue [LINE]
+
+      Continue program execution until the next breakpoint, or the program
+      ends. Optionally continue to the specified line number.
+
+      Examples:
+        continue   #=> Continue until the next breakpoint.
+        continue 4 #=> Continue to line number 4.
+    BANNER
+
+    def process
+      PryByebug.check_file_context(target)
+
+      breakpoints.add_file(current_file, args.first.to_i) if args.first
+
+      breakout_navigation :continue
+    ensure
+      Byebug.stop if Byebug.stoppable?
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::ContinueCommand)

data/lib/pry-byebug/commands/down.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/navigation"
+
+module PryByebug
+  #
+  # Travel down the frame stack
+  #
+  class DownCommand < Pry::ClassCommand
+    include Helpers::Navigation
+
+    match "down"
+    group "Byebug"
+
+    description "Move current frame down."
+
+    banner <<-BANNER
+      Usage: down [TIMES]
+
+      Move current frame down. By default, moves by 1 frame.
+
+      Examples:
+        down   #=> Move down 1 frame.
+        down 5 #=> Move down 5 frames.
+    BANNER
+
+    def process
+      PryByebug.check_file_context(target)
+
+      breakout_navigation :down, times: args.first
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::DownCommand)

data/lib/pry-byebug/commands/exit_all.rb

@@ -0,0 +1,19 @@
+# frozen_string_literal: true
+
+require "pry/commands/exit_all"
+
+module PryByebug
+  #
+  # Exit pry REPL with Byebug.stop
+  #
+  class ExitAllCommand < Pry::Command::ExitAll
+    def process
+      super
+    ensure
+      PryByebug.current_remote_server&.teardown
+      Byebug.stop if Byebug.stoppable?
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::ExitAllCommand)

data/lib/pry-byebug/commands/finish.rb

@@ -0,0 +1,29 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/navigation"
+
+module PryByebug
+  #
+  # Run until the end of current frame
+  #
+  class FinishCommand < Pry::ClassCommand
+    include PryByebug::Helpers::Navigation
+
+    match "finish"
+    group "Byebug"
+    description "Execute until current stack frame returns."
+
+    banner <<-BANNER
+      Usage: finish
+    BANNER
+
+    def process
+      PryByebug.current_remote_server&.teardown
+      PryByebug.check_file_context(target)
+
+      breakout_navigation :finish
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::FinishCommand)

data/lib/pry-byebug/commands/frame.rb

@@ -0,0 +1,35 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/navigation"
+
+module PryByebug
+  #
+  # Move to a specific frame in the callstack
+  #
+  class FrameCommand < Pry::ClassCommand
+    include Helpers::Navigation
+
+    match "frame"
+    group "Byebug"
+
+    description "Move to specified frame #."
+
+    banner <<-BANNER
+        Usage: frame [TIMES]
+
+        Move to specified frame #.
+
+        Examples:
+          frame   #=> Show current frame #.
+          frame 5 #=> Move to frame 5.
+    BANNER
+
+    def process
+      PryByebug.check_file_context(target)
+
+      breakout_navigation :frame, index: args.first
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::FrameCommand)

data/lib/pry-byebug/commands/next.rb

@@ -0,0 +1,39 @@
+# frozen_string_literal: true
+
+require "pry-byebug/helpers/navigation"
+require "pry-byebug/helpers/multiline"
+
+module PryByebug
+  #
+  # Run a number of lines and then stop again
+  #
+  class NextCommand < Pry::ClassCommand
+    include Helpers::Navigation
+    include Helpers::Multiline
+
+    match "next"
+    group "Byebug"
+    description "Execute the next line within the current stack frame."
+
+    banner <<-BANNER
+      Usage: next [LINES]
+
+      Step over within the same frame. By default, moves forward a single
+      line.
+
+      Examples:
+        next   #=> Move a single line forward.
+        next 4 #=> Execute the next 4 lines.
+    BANNER
+
+    def process
+      return if check_multiline_context
+
+      PryByebug.check_file_context(target)
+
+      breakout_navigation :next, lines: args.first
+    end
+  end
+end
+
+Pry::Commands.add_command(PryByebug::NextCommand)