docspring 3.0.0 → 3.1.0

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/lib/irb/frame.rb

@@ -0,0 +1,80 @@
+# frozen_string_literal: true
+#
+#   frame.rb -
+#   	by Keiju ISHITSUKA(Nihon Rational Software Co.,Ltd)
+#
+
+module IRB
+  class Frame
+    class FrameOverflow < StandardError
+      def initialize
+        super("frame overflow")
+      end
+    end
+    class FrameUnderflow < StandardError
+      def initialize
+        super("frame underflow")
+      end
+    end
+
+    # Default number of stack frames
+    INIT_STACK_TIMES = 3
+    # Default number of frames offset
+    CALL_STACK_OFFSET = 3
+
+    # Creates a new stack frame
+    def initialize
+      @frames = [TOPLEVEL_BINDING] * INIT_STACK_TIMES
+    end
+
+    # Used by Kernel#set_trace_func to register each event in the call stack
+    def trace_func(event, file, line, id, binding)
+      case event
+      when 'call', 'class'
+        @frames.push binding
+      when 'return', 'end'
+        @frames.pop
+      end
+    end
+
+    # Returns the +n+ number of frames on the call stack from the last frame
+    # initialized.
+    #
+    # Raises FrameUnderflow if there are no frames in the given stack range.
+    def top(n = 0)
+      bind = @frames[-(n + CALL_STACK_OFFSET)]
+      fail FrameUnderflow unless bind
+      bind
+    end
+
+    # Returns the +n+ number of frames on the call stack from the first frame
+    # initialized.
+    #
+    # Raises FrameOverflow if there are no frames in the given stack range.
+    def bottom(n = 0)
+      bind = @frames[n]
+      fail FrameOverflow unless bind
+      bind
+    end
+
+    # Convenience method for Frame#bottom
+    def Frame.bottom(n = 0)
+      @backtrace.bottom(n)
+    end
+
+    # Convenience method for Frame#top
+    def Frame.top(n = 0)
+      @backtrace.top(n)
+    end
+
+    # Returns the binding context of the caller from the last frame initialized
+    def Frame.sender
+      eval "self", @backtrace.top
+    end
+
+    @backtrace = Frame.new
+    set_trace_func proc{|event, file, line, id, binding, klass|
+      @backtrace.trace_func(event, file, line, id, binding)
+    }
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/lib/irb/help.rb

@@ -0,0 +1,28 @@
+# frozen_string_literal: true
+#
+#   irb/help.rb - print usage module
+#   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
+#
+
+module IRB
+  # Outputs the irb help message, see IRB@Command-Line+Options.
+  def IRB.print_usage # :nodoc:
+    lc = IRB.conf[:LC_MESSAGES]
+    path = lc.find("irb/help-message")
+    space_line = false
+    File.open(path){|f|
+      f.each_line do |l|
+        if /^\s*$/ =~ l
+          lc.puts l unless space_line
+          space_line = true
+          next
+        end
+        space_line = false
+
+        l.sub!(/#.*$/, "")
+        next if /^\s*$/ =~ l
+        lc.puts l
+      end
+    }
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/lib/irb/helper_method/base.rb

@@ -0,0 +1,16 @@
+require "singleton"
+
+module IRB
+  module HelperMethod
+    class Base
+      include Singleton
+
+      class << self
+        def description(description = nil)
+          @description = description if description
+          @description
+        end
+      end
+    end
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/lib/irb/helper_method/conf.rb

@@ -0,0 +1,11 @@
+module IRB
+  module HelperMethod
+    class Conf < Base
+      description "Returns the current IRB context."
+
+      def execute
+        IRB.CurrentContext
+      end
+    end
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/lib/irb/helper_method.rb

@@ -0,0 +1,29 @@
+require_relative "helper_method/base"
+
+module IRB
+  module HelperMethod
+    @helper_methods = {}
+
+    class << self
+      attr_reader :helper_methods
+
+      def register(name, helper_class)
+        @helper_methods[name] = helper_class
+
+        if defined?(HelpersContainer)
+          HelpersContainer.install_helper_methods
+        end
+      end
+
+      def all_helper_methods_info
+        @helper_methods.map do |name, helper_class|
+          { display_name: name, description: helper_class.description }
+        end
+      end
+    end
+
+    # Default helper_methods
+    require_relative "helper_method/conf"
+    register(:conf, HelperMethod::Conf)
+  end
+end

data/vendor/bundle/ruby/3.3.0/gems/irb-1.15.1/lib/irb/history.rb

@@ -0,0 +1,116 @@
+require "pathname"
+
+module IRB
+  module History
+    DEFAULT_ENTRY_LIMIT = 1000
+
+    class << self
+      # Integer representation of <code>IRB.conf[:HISTORY_FILE]</code>.
+      def save_history
+        return 0 if IRB.conf[:SAVE_HISTORY] == false
+        return DEFAULT_ENTRY_LIMIT if IRB.conf[:SAVE_HISTORY] == true
+        IRB.conf[:SAVE_HISTORY].to_i
+      end
+
+      def save_history?
+        !save_history.zero?
+      end
+
+      def infinite?
+        save_history.negative?
+      end
+
+      # Might be nil when HOME and XDG_CONFIG_HOME are not available.
+      def history_file
+        if (history_file = IRB.conf[:HISTORY_FILE])
+          File.expand_path(history_file)
+        else
+          IRB.rc_file("_history")
+        end
+      end
+    end
+  end
+
+  module HistorySavingAbility # :nodoc:
+    def support_history_saving?
+      true
+    end
+
+    def reset_history_counter
+      @loaded_history_lines = self.class::HISTORY.size
+    end
+
+    def load_history
+      history_file = History.history_file
+      return unless File.exist?(history_file.to_s)
+
+      history = self.class::HISTORY
+
+      File.open(history_file, "r:#{IRB.conf[:LC_MESSAGES].encoding}") do |f|
+        f.each { |l|
+          l = l.chomp
+          if self.class == RelineInputMethod and history.last&.end_with?("\\")
+            history.last.delete_suffix!("\\")
+            history.last << "\n" << l
+          else
+            history << l
+          end
+        }
+      end
+      @loaded_history_lines = history.size
+      @loaded_history_mtime = File.mtime(history_file)
+    end
+
+    def save_history
+      return unless History.save_history?
+      return unless (history_file = History.history_file)
+      unless ensure_history_file_writable(history_file)
+        warn <<~WARN
+          Can't write history to #{History.history_file.inspect} due to insufficient permissions.
+          Please verify the value of `IRB.conf[:HISTORY_FILE]`. Ensure the folder exists and that both the folder and file (if it exists) are writable.
+        WARN
+        return
+      end
+
+      history = self.class::HISTORY.to_a
+
+      if File.exist?(history_file) &&
+          File.mtime(history_file) != @loaded_history_mtime
+        history = history[@loaded_history_lines..-1] if @loaded_history_lines
+        append_history = true
+      end
+
+      File.open(history_file, (append_history ? "a" : "w"), 0o600, encoding: IRB.conf[:LC_MESSAGES]&.encoding) do |f|
+        hist = history.map { |l| l.scrub.split("\n").join("\\\n") }
+
+        unless append_history || History.infinite?
+          # Check size before slicing because array.last(huge_number) raises RangeError.
+          hist = hist.last(History.save_history) if hist.size > History.save_history
+        end
+
+        f.puts(hist)
+      end
+    end
+
+    private
+
+    # Returns boolean whether writing to +history_file+ will be possible.
+    # Permissions of already existing +history_file+ are changed to
+    # owner-only-readable if necessary [BUG #7694].
+    def ensure_history_file_writable(history_file)
+      history_file = Pathname.new(history_file)
+
+      return false unless history_file.dirname.writable?
+      return true unless history_file.exist?
+
+      begin
+        if history_file.stat.mode & 0o66 != 0
+          history_file.chmod 0o600
+        end
+        true
+      rescue Errno::EPERM # no permissions
+        false
+      end
+    end
+  end
+end