irbtools 3.0.5 → 4.0.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 97638932440324b1ac2515e752f8246e725a9424b20e2ccdb7e3bf9c19c4d73f
-  data.tar.gz: 92466a6931a28d47fc933be842347daf9cd5caea37a5929fd125e7031b855b0a
+  metadata.gz: 1e9a398324ec34c6a93632f3eb26f84be51607b45e1e06e311a3c7507e11e15b
+  data.tar.gz: bb9072432d1e2404e9bcb1a763d338458d97d8126bbdd6e26b773aaff98c514e
 SHA512:
-  metadata.gz: a7632dbde24787c8fca33e883b549c8519f9bb4fe18035b788cfd412adfb7a9f255b3b814d24bb71a60f067cb6aabd26c3ab71f2eb5a18c9e2639cdf90715dee
-  data.tar.gz: cd8474954adc2b449e4bdb99b1631cec1036027158d8b87ad2a2addee4eabc4f984e4135cbd3ebab67ddbf332f3daa2d75bb6a216423202d06d0eb09f385a082
+  metadata.gz: 33c1fd0e1ee8b60cccbc8cc10620341826aaaebaed527bea9e4a046347d2a1753c91bdb69204619de6624981ed58e838d5b0fdf7c08cf26ce24375ec0d9a39ce
+  data.tar.gz: 2c8c5a3668896580a9f0e6f6e8a959eff7b80caacbfb3b6632114063ad1f511e03d56b3dccf84f0d6f5ccc42e3c16c8f065315feed9022f41a3ffd15f182083f

data/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Irbtools Changelog
 
+## 4.0
+
+* Requires IRB 1.6 (Ruby 3.2 bundles IRB 1.6.2)
+* Requires Ruby 3.0
+
+* Remove a bunch of gems:
+    * Drop binding.repl gem since it was only needed for older Rubies
+    * Drop ori gem, since IRB now has `show_doc`
+    * Drop RubyInfo
+
+* Retire irbtools-more:
+  * Move looksee to core irbtools
+  * Move core_docs to core irbtools
+  * Remove bond (outdated)
+  * Leave binding_of_caller optional
+
+* Add command wrappers for code, howtocall, looksee, shadow
+* Add `$` command to directly call system
+
+* Version bumps: looksee, os, methodfinder, code, core_docs, debugging
+* Alias IRB's ls to ils (fixes #53)
+* Remove support for RIPL repl (outdated)
+
 ## 3.0.5
 * Bump methodfinder dependency & update usage (fixes #52)
 

data/CONFIGURE.md

@@ -43,8 +43,7 @@ The following options are possible
 :   Same as `:thread`, but after loading late libraries.
 `:sub_session => true`
 :   The library is loaded every time a sub-session starts (using
-    `IRB.conf[:IRB_RC]`). In [ripl](https://github.com/cldwalker/ripl),
-    `ripl-after_rc` is used.
+    `IRB.conf[:IRB_RC]`).
 `:autoload => :Constant`
 :   Use Ruby's `autoload` feature. It loads the library as soon as the
     constant is encountered.

data/MIT-LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2021 Jan Lelis
+Copyright (c) 2010-2022 Jan Lelis
 
 Permission is hereby granted, free of charge, to any person obtaining
 a copy of this software and associated documentation files (the

data/README.md

@@ -1,19 +1,156 @@
 # Irbtools [![[version]](https://badge.fury.io/rb/irbtools.svg)](https://badge.fury.io/rb/irbtools)  [![[ci]](https://github.com/janlelis/irbtools/workflows/Test/badge.svg)](https://github.com/janlelis/irbtools/actions?query=workflow%3ATest)
 
+## Irbtools 4.0 for IRB 1.6+
+
+The current version of Irbtools requires [IRB 1.6+](https://github.com/ruby/irb) (which is the default for Ruby
+from 3.2 on). Please use Irbtools 3 for earlier versions of IRB.
+
+## Description
+
+Improves Ruby's IRB with:
+
+- a default configuration
+- improved syntax highlighting of result objects
+- helpful commands for debugging and introspection
+
+## Examples
+
+### Show lookup chain and method list grouped by visibility
+
+```ruby
+>> shadow [1,2,3].reverse
+=> # ObjectShadow of Object #85280
+
+## Lookup Chain
+
+    [#<Class:#<Array:0x00007fccd9cfac30>>, Array, Enumerable, Object, "…"]
+
+## 141 Public Methods (Non-Class/Object)
+
+    [:&, :*, :+, :-, :<<, :<=>, :==, :[], :[]=, :all?, :any?, :append, :assoc, :at, :bsearch, :bsearch_index, :chain,
+    :chunk, :chunk_while, :clear, :collect, :collect!, :collect_concat, :combination, :compact, :compact!, :concat,
+    :count, :cycle, :deconstruct, :delete, :delete_at, :delete_if, :detect, :difference, :dig, :drop, :drop_while,
+    :each, :each_cons, :each_entry, :each_index, :each_slice, :each_with_index, :each_with_object, :empty?, :entries,
+    :eql?, :fetch, :fill, :filter, :filter!, :filter_map, :find, :find_all, :find_index, :first, :flat_map, :flatten,
+    :flatten!, :grep, :grep_v, :group_by, :hash, :include?, :index, :inject, :insert, :inspect, :intersect?,
+    :intersection, :join, :keep_if, :last, :lazy, :length, :map, :map!, :max, :max_by, :member?, :min, :min_by,
+    :minmax, :minmax_by, :none?, :one?, :pack, :partition, :permutation, :pop, :prepend, :product, :push, :rassoc,
+    :reduce, :reject, :reject!, :repeated_combination, :repeated_permutation, :replace, :reverse, :reverse!,
+    :reverse_each, :rindex, :rotate, :rotate!, :sample, :select, :select!, :shelljoin, :shift, :shuffle, :shuffle!,
+    :size, :slice, :slice!, :slice_after, :slice_before, :slice_when, :sort, :sort!, :sort_by, :sort_by!, :sum,
+    :take, :take_while, :tally, :to_a, :to_ary, :to_h, :to_s, :to_set, :transpose, :union, :uniq, :uniq!, :unshift,
+    :values_at, :zip, :|]
+
+## 2 Private Methods (Non-Class/Object)
+
+    [:initialize, :initialize_copy]
+
+## Object Inspect
+
+    [3, 2, 1]
+```
+
+### Show a method list grouped by ancestors
+
+```ruby
+>> look "str"
+.
+.
+.
+Comparable
+  <  <=  ==  >  >=  between?  clamp
+String
+  %            crypt                  inspect      squeeze!
+  *            dedup                  intern       start_with?
+  +            delete                 length       strip
+  +@           delete!                lines        strip!
+  -@           delete_prefix          ljust        sub
+  <<           delete_prefix!         lstrip       sub!
+  <=>          delete_suffix          lstrip!      succ
+.
+.
+.
+```
+
+### Show source code of a Ruby-based method
+
+```ruby
+>> code SecureRandom.uuid
+#
+#   /home/dan/.rvm/rubies/ruby-3.2.0/lib/ruby/3.2.0/random/formatter.rb:170
+#
+# Generate a random v4 UUID (Universally Unique IDentifier).
+#
+#   require 'random/formatter'
+#
+#   Random.uuid #=> "2d931510-d99f-494a-8c67-87feb05e1594"
+#   Random.uuid #=> "bad85eb9-0713-4da7-8d36-07a8e4b00eab"
+#   # or
+#   prng = Random.new
+#   prng.uuid #=> "62936e70-1815-439b-bf89-8492855a7e6b"
+#
+# The version 4 UUID is purely random (except the version).
+# It doesn't contain meaningful information such as MAC addresses, timestamps, etc.
+#
+# The result contains 122 random bits (15.25 random bytes).
+#
+# See RFC4122[https://datatracker.ietf.org/doc/html/rfc4122] for details of UUID.
+#
+def uuid
+  ary = random_bytes(16).unpack("NnnnnN")
+  ary[2] = (ary[2] & 0x0fff) | 0x4000
+  ary[3] = (ary[3] & 0x3fff) | 0x8000
+  "%08x-%04x-%04x-%04x-%04x%08x" % ary
+end
+```
+
+### Show source code of a natively implemented method
+
+```ruby
+>> code Array#reverse
+//
+//   https://github.com/ruby/ruby/blob/ruby_3_2/array.c#L3282
+//
+// Returns a new \Array with the elements of +self+ in reverse order:
+//
+//   a = ['foo', 'bar', 'two']
+//   a1 = a.reverse
+//   a1 # => ["two", "bar", "foo"]
+static VALUE
+rb_ary_reverse_m(VALUE ary)
+{
+    long len = RARRAY_LEN(ary);
+    VALUE dup = rb_ary_new2(len);
+
+    if (len > 0) {
+        const VALUE *p1 = RARRAY_CONST_PTR_TRANSIENT(ary);
+        VALUE *p2 = (VALUE *)RARRAY_CONST_PTR_TRANSIENT(dup) + len - 1;
+        do *p2-- = *p1++; while (--len > 0);
+    }
+    ARY_SET_LEN(dup, RARRAY_LEN(ary));
+    return dup;
+}
+```
+
+### Find out method signatures (most useful for Ruby-based methods with keyword args)
+
 ```ruby
-                                                                                 _|          _|
- _|_|_|  _|_|_|    _|_|_|        _|                          _|                _|    _|_|_|    _|
-   _|    _|    _|  _|    _|    _|_|_|_|    _|_|      _|_|    _|    _|_|_|      _|          _|  _|
-   _|    _|_|_|    _|_|_|        _|      _|    _|  _|    _|  _|  _|_|          _|      _|_|    _|
-   _|    _|    _|  _|    _|      _|      _|    _|  _|    _|  _|      _|_|      _|          _|  _|
- _|_|_|  _|    _|  _|_|_|    _|    _|_|    _|_|      _|_|    _|  _|_|_|        _|    _|_|_|    _|
-                                                                                 _|          _|
+>> howtocall require
+require(path)
 ```
 
-Improvements for Ruby's IRB console, like syntax highlighted output and a lot of
-debugging and introspection methods. Unlike with PRY, you are still in your
-normal IRB. It is designed to work out-of-the-box, so there is no reason to not
-use it!
+```ruby
+>> require "rubygems/user_interaction"
+>> ui = Gem::ConsoleUI.new
+>> howtocall ui.choose_from_list
+choose_from_list(question, list)
+```
+
+### Call system commands with `$`
+
+```ruby
+>> $ git status # displays current git status
+```
 
 ## Setup
 
@@ -28,55 +165,66 @@ You also need to add irbtools to your project's `Gemfile`:
 
     gem 'irbtools', require: 'irbtools/binding'
 
-Then start IRB (with **Irbtools** loaded) from the terminal or directly from your code with:
+Then start IRB (with **Irbtools** loaded) from the terminal or directly from
+your code with:
 
     binding.irb
 
-### Enable More Gems
-
-Some suggested gems will not be installed to ensure wider general support. For
-the full feature set, you can install **irbtools-more**. To do so, change your
-`.irbrc` to:
-
-    require 'irbtools/more'
+*Optional:* If the **binding_of_caller** gem is available, you can just call the `irb`
+method and it will start a session with the current binding:
 
-and edit your `Gemfile` to read like this:
-
-    gem 'irbtools-more', require: 'irbtools/binding'
+    irb
 
 ## Features
 
-### Irbtools' IRB Improvements
+### General IRB Improvements
 
 - Syntax highlighting ([wirb](https://github.com/janlelis/wirb/) / [fancy_irb](https://github.com/janlelis/fancy_irb))
-- Loads included third party libraries effeciently
-- Customizable views for specfic options using [hirb](https://tagaholic.me/2009/03/13/hirb-irb-on-the-good-stuff.html)
-  - ActiveRecord results get displayed as a table
--  **(irbtools-more)** [Improved tab-completion](https://tagaholic.me/bond/)
+- Loads included libraries efficiently to reduce IRB start-up time
+- Customizable views for specfic options using [hirb](https://tagaholic.me/2009/03/13/hirb-irb-on-the-good-stuff.html). By default, ActiveRecord results get displayed as a table.
 
-### Irbtools' Included Methods for IRB
+### Included Debugging Methods for IRB
 
 #### Highlights
 
 - Lookup and manipulate instance variables / methods with ease using [object_shadow](https://github.com/janlelis/object_shadow/)
-- **(irbtools-more)** Go even further with [looksee](https://github.com/oggy/looksee), the best lookup path inspection tool out there
+- Go even further with [looksee](https://github.com/oggy/looksee), the best lookup path inspection tool out there
 - Display a method's source code using [code](https://github.com/janlelis/code)
-- Inline access to *ri* docs by [ori](https://github.com/dadooda/ori)
-  - If you have deactivated *ri*, you can re-generate the docs with something like: `rvm docs generate-ri`
 - Find methods that turn one value into another value with [methodfinder](https://github.com/citizen428/methodfinder)
 - [Use VIM from inside IRB](https://github.com/jberkel/interactive_editor)
 
+#### Extra Commands
+
+Commands get treated specially by IRB and do not necessarily follow Ruby syntax.
+
+Command | Alias | Description | Example
+------ | ---------- | ---------|---
+`code ` | - | Shows syntax-highlighted source code of a method | `code Array#reverse`
+`howtocall ` | - | Shows the method signature | `howtocall String#gsub`
+`look ` | - | Shows looksee method list | `look [1,2,3]`
+`shadow ` | `+ ` | Shows object shadow method list | `shadow [1,2,3]`
+`sys ` | `$ ` | Calls system shell | `$ top`
+
+Two default commands have an additional alias:
+
+Command | Alias | Description | Example
+------ | ---------- | ---------|---
+`show_doc` | `ri ` | Shows documentation | `ri String#gsub`
+`chws` | `co ` | "change into an object" | `co [1,2,3]`
+
+##### IRB's ls?
+
+Please note that IRB's own **ls** command is aliased to `ils`, since `ls` already refers to a method listing all files in the current directory. If you haven't tried looksee (`look`) or object shadows (`shadow`) - give it a try ;)
+
 #### Ruby Introspection
 
 Method / Constant | Arguments  | Description | Provided By
 ------ | ---------- | -----------|-
-`code` | object = self, method_name | Display the method source with syntax highlighting. Will also look up C methods if the **core_docs** gem (which is included in **irbtools-more**) is available. | [code](https://github.com/janlelis/code)
+`Object#lp` or `Object#look` | | Supercharged method introspection in IRB | [looksee](https://github.com/oggy/looksee)
+`Object#shadow` | | Manipulate instance variables and learn about callable methods |  [object_shadow](https://github.com/janlelis/object_shadow/)
+`code` | object = self, method_name | Display the method source with syntax highlighting. Will also try to look up C methods. | [code](https://github.com/janlelis/code)
 `howtocall` | object = self, method_or_proc | Display parameter names and types you will need to call a method | [debugging/howtocall](https://github.com/janlelis/debugging#howtocallobj--self-method_or_proc)
 `mf` | object1, object2 | Find methods which turn one value into another value | [methodfinder](https://github.com/citizen428/methodfinder)
-`mof` | object, depth = 0, grep = // | Print a method list, ordered by modules (looksee lite) | [debugging](https://github.com/janlelis/debugging#mofobj-depth--nil)
-`Object#lp` | | **(irbtools-more)** Supercharged method introspection in IRB | [looksee](https://github.com/oggy/looksee)
-`Object#ri` | *args | Show ri documentation for this object or method | [ori](https://github.com/dadooda/ori)
-`Object#shadow` | | Manipulate instance variables and learn about callable methods |  [object_shadow](https://github.com/janlelis/object_shadow/)
 
 #### Platform Info
 
@@ -85,14 +233,15 @@ Method / Constant | Arguments  | Description | Provided By
 `OS` | | Query operating system information | [os](https://github.com/rdp/os)
 `RubyVersion` | | Show the Ruby version | [ruby_version](https://github.com/janlelis/ruby_version)
 `RubyEngine` | | Show the Ruby engine | [ruby_engine](https://github.com/janlelis/ruby_engine)
-`RubyInfo` | | List general information about the Ruby environment | [ruby_info](https://github.com/janlelis/ruby_info)
 
 #### General Utils
 
 Method / Constant | Arguments  | Description | Provided By
 ------ | ---------- | -----------|-
 `beep` | | Ring terminal bell | [debugging/beep](https://github.com/janlelis/debugging#beep)
+`clear` | | Clear the terminal | [every_day_irb](https://github.com/janlelis/every_day_irb)
 `copy` | string | Copy something to the clipboard | [clipboard](https://github.com/janlelis/clipboard)
+`copy_output` | | Copy session output history to the clipboard | [clipboard](https://github.com/janlelis/clipboard), irbtools
 `colorize` | string | Syntax-highlight a string of Ruby code | [coderay](https://github.com/rubychan/coderay), irbtools
 `ed` / `emacs` / `mate` / `mvim` / `nano` / `vi` / `vim` | filename = nil | Start an editor in the session context | [interactive_editor](https://github.com/jberkel/interactive_editor)
 `ld` | file | Shortcut for `load lib.to_s + '.rb'` | [every_day_irb](https://github.com/janlelis/every_day_irb)
@@ -101,21 +250,12 @@ Method / Constant | Arguments  | Description | Provided By
 `paste` | | Paste clipboard content | [clipboard](https://github.com/janlelis/clipboard)
 `q` | *args | Like `Kernel#p`, but prints results on one line, with different colors | [debugging/q](https://github.com/janlelis/debugging#qargs)
 `re` | string, regexg, groups = nil | Regex debugging helper | [debugging/re](https://github.com/janlelis/debugging#qargs)
+`reset!` | | Restart the current IRB session | [every_day_irb](https://github.com/janlelis/every_day_irb)
 `rq` | lib | Shortcut for `require lib.to_s`. Use it like this: `rq:prime` | [every_day_irb](https://github.com/janlelis/every_day_irb)
 `rr` | lib | Shortcut for `require_relative lib.to_s` |  [every_day_irb](https://github.com/janlelis/every_day_irb)
 `rrq` / `rerequire` | lib | Hack to remove a library from `$LOADED_FEATURES` and `require` it again | [every_day_irb](https://github.com/janlelis/every_day_irb)
 `wp` | inspect_string | Syntax-highlight a Ruby return value | [wirb](https://github.com/janlelis/wirb#kernelwp)
 
-#### IRB Support
-
-Method / Constant | Arguments  | Description | Provided By
------- | ---------- | -----------|-
-`clear` | | Clear the terminal | [every_day_irb](https://github.com/janlelis/every_day_irb)
-`copy_input` | | Copy session history to the clipboard | [clipboard](https://github.com/janlelis/clipboard), irbtools
-`copy_output` | | Copy session output history to the clipboard | [clipboard](https://github.com/janlelis/clipboard), irbtools
-`reset!` | | Restart the current IRB session | [every_day_irb](https://github.com/janlelis/every_day_irb)
-`session_history` | number_of_lines = nil | Return a string of all commands issued in the current session | [every_day_irb](https://github.com/janlelis/every_day_irb)
-
 #### Files and Navigation
 
 Method / Constant | Arguments  | Description | Provided By
@@ -128,7 +268,7 @@ Method / Constant | Arguments  | Description | Provided By
 `chown_R` | user, group, path | Set file owner for directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
 `cp` | source, destination | Copy file | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
 `cp_r` | source, destination | Copy directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
-`ls` | path = "." | List directory content | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`ls` | path = "." | List directory content | [cd](https://github.com/janlelis/cd)
 `ln` | target, link | Create symlink (`ln`) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
 `ln_s` | target, link | Create symlink (`ln -s`) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
 `ln_sf` | target, link | Create symlink (`ln -sf`) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
@@ -173,12 +313,7 @@ You can use **Irbtools** without colors/IRB extensions. To do so, put this into
 require 'irbtools/non_fancy'
 Irbtools.start
 ```
-
-### Hint: Web Console and Other Approaches
-
-**Irbtools** works well together with the amazing [web-console!](https://github.com/rails/web-console), and also with the [ripl](https://github.com/cldwalker/ripl) IRB alternative.
-
 ## J-_-L
 
-Copyright (c) 2010-2021 Jan Lelis <https://janlelis.com> released under the MIT
+Copyright (c) 2010-2022 Jan Lelis <https://janlelis.com> released under the MIT
 license.

data/irbtools.gemspec

@@ -5,7 +5,7 @@ Gem::Specification.new do |s|
   s.name = 'irbtools'
   s.version = Irbtools::VERSION
 
-  s.homepage              = 'https://irb.tools'
+  s.homepage              = 'https://github.com/janlelis/irbtools'
   s.authors               = ["Jan Lelis"]
   s.email                 = ["hi@ruby.consulting"]
   s.summary               = 'Irbtools happy IRB.'
@@ -20,6 +20,12 @@ Gem::Specification.new do |s|
     lib/irbtools/hirb.rb
     lib/irbtools/minimal.rb
     lib/irbtools/binding.rb
+    lib/irbtools/commands.rb
+    lib/irbtools/commands/code.rb
+    lib/irbtools/commands/howtocall.rb
+    lib/irbtools/commands/look.rb
+    lib/irbtools/commands/shadow.rb
+    lib/irbtools/commands/sys.rb
     Rakefile
     irbtools.gemspec
   ]
@@ -29,35 +35,35 @@ Gem::Specification.new do |s|
     CHANGELOG.md
     MIT-LICENSE.txt
   ]
+  s.metadata              = { "rubygems_mfa_required" => "true" }
   s.license               = 'MIT'
 
-  s.required_ruby_version = '>= 2.0', '< 4.0'
+  s.required_ruby_version = '>= 3.0', '< 4.0'
 
   # # #
   # Dependencies
 
   # Core Functionality
-  s.add_dependency %q<irb>,           ">= 0.9.6"
-  s.add_dependency %q<every_day_irb>, "~> 2.0"
+  s.add_dependency %q<irb>,           "~> 1.6.2"
+  s.add_dependency %q<every_day_irb>, "~> 2.2"
   s.add_dependency %q<fancy_irb>,     "~> 1.2", ">= 1.2.1"
   s.add_dependency %q<wirb>,          "~> 2.0", ">= 2.2.1"
   s.add_dependency %q<hirb>,          "~> 0.7", ">= 0.7.3"
-  s.add_dependency %q<binding.repl>,  "~> 3.0"
 
   # Utils
   s.add_dependency %q<paint>,         ">= 0.9", "< 3.0"
   s.add_dependency %q<clipboard>,     "~> 1.3"
   s.add_dependency %q<interactive_editor>, "~> 0.0", ">= 0.0.10"
   s.add_dependency %q<coderay>,       "~> 1.1"
-  s.add_dependency %q<debugging>,     "~> 1.1"
+  s.add_dependency %q<debugging>,     "~> 2.1"
 
   # Introspection / Docs
+  s.add_dependency %q<looksee>,       "~> 5.0"
   s.add_dependency %q<object_shadow>, "~> 1.1"
-  s.add_dependency %q<code>,          ">= 0.9.2", "< 2.0"
-  s.add_dependency %q<ori>,           "~> 0.1.0"
-  s.add_dependency %q<methodfinder>,  "~> 2.2", ">= 2.2.2"
+  s.add_dependency %q<code>,          ">= 0.9.4", "< 2.0"
+  s.add_dependency %q<core_docs>,     "~> 0.9.9"
+  s.add_dependency %q<methodfinder>,  "~> 2.2", ">= 2.2.5"
   s.add_dependency %q<ruby_version>,  "~> 1.0"
   s.add_dependency %q<ruby_engine>,   "~> 1.0"
-  s.add_dependency %q<ruby_info>,     "~> 1.0"
-  s.add_dependency %q<os>
+  s.add_dependency %q<os>,            "~> 1.1", ">= 1.1.4"
 end

data/lib/irbtools/binding.rb

@@ -3,27 +3,10 @@ begin
 rescue LoadError
 end
 
-if RUBY_VERSION >= "2.5.0"
-  if defined? BindingOfCaller
-    module Kernel
-      private def irb
-        binding.of_caller(1).irb
-      end
-    end
-  end
-else
-  require 'binding.repl'
-  BindingRepl.auto = %w[irb ripl ir rib pry]
-
-  class Binding
-    alias irb repl!
-  end
-
-  if defined? BindingOfCaller
-    require 'debugging/repl'
-
-    module Debugging
-      alias irb repl
+if defined? BindingOfCaller
+  module Kernel
+    private def irb
+      binding.of_caller(1).irb
     end
   end
 end

data/lib/irbtools/commands/code.rb

@@ -0,0 +1,35 @@
+require "irb/cmd/nop"
+
+module IRB
+  module ExtendCommand
+    class Code < Nop
+      category "Introspection"
+      description "Shows the syntax-highlighted source code of a method"
+
+      class << self
+        def transform_args(args)
+          if args.strip =~ /\A(?:([\w:]+)([#.]))?(\w+)\z/
+            if $1
+              if $2 == "#"
+                "#{$1}, #{$1}.instance_method(:#{$3})"
+              else
+                "#{$1}, :#{$3}"
+              end
+            else
+              ":" + $3
+            end
+          else
+            args
+          end
+        end
+      end
+
+      def execute(*args)
+        @irb_context.workspace.binding.send(:code, *args)
+      rescue NameError
+        warn "code: Class or method not found."
+      end
+    end
+  end
+end
+

data/lib/irbtools/commands/howtocall.rb

@@ -0,0 +1,35 @@
+require "irb/cmd/nop"
+
+module IRB
+  module ExtendCommand
+    class Howtocall < Nop
+      category "Introspection"
+      description "Displays method signatures based on Method#parameters"
+
+      class << self
+        def transform_args(args)
+          if args.strip =~ /\A(?:([\w:]+)([#.]))?(\w+)\z/
+            if $1
+              if $2 == "#"
+                "#{$1}, #{$1}.instance_method(:#{$3})"
+              else
+                "#{$1}, :#{$3}"
+              end
+            else
+              ":" + $3
+            end
+          else
+            args
+          end
+        end
+      end
+
+      def execute(*args)
+        @irb_context.workspace.binding.send(:howtocall, *args)
+      rescue NameError
+        warn "howtocall: Class or method not found"
+      end
+    end
+  end
+end
+

data/lib/irbtools/commands/look.rb

@@ -0,0 +1,20 @@
+require "irb/cmd/nop"
+
+module IRB
+  module ExtendCommand
+    class Look < Nop
+      category "Introspection"
+      description 'Method list and lookup path inspection based on looksee gem'
+
+      def execute(*args)
+        if args.empty?
+          @irb_context.workspace.binding.look
+        else
+          obj, *params = *args
+          obj.look(*params)
+        end
+      end
+    end
+  end
+end
+

data/lib/irbtools/commands/shadow.rb

@@ -0,0 +1,20 @@
+require "irb/cmd/nop"
+
+module IRB
+  module ExtendCommand
+    class Shadow < Nop
+      category "Introspection"
+      description 'Method list and lookup path inspection based on object shadow gem'
+
+      def execute(*args)
+        if args.empty?
+          @irb_context.workspace.binding.shadow
+        else
+          obj, *params = *args
+          obj.shadow(*params)
+        end
+      end
+    end
+  end
+end
+

data/lib/irbtools/commands/sys.rb

@@ -0,0 +1,25 @@
+require "irb/cmd/nop"
+
+module IRB
+  module ExtendCommand
+    class Sys < Nop
+      category "Misc"
+      description 'Run a system command'
+
+      class << self
+        def transform_args(args)
+          if args.empty? || string_literal?(args)
+            args
+          else
+            args.strip.dump
+          end
+        end
+      end
+
+      def execute(*args)
+        system(*args)
+      end
+    end
+  end
+end
+

data/lib/irbtools/commands.rb

@@ -0,0 +1,5 @@
+require_relative "commands/code"
+require_relative "commands/howtocall"
+require_relative "commands/look"
+require_relative "commands/shadow"
+require_relative "commands/sys"

data/lib/irbtools/configure.rb

@@ -1,4 +1,5 @@
 require_relative 'version'
 
 require_relative 'implementation'
+require_relative "commands"
 require_relative 'libraries' unless Irbtools.minimal

data/lib/irbtools/implementation.rb

@@ -1,7 +1,6 @@
 module Irbtools
   @libraries       = { :start => [], :sub_session => [], :autoload => [], :thread => {}, :late => [], :late_thread => {} }
   @lib_hooks       = Hash.new{|h,k| h[k] = [] }
-  @packages        = []
   @shell_name      = File.split($0)[-1].upcase
   @welcome_message = "Welcome to #{ @shell_name }. You are using #{ RUBY_DESCRIPTION }. Have fun ;)"
   @minimal         ||= false
@@ -20,9 +19,6 @@ module Irbtools
     # keys determine if lib is required, required on sub-session or autoloaded
     attr_accessor :libraries
 
-    # an array of extension packages that get loaded (e.g. irbtools-more)
-    attr_accessor :packages
-
     # add a library. the block gets executed, when the library was loaded.
     # if the second param is true, it's hooked in into IRB.conf[:IRB_RC] instead of the start.
     def add_library(lib, options = {}, &block)
@@ -83,23 +79,6 @@ module Irbtools
       @lib_hooks.delete lib
     end
 
-    # add extensions packages
-    def add_package(pkg)
-      @packages << pkg.to_s
-    end
-
-    # remove extension package
-    def remove_package(pkg)
-      @packages.delete pkg.to_s
-    end
-
-    # actually require registered packages
-    def load_packages
-      @packages.each{ |pkg|
-        require "irbtools/#{pkg}"
-      }
-    end
-
     # te be triggered when a library has loaded
     def library_loaded(lib)
       @lib_hooks[lib.to_s].each{ |hook| hook.call }
@@ -122,30 +101,62 @@ module Irbtools
       $VERBOSE, $DEBUG = remember_verbose_and_debug
     end
 
-    # configure irb
     def configure_irb!
       if defined?(IRB)
         IRB.conf[:AUTO_INDENT]  = true                 # simple auto indent
         IRB.conf[:EVAL_HISTORY] = 42424242424242424242 # creates the special __ variable
         IRB.conf[:SAVE_HISTORY] = 2000                 # how many lines will go to ~/.irb_history
-
-        # prompt
-        (IRB.conf[:PROMPT] ||= {} ).merge!( {:IRBTOOLS => {
-          :PROMPT_I => ">> ",    # normal
-          :PROMPT_N => "|  ",    # indenting
-          :PROMPT_C => " > ",    # continuing a statement
-          :PROMPT_S => "%l> ",   # continuing a string
-          :RETURN   => "=> %s \n",
-          :AUTO_INDENT => true,
-        }})
-
-        IRB.conf[:PROMPT_MODE] = :IRBTOOLS
+        set_propmt
+        load_commands
+        add_command_aliases
+        rename_ls_to_ils
       end
     end
 
-    # check if we are in a RIPL session
-    def ripl?
-      defined?(Ripl) && Ripl.started?
+    def set_propmt
+      (IRB.conf[:PROMPT] ||= {} ).merge!( {:IRBTOOLS => {
+        :PROMPT_I => ">> ",    # normal
+        :PROMPT_N => "|  ",    # indenting
+        :PROMPT_C => " > ",    # continuing a statement
+        :PROMPT_S => "%l> ",   # continuing a string
+        :RETURN   => "=> %s \n",
+        :AUTO_INDENT => true,
+      }})
+
+      IRB.conf[:PROMPT_MODE] = :IRBTOOLS
+    end
+
+    def load_commands
+      ec = IRB::ExtendCommandBundle.instance_variable_get(:@EXTEND_COMMANDS)
+
+      [
+        [:code, :Code, nil, [:code, IRB::ExtendCommandBundle::OVERRIDE_ALL]],
+        [:howtocall, :Howtocall, nil, [:howtocall, IRB::ExtendCommandBundle::OVERRIDE_ALL]],
+        [:look, :Look, nil, [:look, IRB::ExtendCommandBundle::OVERRIDE_ALL]],
+        [:shadow, :Shadow, nil, [:shadow, IRB::ExtendCommandBundle::OVERRIDE_ALL]],
+        [:sys, :Sys, nil, [:sys, IRB::ExtendCommandBundle::OVERRIDE_ALL]],
+      ].each{ |ecconfig|
+        ec.push(ecconfig)
+        IRB::ExtendCommandBundle.def_extend_command(*ecconfig)
+      }
+    end
+
+    def add_command_aliases
+      IRB.conf[:COMMAND_ALIASES] = (IRB.conf[:COMMAND_ALIASES] || {}).merge({
+        :ri => :show_doc,
+        :co => :chws,
+        :'$' => :sys,
+        :'+' => :shadow,
+      })
+    end
+
+    # prevent clash between IRB's ls and FileUtil's ls
+    def rename_ls_to_ils
+      if aliases = IRB::ExtendCommandBundle.instance_variable_get(:@ALIASES)
+        if irb_ls = aliases.find{|a,*| a == :ls}
+          irb_ls[0] = :ils
+        end
+      end
     end
 
     # loads all the stuff

data/lib/irbtools/libraries.rb

@@ -21,14 +21,11 @@ Irbtools.add_library 'wirb/wp', thread: :paint do
   Wirb.start
 end
 
-unless Irbtools.ripl?
-  Irbtools.add_library :fancy_irb, thread: :paint do
-    FancyIrb.start
-  end
+Irbtools.add_library :fancy_irb, thread: :paint do
+  FancyIrb.start
 end
 
 Irbtools.add_library 'debugging/q',         thread: :paint
-Irbtools.add_library 'debugging/mof',       thread: :paint
 Irbtools.add_library 'debugging/re',        thread: :paint
 Irbtools.add_library 'debugging/beep',      thread: :paint
 Irbtools.add_library 'debugging/howtocall', thread: :paint
@@ -39,41 +36,23 @@ Irbtools.add_library 'object_shadow', thread: :paint do
   ObjectShadow.include(ObjectShadow::DeepInspect)
 end
 
-Irbtools.add_library 'readline', thread: :ori
-Irbtools.add_library 'ori', thread: :ori do
-  # TODO Readline history can be empty (issue)
-  module ORI::Internals
-    def self.get_ri_arg_prefix(cmd)
-      if cmd && (mat = cmd.match /\A(\s*.+?\.ri)\s+\S/)
-        mat[1]
-      end
-    end
-  end
+Irbtools.add_library 'readline', thread: :readline
+Irbtools.add_library 'os', thread: :os
+Irbtools.add_library 'ruby_engine', thread: :re
+Irbtools.add_library 'ruby_version', thread: :rv
 
-  class Object
-    # patch ori to also allow shell-like "Array#slice" syntax
-    def ri(*args)
-      if  args[0] &&
-          self == TOPLEVEL_BINDING.eval('self') &&
-          args[0] =~ /\A(.*)(?:#|\.)(.*)\Z/
-        begin
-          klass = Object.const_get $1
-          klass.ri $2
-        rescue
-          super
-        end
-      else
-        super
-      end
+begin
+  # Object#l method for inspecting its lookup path
+  Irbtools.add_library 'looksee', thread: :ls do
+    Looksee.rename :lp
+    class Object
+      alias look lp
     end
   end
+rescue LoadError
+  # do not load if not supported
 end
 
-Irbtools.add_library 'ruby_info', thread: :ri
-Irbtools.add_library 'os', thread: :os
-Irbtools.add_library 'ruby_engine', thread: :re
-Irbtools.add_library 'ruby_version', thread: :rv
-
 # # # load via autoload
 
 Irbtools.add_library 'code', :autoload => :Code do
@@ -105,12 +84,6 @@ Irbtools.add_library :clipboard, :autoload => :Clipboard do
     Clipboard.paste
   end
 
-  # copies everything you have entered in this irb session
-  def copy_input
-    copy session_history
-    "The session input history has been copied to the clipboard."
-  end
-
   # copies the output of all irb commands in this irb session
   def copy_output
     copy context.instance_variable_get(:@eval_history_values).inspect.gsub(/^\d+ (.*)/, '\1')

data/lib/irbtools/version.rb

@@ -1,5 +1,5 @@
 # frozen_string_literal: true
 
 module Irbtools
-  VERSION = "3.0.5"
+  VERSION = "4.0.0"
 end

data/lib/irbtools.rb

@@ -1,13 +1,5 @@
 require_relative 'irbtools/configure'
-
-# # # # #
-# Make sure we load IRB if we are not in RIPL
-
-require 'irb' unless Irbtools.ripl?
-
-# # # # #
-# Load irbtools extension packages
-Irbtools.load_packages
+require 'irb'
 
 # # # # #
 # Load: start
@@ -27,19 +19,11 @@ Irbtools.configure_irb!
 
 # # # # #
 # Load: sub-session / after_rc
-if Irbtools.ripl?
-  if defined? Ripl::AfterRc
-    Irbtools.libraries[:sub_session].each{ |r| Ripl.after_rcs << r }
-  elsif !Irbtools.libraries[:sub_session].empty?
-    warn "Couldn't load libraries in Irbtools.libraries[:sub_session]. Please install ripl-after_rc to use this feature in Ripl!"
-  end
-else
-  original_irbrc_proc = IRB.conf[:IRB_RC]
-  IRB.conf[:IRB_RC] = proc{
-    Irbtools.load_libraries(Irbtools.libraries[:sub_session])
-    original_irbrc_proc.call if original_irbrc_proc
-  }
-end
+original_irbrc_proc = IRB.conf[:IRB_RC]
+IRB.conf[:IRB_RC] = proc{
+  Irbtools.load_libraries(Irbtools.libraries[:sub_session])
+  original_irbrc_proc.call if original_irbrc_proc
+}
 
 # # # # #
 # Load: threads

metadata

@@ -1,43 +1,43 @@
 --- !ruby/object:Gem::Specification
 name: irbtools
 version: !ruby/object:Gem::Version
-  version: 3.0.5
+  version: 4.0.0
 platform: ruby
 authors:
 - Jan Lelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2021-05-25 00:00:00.000000000 Z
+date: 2022-12-29 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.6
+        version: 1.6.2
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - ">="
+    - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.9.6
+        version: 1.6.2
 - !ruby/object:Gem::Dependency
   name: every_day_irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: fancy_irb
   requirement: !ruby/object:Gem::Requirement
@@ -98,20 +98,6 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 0.7.3
-- !ruby/object:Gem::Dependency
-  name: binding.repl
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.0'
 - !ruby/object:Gem::Dependency
   name: paint
   requirement: !ruby/object:Gem::Requirement
@@ -186,14 +172,28 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '2.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '2.1'
+- !ruby/object:Gem::Dependency
+  name: looksee
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '5.0'
 - !ruby/object:Gem::Dependency
   name: object_shadow
   requirement: !ruby/object:Gem::Requirement
@@ -214,7 +214,7 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.4
     - - "<"
       - !ruby/object:Gem::Version
         version: '2.0'
@@ -224,24 +224,24 @@ dependencies:
     requirements:
     - - ">="
       - !ruby/object:Gem::Version
-        version: 0.9.2
+        version: 0.9.4
     - - "<"
       - !ruby/object:Gem::Version
         version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: ori
+  name: core_docs
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.9.9
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.9.9
 - !ruby/object:Gem::Dependency
   name: methodfinder
   requirement: !ruby/object:Gem::Requirement
@@ -251,7 +251,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.2
+        version: 2.2.5
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -261,7 +261,7 @@ dependencies:
         version: '2.2'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 2.2.2
+        version: 2.2.5
 - !ruby/object:Gem::Dependency
   name: ruby_version
   requirement: !ruby/object:Gem::Requirement
@@ -291,33 +291,25 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.0'
 - !ruby/object:Gem::Dependency
-  name: ruby_info
+  name: os
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.0'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '1.0'
-- !ruby/object:Gem::Dependency
-  name: os
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
+        version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.1.4
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
+    - - "~>"
+      - !ruby/object:Gem::Version
+        version: '1.1'
     - - ">="
       - !ruby/object:Gem::Version
-        version: '0'
+        version: 1.1.4
 description: The Irbtools make working with Ruby's IRB console more fun & productive.
 email:
 - hi@ruby.consulting
@@ -337,6 +329,12 @@ files:
 - irbtools.gemspec
 - lib/irbtools.rb
 - lib/irbtools/binding.rb
+- lib/irbtools/commands.rb
+- lib/irbtools/commands/code.rb
+- lib/irbtools/commands/howtocall.rb
+- lib/irbtools/commands/look.rb
+- lib/irbtools/commands/shadow.rb
+- lib/irbtools/commands/sys.rb
 - lib/irbtools/configure.rb
 - lib/irbtools/hirb.rb
 - lib/irbtools/implementation.rb
@@ -344,10 +342,11 @@ files:
 - lib/irbtools/minimal.rb
 - lib/irbtools/non_fancy.rb
 - lib/irbtools/version.rb
-homepage: https://irb.tools
+homepage: https://github.com/janlelis/irbtools
 licenses:
 - MIT
-metadata: {}
+metadata:
+  rubygems_mfa_required: 'true'
 post_install_message: 
 rdoc_options: []
 require_paths:
@@ -356,7 +355,7 @@ required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
-      version: '2.0'
+      version: '3.0'
   - - "<"
     - !ruby/object:Gem::Version
       version: '4.0'
@@ -366,7 +365,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.2.3
+rubygems_version: 3.4.1
 signing_key: 
 specification_version: 4
 summary: Irbtools happy IRB.