lib/byebug/command.rb



# frozen_string_literal: true

require "forwardable"
require_relative "helpers/string"

module Byebug
  #
  # Parent class of all byebug commands.
  #
  # Subclass it and name the subclass ending with the word Command to implement
  # your own custom command.
  #
  # @example Define a custom command
  #
  # class MyCustomCommand < Command
  #   def self.regexp
  #     /custom_regexp/
  #   end
  #
  #   def self.description
  #     "Custom long desc"
  #   end
  #
  #   def.short_description
  #     "Custom short desc"
  #   end
  #
  #   def execute
  #     # My command's implementation
  #   end
  # end
  #
  class Command
    extend Forwardable

    attr_reader :processor

    def initialize(processor, input = self.class.to_s)
      @processor = processor
      @match = match(input)
    end

    def context
      @context ||= processor.context
    end

    def frame
      @frame ||= context.frame
    end

    def arguments
      @match[0].split(" ").drop(1).join(" ")
    end

    def_delegators "self.class", :help, :match

    def_delegator "processor.printer", :print, :pr
    def_delegator "processor.printer", :print_collection, :prc
    def_delegator "processor.printer", :print_variables, :prv

    def_delegators "processor.interface", :errmsg, :puts, :print, :confirm

    class << self
      include Helpers::StringHelper

      #
      # Special methods to allow command filtering in processors
      #
      attr_accessor :allow_in_control, :allow_in_post_mortem

      attr_writer :always_run

      def always_run
        @always_run ||= 0
      end

      #
      # Name of the command, as executed by the user.
      #
      def to_s
        name
          .split("::")
          .map { |n| n.gsub(/Command$/, "").downcase if /Command$/.match?(n) }
          .compact
          .join(" ")
      end

      def columnize(width)
        format(
          "  %-<name>#{width}s -- %<description>s\n",
          name: to_s,
          description: short_description
        )
      end

      #
      # Default help text for a command.
      #
      def help
        prettify(description)
      end

      #
      # Command's regexp match against an input
      #
      def match(input)
        regexp.match(input)
      end
    end
  end
end