irb 1.18.0 → 1.19.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: f5228c22000696caa8318b56171e1238202f103e63c470db4d215ce2d0e46625
-  data.tar.gz: ac556bc9f4fe3abfef0310a1330d609d424c1196e4a75ba086bae789b0e973d1
+  metadata.gz: 1659fa380cb8e67dca7525396830d9319b6aaf5c1c4d12523a6434169f1ed442
+  data.tar.gz: 45978084c34df26dc1b4b963f4cceb1f40e9ec051088a8f75adecfc40f6a69c8
 SHA512:
-  metadata.gz: fe37b6ecb5348d4cee255f42fd0be29d75b609b7edf45e0e8b6699dcb2865c4d888fbb282087acbfe2eaa9235890e60f7be80545ddb292b9adb4d4c29fd8b111
-  data.tar.gz: 063aab58e48c5ff5e6bb5ca306ad820469c96a691d1f90d227a045c6fb2d9a5b423c76e4099a213fee21f079c52839556e13b8a8529779df982f418756eb89ff
+  metadata.gz: c8fb9da5edd1a1ae78623dff1d3738e99ce3d25a9c0b124b5a5e44333233a68542c1f140f700d26d4e9563cb4fafe1e3135911760bf0fb286d5f0a6bb573f1ec
+  data.tar.gz: d5cb86a37083e309207fee3809114aec127d90e5f54a6ec9539b1f2da3355bbe00618acd2150dc36bb98907f6e3461cab1e2b024dd2572d7453ede51c816abb5

data/Gemfile

@@ -33,5 +33,5 @@ else
 end
 
 if RUBY_VERSION >= "3.0.0" && !is_truffleruby
-  gem "repl_type_completor"
+  gem "repl_type_completor", github: "ruby/repl_type_completor"
 end

data/doc/Index.md

@@ -98,7 +98,7 @@ To learn more about debugging with IRB, see [Debugging with IRB](#label-Debuggin
 At startup, IRB:
 
 1. Interprets (as Ruby code) the content of the [configuration file](rdoc-ref:Configurations.md) (if given).
-2. Constructs the initial session context from [hash IRB.conf](#label-Hash+IRB.conf) and from default values; the hash content may have been affected by [command-line options](#command-line-options), and by direct assignments in the configuration file.
+2. Constructs the initial session context from [hash IRB.conf](rdoc-ref:Configurations.md@Hash+IRB.conf) and from default values; the hash content may have been affected by [command-line options](#command-line-options), and by direct assignments in the configuration file.
 3. Assigns the context to variable `conf`.
 4. Assigns command-line arguments to variable `ARGV`.
 5. Prints the prompt.
@@ -692,7 +692,7 @@ Command-line option `-U` sets both to UTF-8.
 
 ## Contributing
 
-See [CONTRIBUTING.md](https://github.com/ruby/irb/blob/main/CONTRIBUTING.md) for more information.
+See [CONTRIBUTING.md](https://github.com/ruby/irb/blob/master/CONTRIBUTING.md) for more information.
 
 ## Extending IRB
 

data/lib/irb/color.rb

@@ -99,6 +99,7 @@ module IRB # :nodoc:
       REGEXP_BEGIN:       [RED, BOLD],
       REGEXP_END:         [RED, BOLD],
       STRING_BEGIN:       [RED, BOLD],
+      XSTRING_BEGIN:      [RED, BOLD],
       STRING_CONTENT:     [RED],
       STRING_END:         [RED, BOLD],
       __END__:            [GREEN],
@@ -258,6 +259,11 @@ module IRB # :nodoc:
           super
         end
 
+        def visit_implicit_node(_node)
+          # Label of implicit nodes are colored as LABEL in visit_symbol_node.
+          # We need to prevent value part from being colored with another type.
+        end
+
         def visit_call_node(node)
           if node.call_operator_loc.nil? && OPERATORS.include?(node.name)
             # Operators should not be colored as method call

data/lib/irb/command/load.rb

@@ -45,7 +45,7 @@ module IRB
       def execute_internal(file_name = nil)
         raise_cmd_argument_error unless file_name
 
-        rex = Regexp.new("#{Regexp.quote(file_name)}(\.o|\.rb)?")
+        rex = Regexp.new("(?:\\A|/)#{Regexp.escape(file_name)}(?:\\.o|\\.rb)?\\z")
         return false if $".find{|f| f =~ rex}
 
         case file_name
@@ -58,15 +58,15 @@ module IRB
           rescue LoadError
           end
         when /\.(so|o|sl)$/
-          return ruby_require(file_name)
+          return require(file_name)
         end
 
         begin
           irb_load(f = file_name + ".rb")
           $".push f
-          return true
+          true
         rescue LoadError
-          return ruby_require(file_name)
+          require(file_name)
         end
       end
     end

data/lib/irb/command/measure.rb

@@ -35,13 +35,19 @@ module IRB
           end
         when :on
           added = IRB.set_measure_callback(arg)
-          puts "#{added[0]} is added." if added
+          display_added_message(added[0]) if added
         else
           added = IRB.set_measure_callback(type, arg)
-          puts "#{added[0]} is added." if added
+          display_added_message(added[0]) if added
         end
         nil
       end
+
+      private
+
+      def display_added_message(added)
+        puts "#{added} is added."
+      end
     end
   end
 

data/lib/irb/command/pushws.rb

@@ -15,20 +15,26 @@ module IRB
       description "Show workspaces."
 
       def execute(_arg)
-        inspection_resuls = irb_context.instance_variable_get(:@workspace_stack).map do |ws|
+        inspection_results = irb_context.instance_variable_get(:@workspace_stack).map do |ws|
           truncated_inspect(ws.main)
         end
 
-        puts "[" + inspection_resuls.join(", ") + "]"
+        puts "[" + inspection_results.join(", ") + "]"
       end
 
       private
 
       def truncated_inspect(obj)
+        threshold = 20
         obj_inspection = obj.inspect
 
-        if obj_inspection.size > 20
-          obj_inspection = obj_inspection[0, 19] + "...>"
+        if obj_inspection.size > threshold
+          closing = obj_inspection[-1]
+          # Support closing characters for objects like:
+          # #<Object...>, [array...], {hash...}, (123/456...), "string...", /regexp.../
+          # Other objects will be truncated without a closing character.
+          closing = nil unless '>]})"/'.include?(closing)
+          obj_inspection = "#{obj_inspection[...threshold - 1]}...#{closing}"
         end
 
         obj_inspection

data/lib/irb/completion.rb

@@ -302,7 +302,7 @@ module IRB
           rescue EncodingError
             # ignore
           end
-          candidates.grep(/^#{Regexp.quote(sym)}/)
+          candidates.grep(/^#{Regexp.quote(sym)}/).sort
         end
       when /^::([A-Z][^:\.\(\)]*)$/
         # Absolute Constant or class methods
@@ -313,7 +313,7 @@ module IRB
         if doc_namespace
           candidates.find { |i| i == receiver }
         else
-          candidates.grep(/^#{Regexp.quote(receiver)}/).collect{|e| "::" + e}
+          candidates.grep(/^#{Regexp.quote(receiver)}/).sort.collect{|e| "::" + e}
         end
 
       when /^([A-Z].*)::([^:.]*)$/
@@ -331,7 +331,7 @@ module IRB
             candidates = []
           end
 
-          select_message(receiver, message, candidates.sort, "::")
+          select_message(receiver, message, candidates, "::")
         end
 
       when /^(:[^:.]+)(\.|::)([^.]*)$/
@@ -400,7 +400,7 @@ module IRB
         if doc_namespace
           all_gvars.find{ |i| i == gvar }
         else
-          all_gvars.grep(Regexp.new(Regexp.quote(gvar)))
+          all_gvars.grep(Regexp.new(Regexp.quote(gvar))).sort
         end
 
       when /^([^.:"].*)(\.|::)([^.]*)$/
@@ -452,7 +452,7 @@ module IRB
         if doc_namespace
           "String.#{candidates.find{ |i| i == message }}"
         else
-          select_message(receiver, message, candidates.sort)
+          select_message(receiver, message, candidates)
         end
       when /^\s*$/
         # empty input
@@ -491,7 +491,11 @@ module IRB
     Operators = %w[% & * ** + - / < << <= <=> == === =~ > >= >> [] []= ^ ! != !~]
 
     def select_message(receiver, message, candidates, sep = ".")
-      candidates.grep(/^#{Regexp.quote(message)}/).collect do |e|
+      sorted_candidates = candidates.grep(/^#{Regexp.quote(message)}/).sort_by do |e|
+        # Alphabetical order, but internal methods (leading underscore) last
+        [e.start_with?('_') ? 1 : 0, e]
+      end
+      sorted_candidates.collect do |e|
         case e
         when /^[a-zA-Z_]/
           receiver + sep + e

data/lib/irb/context.rb

@@ -475,8 +475,8 @@ module IRB
       @prompt_c = pconf[:PROMPT_C]
       @return_format = pconf[:RETURN]
       @return_format = "%s\n" if @return_format == nil
-      if ai = pconf.include?(:AUTO_INDENT)
-        @auto_indent_mode = ai
+      if pconf.include?(:AUTO_INDENT)
+        @auto_indent_mode = pconf[:AUTO_INDENT]
       else
         @auto_indent_mode = IRB.conf[:AUTO_INDENT]
       end

data/lib/irb/ext/eval_history.rb

@@ -50,7 +50,7 @@ module IRB # :nodoc:
           @eval_history_values = EvalHistory.new(no)
           IRB.conf[:__TMP__EHV__] = @eval_history_values
           workspace.evaluate("__ = IRB.conf[:__TMP__EHV__]")
-          IRB.conf.delete(:__TMP_EHV__)
+          IRB.conf.delete(:__TMP__EHV__)
         end
       else
         @eval_history_values = nil
@@ -97,8 +97,8 @@ module IRB # :nodoc:
     end
 
     def size(size) # :nodoc:
-      if size != 0 && size < @size
-        @contents = @contents[@size - size .. @size]
+      if size.positive? && @contents.size > size
+        @contents = @contents.last(size)
       end
       @size = size
     end

data/lib/irb/ext/loader.rb

@@ -13,9 +13,6 @@ module IRB # :nodoc:
   # See ExtendCommandBundle for more information.
   module IrbLoader
 
-    alias ruby_load load
-    alias ruby_require require
-
     # Loads the given file similarly to Kernel#load
     def irb_load(fn, priv = nil)
       path = search_file_from_ruby_path(fn)

data/lib/irb/history.rb

@@ -64,13 +64,6 @@ module IRB
     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
 
@@ -80,36 +73,43 @@ module IRB
         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") }
+      begin
+        ensure_history_file_permissions(history_file)
 
-        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
+        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)
+          f.puts(hist)
+        end
+      rescue Errno::ENOENT
+        warn <<~WARN
+          Can't write history to #{History.history_file.inspect} because the folder does not exist.
+          Please verify the value of `IRB.conf[:HISTORY_FILE]`. Ensure the folder exists.
+        WARN
+      rescue Errno::EACCES, Errno::EPERM
+        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
       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)
+    def ensure_history_file_permissions(history_file)
       history_file = Pathname.new(history_file)
 
-      return false unless history_file.dirname.writable?
-      return true unless history_file.exist?
+      return unless history_file.exist?
 
-      begin
-        if history_file.stat.mode & 0o66 != 0
-          history_file.chmod 0o600
-        end
-        true
-      rescue Errno::EPERM # no permissions
-        false
+      if history_file.stat.mode & 0o66 != 0
+        history_file.chmod 0o600
       end
     end
   end

data/lib/irb/init.rb

@@ -148,9 +148,12 @@ module IRB # :nodoc:
     @CONF[:MEASURE_PROC] = {}
     @CONF[:MEASURE_PROC][:TIME] = proc { |context, code, line_no, &block|
       time = Time.now
-      result = block.()
-      now = Time.now
-      puts 'processing time: %fs' % (now - time) if IRB.conf[:MEASURE]
+      begin
+        result = block.()
+      ensure
+        now = Time.now
+        puts 'processing time: %fs' % (now - time) if IRB.conf[:MEASURE]
+      end
       result
     }
     # arg can be either a symbol for the mode (:cpu, :wall, ..) or a hash for

data/lib/irb/input-method.rb

@@ -404,12 +404,29 @@ module IRB
     end
 
     def rdoc_dialog_contents(name, width)
+      formatter = RDoc::Markup::ToAnsi.new
+      formatter.width = width
+
+      begin
+        document = retrieve_rdoc_document(name)
+      rescue RDoc::RI::Driver::NotFoundError
+        return
+      rescue => e
+        raise if $DEBUG
+        return rdoc_error_document(e).accept(formatter).split("\n")
+      end
+      return unless document
+
+      [PRESS_ALT_D_TO_READ_FULL_DOC] + document.accept(formatter).split("\n")
+    end
+
+    def retrieve_rdoc_document(name)
       driver = rdoc_ri_driver
       return unless driver
 
       name = driver.expand_name(name)
 
-      doc = if name =~ /#|\./
+      if name =~ /#|\./
         d = RDoc::Markup::Document.new
         driver.add_method(d, name)
         d
@@ -423,11 +440,15 @@ module IRB
           driver.class_document(name, found, klasses, includes, extends)
         end
       end
+    end
 
-      formatter = RDoc::Markup::ToAnsi.new
-      formatter.width = width
-      [PRESS_ALT_D_TO_READ_FULL_DOC] + doc.accept(formatter).split("\n")
-    rescue RDoc::RI::Driver::NotFoundError
+    def rdoc_error_document(error)
+      document = RDoc::Markup::Document.new
+      document << RDoc::Markup::Paragraph.new("Failed to load the document:")
+      document << RDoc::Markup::Paragraph.new("#{error.class}: #{error.message}")
+      document << RDoc::Markup::BlankLine.new
+      document << RDoc::Markup::Paragraph.new("Restart IRB with -d to see the backtrace.")
+      document
     end
 
     def dialog_doc_position(cursor_pos_to_render, autocomplete_dialog, screen_width)

data/lib/irb/startup_message.rb

@@ -14,7 +14,6 @@ module IRB
       '"cd object" to navigate into an object',
       '"show_source method" to view source code',
       '"copy expr" to copy the output to clipboard',
-      '"debug" to start integration with the "debug" gem',
       '"history -g pattern" to search history',
     ].freeze
 

data/lib/irb/version.rb

@@ -5,7 +5,7 @@
 #
 
 module IRB # :nodoc:
-  VERSION = "1.18.0"
+  VERSION = "1.19.0"
   @RELEASE_VERSION = VERSION
-  @LAST_UPDATE_DATE = "2026-04-21"
+  @LAST_UPDATE_DATE = "2026-11-06"
 end

data/lib/irb.rb

@@ -53,7 +53,7 @@ module IRB
         irb = Irb.new
 
         # Only display the banner in the irb executable
-        if @CONF[:SHOW_BANNER] && ap_path&.end_with?("exe/irb")
+        if @CONF[:SHOW_BANNER] && ap_path&.end_with?("exe/irb") && STDIN.tty?
           StartupMessage.display
         end
       end

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: irb
 version: !ruby/object:Gem::Version
-  version: 1.18.0
+  version: 1.19.0
 platform: ruby
 authors:
 - aycabta