irb 1.6.2 → 1.6.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 2f4318c00db4c9aaf6b89c57e116935705e2bdf7f576c16c3ee8862102468d64
-  data.tar.gz: a685194eca805c046ffa7084273da09a6b40eb0a4b711f80e2e3da49df03b585
+  metadata.gz: f82a38c3bf30c31ffcac5b5dd8f7883d9edd65edfbba779d87a18eb028c88c93
+  data.tar.gz: d45c6f3671612e3186a902c9c3406df16b350ae9a91e89d85383544267bc3eed
 SHA512:
-  metadata.gz: fa16a155b6554feeb1876849e57032e25fbf6a6e5e094c96ae3602e82ef1c26f69c2ab169fb0a670178c3f0097912fbdb092e24285e0c41f0af0b7f381ea362f
-  data.tar.gz: acc20573c8b1291a87dba4fd244f7d408ba004c242c07f1d3afa9cde4e101c696e797059bbdbd310da96dec79213abcd68074f2fe76b0b9ce2368e049acd1db7
+  metadata.gz: 32eee54235bcc829238f55cb70d29cebce2c0024b6ebb76d9dfc6e168fd4d35fffccd228fa1b848ac4b5a3a0f35e4743533499a060ae2cf5858ffc9caee4ee8c
+  data.tar.gz: 20bc4fdda9f15c9c668ece83acf81c0b9828664d74dac042430cbbfe798e8467ddf9af0c41a63267ceee402eb92f71c9bc4413f7e91b95b5f8ba2bf64c989505

data/Gemfile

@@ -2,14 +2,17 @@ source "https://rubygems.org"
 
 gemspec
 
-group :development do
-  is_unix = RUBY_PLATFORM =~ /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i
-  is_truffleruby = RUBY_DESCRIPTION =~ /truffleruby/
-  gem "vterm", ">= 0.0.5" if is_unix && ENV['WITH_VTERM']
-  gem "yamatanooroti", ">= 0.0.6"
-  gem "rake"
-  gem "stackprof" if is_unix && !is_truffleruby
-  gem "test-unit"
-  gem "reline", github: "ruby/reline" if ENV["WITH_LATEST_RELINE"] == "true"
-  gem "debug", github: "ruby/debug"
+is_unix = RUBY_PLATFORM =~ /(aix|darwin|linux|(net|free|open)bsd|cygwin|solaris|irix|hpux)/i
+is_truffleruby = RUBY_DESCRIPTION =~ /truffleruby/
+
+if is_unix && ENV['WITH_VTERM']
+  gem "vterm", github: "ruby/vterm-gem"
+  gem "yamatanooroti", github: "ruby/yamatanooroti"
 end
+
+gem "stackprof" if is_unix && !is_truffleruby
+
+gem "reline", github: "ruby/reline" if ENV["WITH_LATEST_RELINE"] == "true"
+gem "rake"
+gem "test-unit"
+gem "debug", github: "ruby/debug"

data/README.md

@@ -6,7 +6,13 @@ The `irb` command from your shell will start the interpreter.
 
 ## Installation
 
-Add this line to your application's Gemfile:
+> **Note**
+>
+> IRB is a default gem of Ruby so you shouldn't need to install it separately.
+>
+> But if you're using Ruby 2.6 or later and want to upgrade/install a specific version of IRB, please follow these steps.
+
+To install it with `bundler`, add this line to your application's Gemfile:
 
 ```ruby
 gem 'irb'
@@ -14,31 +20,62 @@ gem 'irb'
 
 And then execute:
 
-    $ bundle
+```shell
+$ bundle
+```
 
-Or install it yourself as:
+Or install it directly with:
 
-    $ gem install irb
+```shell
+$ gem install irb
+```
 
 ## Usage
 
-Use of irb is easy if you know Ruby.
+### The `irb` Executable
 
-When executing irb, prompts are displayed as follows. Then, enter the Ruby expression. An input is executed when it is syntactically complete.
+You can start a fresh IRB session by typing `irb` in your terminal.
 
-```
+In the session, you can evaluate Ruby expressions or even prototype a small Ruby script. An input is executed when it is syntactically complete.
+
+```shell
 $ irb
-irb(main):001:0> 1+2
-#=> 3
-irb(main):002:0> class Foo
-irb(main):003:1>   def foo
-irb(main):004:2>     print 1
-irb(main):005:2>   end
-irb(main):006:1> end
-#=> nil
+irb(main):001:0> 1 + 2
+=> 3
+irb(main):002:1* class Foo
+irb(main):003:2*   def foo
+irb(main):004:2*     puts 1
+irb(main):005:1*   end
+irb(main):006:0> end
+=> :foo
+irb(main):007:0> Foo.new.foo
+1
+=> nil
 ```
 
-The Readline extension module can be used with irb. Use of Readline is default if it's installed.
+### The `binding.irb` Breakpoint
+
+If you use Ruby 2.5 or later versions, you can also use `binding.irb` in your program as breakpoints.
+
+Once a `binding.irb` is evaluated, a new IRB session will be started with the surrounding context:
+
+```shell
+$ ruby test.rb
+
+From: test.rb @ line 2 :
+
+    1: def greet(word)
+ => 2:   binding.irb
+    3:   puts "Hello #{word}"
+    4: end
+    5:
+    6: greet("World")
+
+irb(main):001:0> word
+=> "World"
+irb(main):002:0> exit
+Hello World
+```
 
 ## Commands
 

data/exe/irb

@@ -1,8 +1,6 @@
 #!/usr/bin/env ruby
 #
 #   irb.rb - interactive ruby
-#   	$Release Version: 0.9.6 $
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
 

data/irb.gemspec

@@ -16,6 +16,11 @@ Gem::Specification.new do |spec|
   spec.homepage      = "https://github.com/ruby/irb"
   spec.licenses      = ["Ruby", "BSD-2-Clause"]
 
+  spec.metadata["homepage_uri"] = spec.homepage
+  spec.metadata["source_code_uri"] = spec.homepage
+  spec.metadata["documentation_uri"] = spec.homepage
+  spec.metadata["changelog_uri"] = "#{spec.homepage}/releases"
+
   spec.files         = [
     ".document",
     "Gemfile",

data/lib/irb/cmd/chws.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   change-ws.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 require_relative "nop"
 require_relative "../ext/change-ws"

data/lib/irb/cmd/fork.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   fork.rb -
-#   	$Release Version: 0.9.6 $
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 require_relative "nop"
 

data/lib/irb/cmd/help.rb

@@ -1,12 +1,6 @@
 # frozen_string_literal: false
 #
 #   help.rb - helper using ri
-#   	$Release Version: 0.9.6$
-#   	$Revision$
-#
-# --
-#
-#
 #
 
 require_relative "nop"

data/lib/irb/cmd/load.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   load.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 require_relative "nop"
 require_relative "../ext/loader"

data/lib/irb/cmd/ls.rb

@@ -38,21 +38,34 @@ module IRB
 
       def dump_methods(o, klass, obj)
         singleton_class = begin obj.singleton_class; rescue TypeError; nil end
-        maps = class_method_map((singleton_class || klass).ancestors)
+        dumped_mods = Array.new
+        # singleton_class' ancestors should be at the front
+        maps = class_method_map(singleton_class&.ancestors || [], dumped_mods) + class_method_map(klass.ancestors, dumped_mods)
         maps.each do |mod, methods|
           name = mod == singleton_class ? "#{klass}.methods" : "#{mod}#methods"
           o.dump(name, methods)
         end
       end
 
-      def class_method_map(classes)
-        dumped = Array.new
-        classes.reject { |mod| mod >= Object }.map do |mod|
-          methods = mod.public_instance_methods(false).select do |m|
-            dumped.push(m) unless dumped.include?(m)
+      def class_method_map(classes, dumped_mods)
+        dumped_methods = Array.new
+        classes = classes.reject { |mod| mod >= Object }
+        classes.map do |mod|
+          next if dumped_mods.include? mod
+
+          dumped_mods << mod
+
+          methods = mod.public_instance_methods(false).select do |method|
+            if dumped_methods.include? method
+              false
+            else
+              dumped_methods << method
+              true
+            end
           end
+
           [mod, methods]
-        end.reverse
+        end.compact
       end
 
       class Output

data/lib/irb/cmd/nop.rb

@@ -1,14 +1,9 @@
 # frozen_string_literal: false
 #
 #   nop.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
+
 module IRB
   # :stopdoc:
 

data/lib/irb/cmd/pushws.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   change-ws.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 require_relative "nop"
 require_relative "../ext/workspaces"

data/lib/irb/cmd/show_source.rb

@@ -40,15 +40,15 @@ module IRB
             file, line = receiver.method(method).source_location if receiver.respond_to?(method)
           end
           if file && line
-            Source.new(file: file, first_line: line, last_line: find_end(file, line))
+            Source.new(file: file, first_line: line, last_line: find_end(file, line, irb_context))
           end
         end
 
         private
 
-        def find_end(file, first_line)
+        def find_end(file, first_line, irb_context)
           return first_line unless File.exist?(file)
-          lex = RubyLex.new
+          lex = RubyLex.new(irb_context)
           lines = File.read(file).lines[(first_line - 1)..-1]
           tokens = RubyLex.ripper_lex_without_warning(lines.join)
           prev_tokens = []

data/lib/irb/cmd/subirb.rb

@@ -1,13 +1,8 @@
 # frozen_string_literal: false
+#
 #   multi.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 require_relative "nop"
 

data/lib/irb/color.rb

@@ -242,7 +242,7 @@ module IRB # :nodoc:
         case token
         when :on_symbeg, :on_symbols_beg, :on_qsymbols_beg
           @stack << true
-        when :on_ident, :on_op, :on_const, :on_ivar, :on_cvar, :on_gvar, :on_kw
+        when :on_ident, :on_op, :on_const, :on_ivar, :on_cvar, :on_gvar, :on_kw, :on_backtick
           if @stack.last # Pop only when it's Symbol
             @stack.pop
             return prev_state

data/lib/irb/completion.rb

@@ -1,8 +1,6 @@
 # frozen_string_literal: false
 #
 #   irb/completion.rb -
-#   	$Release Version: 0.9$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
 #       From Original Idea of shugo@ruby-lang.org
 #
@@ -168,10 +166,12 @@ module IRB
 
     def self.retrieve_completion_data(input, bind: IRB.conf[:MAIN_CONTEXT].workspace.binding, doc_namespace: false)
       case input
-      when /^((["'`]).*\2)\.([^.]*)$/
+      # this regexp only matches the closing character because of irb's Reline.completer_quote_characters setting
+      # details are described in: https://github.com/ruby/irb/pull/523
+      when /^(.*["'`])\.([^.]*)$/
         # String
         receiver = $1
-        message = $3
+        message = $2
 
         if doc_namespace
           "String.#{message}"
@@ -180,7 +180,9 @@ module IRB
           select_message(receiver, message, candidates)
         end
 
-      when /^(\/[^\/]*\/)\.([^.]*)$/
+      # this regexp only matches the closing character because of irb's Reline.completer_quote_characters setting
+      # details are described in: https://github.com/ruby/irb/pull/523
+      when /^(.*\/)\.([^.]*)$/
         # Regexp
         receiver = $1
         message = $2
@@ -217,7 +219,7 @@ module IRB
           select_message(receiver, message, proc_candidates | hash_candidates)
         end
 
-      when /^(:[^:.]*)$/
+      when /^(:[^:.]+)$/
         # Symbol
         if doc_namespace
           nil
@@ -358,14 +360,6 @@ module IRB
         else
           # func1.func2
           candidates = []
-          to_ignore = ignored_modules
-          ObjectSpace.each_object(Module){|m|
-            next if (to_ignore.include?(m) rescue true)
-            next unless m.respond_to?(:instance_methods) # JRuby has modules that represent java packages. They don't include many common ruby methods
-            candidates.concat m.instance_methods(false).collect{|x| x.to_s}
-          }
-          candidates.sort!
-          candidates.uniq!
         end
 
         if doc_namespace

data/lib/irb/context.rb

@@ -1,14 +1,9 @@
 # frozen_string_literal: false
 #
 #   irb/context.rb - irb context
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
+
 require_relative "workspace"
 require_relative "inspector"
 require_relative "input-method"
@@ -499,7 +494,7 @@ module IRB
         line = "#{command} #{command_class.transform_args(args)}"
       end
 
-      set_last_value(@workspace.evaluate(self, line, irb_path, line_no))
+      set_last_value(@workspace.evaluate(line, irb_path, line_no))
     end
 
     def inspect_last_value # :nodoc:

data/lib/irb/ext/change-ws.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   irb/ext/cb.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 module IRB # :nodoc:
   class Context

data/lib/irb/ext/history.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   history.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 module IRB # :nodoc:
 
@@ -24,7 +18,7 @@ module IRB # :nodoc:
 
       if defined?(@eval_history) && @eval_history
         @eval_history_values.push @line_no, @last_value
-        @workspace.evaluate self, "__ = IRB.CurrentContext.instance_eval{@eval_history_values}"
+        @workspace.evaluate "__ = IRB.CurrentContext.instance_eval{@eval_history_values}"
       end
 
       @last_value
@@ -55,7 +49,7 @@ module IRB # :nodoc:
         else
           @eval_history_values = History.new(no)
           IRB.conf[:__TMP__EHV__] = @eval_history_values
-          @workspace.evaluate(self, "__ = IRB.conf[:__TMP__EHV__]")
+          @workspace.evaluate("__ = IRB.conf[:__TMP__EHV__]")
           IRB.conf.delete(:__TMP_EHV__)
         end
       else

data/lib/irb/ext/loader.rb

@@ -1,15 +1,8 @@
 # frozen_string_literal: false
 #
 #   loader.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
-
 
 module IRB # :nodoc:
   # Raised in the event of an exception in a file loaded from an Irb session

data/lib/irb/ext/multi-irb.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   irb/multi-irb.rb - multiple irb module
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 module IRB
   class JobManager

data/lib/irb/ext/save-history.rb

@@ -1,13 +1,8 @@
 # frozen_string_literal: false
+#
 #   save-history.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 module IRB
   module HistorySavingAbility # :nodoc:

data/lib/irb/ext/tracer.rb

@@ -1,14 +1,9 @@
 # frozen_string_literal: false
 #
 #   irb/lib/tracer.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
+
 begin
   require "tracer"
 rescue LoadError
@@ -70,12 +65,12 @@ module IRB
       if context.use_tracer? && file != nil && line != nil
         Tracer.on
         begin
-          __evaluate__(context, statements, file, line)
+          __evaluate__(statements, file, line)
         ensure
           Tracer.off
         end
       else
-        __evaluate__(context, statements, file || __FILE__, line || __LINE__)
+        __evaluate__(statements, file || __FILE__, line || __LINE__)
       end
     end
   end

data/lib/irb/ext/use-loader.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   use-loader.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 require_relative "../cmd/load"
 require_relative "loader"

data/lib/irb/ext/workspaces.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   push-ws.rb -
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
 
 module IRB # :nodoc:
   class Context

data/lib/irb/extend-command.rb

@@ -1,14 +1,9 @@
 # frozen_string_literal: false
 #
 #   irb/extend-command.rb - irb extend command
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ruby-lang.org)
 #
-# --
-#
-#
-#
+
 module IRB # :nodoc:
   # Installs the default irb extensions command bundle.
   module ExtendCommandBundle
@@ -264,8 +259,8 @@ module IRB # :nodoc:
         kwargs = ", **kwargs" if RUBY_ENGINE == "ruby" && RUBY_VERSION >= "2.7.0"
         line = __LINE__; eval %[
           def #{cmd_name}(*opts#{kwargs}, &b)
-            require_relative "#{load_file}"
-            arity = ExtendCommand::#{cmd_class}.instance_method(:execute).arity
+            Kernel.require_relative "#{load_file}"
+            arity = ::IRB::ExtendCommand::#{cmd_class}.instance_method(:execute).arity
             args = (1..(arity < 0 ? ~arity : arity)).map {|i| "arg" + i.to_s }
             args << "*opts#{kwargs}" if arity < 0
             args << "&block"
@@ -274,7 +269,7 @@ module IRB # :nodoc:
               unless singleton_class.class_variable_defined?(:@@#{cmd_name}_)
                 singleton_class.class_variable_set(:@@#{cmd_name}_, true)
                 def self.#{cmd_name}_(\#{args})
-                  ExtendCommand::#{cmd_class}.execute(irb_context, \#{args})
+                  ::IRB::ExtendCommand::#{cmd_class}.execute(irb_context, \#{args})
                 end
               end
             ], nil, __FILE__, line
@@ -284,7 +279,7 @@ module IRB # :nodoc:
       else
         line = __LINE__; eval %[
           def #{cmd_name}(*opts, &b)
-            ExtendCommand::#{cmd_class}.execute(irb_context, *opts, &b)
+            ::IRB::ExtendCommand::#{cmd_class}.execute(irb_context, *opts, &b)
           end
         ], nil, __FILE__, line
       end

data/lib/irb/frame.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   frame.rb -
-#   	$Release Version: 0.9$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(Nihon Rational Software Co.,Ltd)
 #
-# --
-#
-#
-#
 
 module IRB
   class Frame

data/lib/irb/help.rb

@@ -1,14 +1,8 @@
 # frozen_string_literal: false
 #
 #   irb/help.rb - print usage module
-#   	$Release Version: 0.9.6$
-#   	$Revision$
 #   	by Keiju ISHITSUKA(keiju@ishitsuka.com)
 #
-# --
-#
-#
-#
 
 require_relative 'magic-file'