irbtools 2.2.2 → 3.0.4

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 323cbced41109a256d3a177c434af8348a852347ce63ce2cf32bcbffb9aa0186
-  data.tar.gz: c6f0b0539423bee17e34f2705c9ee8db325cc7835b8309e5fdca961ac3ac55af
+  metadata.gz: f2debea09bce10847a9c13d283cb6e7c9f94baa63946b8c08b010126b7efc07b
+  data.tar.gz: b072c4fcd9edb111acdbc9c690aa21b0e55e5a22f496f7c83a16f0a2e0cb5fa2
 SHA512:
-  metadata.gz: 74b08caab060f01b655a5d44211b8e79aa66851bf6e884a8dff9f9129961c568d680c74e71f0a061165861d3456686a59fb17799144092fb63c4ded3a5604550
-  data.tar.gz: 70772f0031ca5b7d52737e73a53601e14d174c8675b2f60a61d4da2c158003d9b2ce5bc38c235ae799f5250eefb946e4a6f0bb272c162aad3036c6534097aff6
+  metadata.gz: bc315ac52883a977dc6a06bbac66775c09f68201067dc7de4c711d0fc7a7c92ce2e6f1608970fbcee9c70f7d14c4c1f3d38a29606627f4f53d87184ac38fe335
+  data.tar.gz: 590a725d8f2ab6989f071da298b856b5ea38e9707a6e72f45982586f2796613172d605a856ea31d322bda36e51f00ee39077aa397d10e4398e0378b39b0ad9f6

data/{CHANGELOG.txt → CHANGELOG.md}

@@ -1,14 +1,37 @@
-2.2.2
+# Irbtools Changelog
+
+## 3.0.4
+* Loosen Ruby dependency to allow Ruby 3.0
+
+## 3.0.3
+* Workaround a HIRB issue for newer IRBs (fixes #48)
+* Workaround ORI issue for newer IRBs
+
+## 3.0.2
+* Bump wirb to ensure Ruby 2.7 compatibility
+
+## 3.0.1
+* Bump fancy_irb to ensure Ruby 2.7 compatiblity
+
+## 3.0.0
+* Make IRB itself a dependency (default gem)
+* Move: "Every day… IRB" into its own git repository
+  * https://github.com/janlelis/every_day_irb
+* Replace instance and method_locator gems with new object_shadow gem
+* Improve README
+* Version bump code, clipboard, and methodfinder
+
+## 2.2.2
 * Remove Rails WIRB loading hack (no longer necessary)
 
-2.2.1
+## 2.2.1
 * Allow os gem to be below 1.0
 * Do not use binding.repl gem if Ruby version is at least 2.5
 
-2.2.0
+## 2.2.0
 * Remove info, version, engine, and os methods. Use RubyInfo, RubyVersion, RubyEngine, and OS instead (fixes #40)
 
-2.1.0
+## 2.1.0
 * Improve Rails compatibility
   * Do not load instance gem in the context of Rails
   * Make sure to actually require "irb" before using it
@@ -17,10 +40,10 @@
 * Require new versions of fancy_irb, clipboard, os
 * Set abort_on_exception to true for late threads (early threads do this implicitly via join)
 
-2.0.1
+## 2.0.1
 * Remove g gem
 
-2.0.0
+## 2.0.0
 * Use Wirb 2.0 and FancyIrb 1.0
 * Drop support for Ruby 1
 * Simplify starting from code via: require 'irbtools/binding'
@@ -34,35 +57,35 @@
 * EveryDayIrb now gets released on its own, instead with every new irbtools version
 * Improve documentation in Readme
 
-1.7.1
+## 1.7.1
 * bump binding.repl, hirb, methodfinder
 
-1.7.0
+## 1.7.0
 * bump boson, boson-more, binding.repl
 * required ruby version: 1.9.3
 * remove awesome_print
 
-1.6.1
+## 1.6.1
 * don't load debugging/repl by default
 * rename re method to engine and rv to version
 
-1.6.0
+## 1.6.0
 * remove zucker dependency, but add debugging, ruby_version, ruby_engine, ruby_info and os gem
 * configure binding.repl to load irb, not pry
 * bump binding.repl, paint, wirb
 
-1.5.1
+## 1.5.1
 * include binding.repl gem
 * bump coderay, awesome_print, method_source, wirb
 
-1.5.0
+## 1.5.0
 * update debundle hack
 * load less zucker libraries
 * add alias gem
 * finaly load boson correctly (but don't load any boson plugin, yet), also depend on boson-more
 * version bumps (zucker, clipboard, paint, hirb, wirb, ap, coderay, g)
 
-1.4.0
+## 1.4.0
 * every_day_irb is now a module that extends self
 * specs for most of every_day_irb's functionality
 * add helper method for paging output with hirb: page
@@ -70,21 +93,21 @@
 * remove sketches dependency, it's a great gem, but very similar to interactive_editor
 * Object#mlp alias for method_lookup_path
 
-1.3.0 == 1.2.3
+## 1.3.0 == 1.2.3
 * add modern debundle note
 * remove loading of .railsrc
 * remove dbg method
 * version bumps
 
-1.2.2
+## 1.2.2
 * fix errors when inspect returns nil (e.g. CarrierWave uploaders)
 * create legacy branch for 1.8.7 support
 
-1.2.1
+## 1.2.1
 * fix newboson loader issue
 * minor version bumps
 
-1.2.0
+## 1.2.0
 * version bumps: hirb, awesome_print, coderay, g, methodfinder, method_source
 * remove RVM helpers: Sorry, were too buggy...
 * fix/improve 'cd' helper method
@@ -92,10 +115,10 @@
 * move looksee gem to irbtools-more
 * more little tweaks
 
-1.1.1
+## 1.1.1
 * fix the Ripl.after_rc bug
 
-1.1.0
+## 1.1.0
 * fix hirb loading/unicode issue + colorize tables (thanks to halan)
 * colorize paged wirb output
 * include method locator gem (improved ancestors)
@@ -103,28 +126,28 @@
 * include method source gem (Object#src)
 * small tweaks...
 
-1.0.6
+## 1.0.6
 * add possibility to modify library callbacks without removing the library by using: replace_library_callback or add_library_callback
 * fix hirb dependency issue
 * readme improvements
 
-1.0.5
+## 1.0.5
 * use paint gem for terminal colors
 
-1.0.4
+## 1.0.4
 * improve error-handling
 * fix broken loading of boson + interactive_editor
 
-1.0.3
+## 1.0.3
 * fix post-install banner typo
 
-1.0.2
+## 1.0.2
 * version bumps for zucker (rbx compatible) and wirb (improved generic object-description highlighting)
 
-1.0.1
+## 1.0.1
 * add missing require 'rbconfig'
 
-1.0.0
+## 1.0.0
 * gemify general helpers/rvm stuff ("every_day_irb", "rvm_loader")
 * 6 different loading schemas: start, thread, autoload, sub_session, late, late_thread
   * load almost every feature via threads
@@ -132,67 +155,67 @@
 * add irbtools/minimal mode for starting Irbtools without the default set of libraries
 * replace RV and RE with rv and re
 
-0.8.8
+## 0.8.8
 * fix 0.8.7 file permissions
 * add methodfinder gem
 * don't depend on guessmethod anymore
 
-0.8.7
+## 0.8.7
 * fix railsrc loading
 * add ori gem for nice Object#ri calling
 * minor tweaks
 
-0.8.6
+## 0.8.6
 * windows support
 * update hirb + activate unicode-drawn tables
 
-0.8.5
+## 0.8.5
 * rails related fixes
 
-0.8.4
+## 0.8.4
 * now using wirb instead of wirble
 
-0.8.3
+## 0.8.3
 * improved/added rvm methods (use, gemset, rubies, gemsets)
   * RVM (Ruby API) constant gets autoloaded
 * improved cd command
 * don't load guessmethod by default (it's cool, but not always suited for production)
 * more small changes
 
-0.8.2
+## 0.8.2
 * only do irb specific features if in irb (ripl compatibility)
 * more generic shell_name (in welcome message)
 
-0.8.1
+## 0.8.1
 * rewrote irb_rocket: fancy_irb. No more workarounds needed, anymore.
 * added sketches gem
 * customizable welcome message
 * more little fixes/enhancements
 
-0.8.0
+## 0.8.0
 * added Object#ri method
 * feature: extension package loading (e.g. irbtools-more)
 * feature: loading in IRB.conf[:IRB_RC] (loading when a subirb starts, no more guessmethod rails errors)
 * added rerequire (rrq) and ld load helper
 
-0.7.4
+## 0.7.4
 * added workaround to use irb_rocket and hirb at the same time (basic hack, e.g. paging does not work)
 * fixed little VERSION bug
 
-0.7.3
+## 0.7.3
 * refactored file structure and added new Irbtools.add_lib method
 * load railsrc if executed with rails and Irbtools.railsrc is set
 * more little fixes
 
-0.7.2
+## 0.7.2
 * fixed Rails 3 bug
 * added boson gem (command repository)
 * remember history when resetting or switching ruby version
 
-0.7.1
+## 0.7.1
 * added method for starting a debugger
 
-0.7.0
+## 0.7.0
 * initial release
 
 J-_-L

data/CONFIGURE.md

@@ -3,6 +3,12 @@
 
 The welcome message can be customized with `Irbtools.welcome_message=`
 
+### IRB Prompt
+
+**irbtools** changes the prompt to *:IRBTOOLS mode*, which uses `>> ` as the prompt, `|  ` for indentation, and ` > ` for continuing a statement. You can switch back to the default IRB prompt with:
+
+    IRB.conf[:PROMPT_MODE] = :DEFAULT
+
 ### Customize Libraries to Load
 
 It is possible to modify, which libraries to load:
@@ -53,3 +59,15 @@ When adding a new library, you should firstly consider some way to load it via
 `:autoload`. If this is not possible, try loading via `:thread`. If that is
 not possible either, you will need to fallback to the default loading
 mechanism.
+
+#### Example
+
+Change a [FancyIRB](https://github.com/janlelis/fancy_irb/) setting:
+
+    require 'irbtools/configure'
+
+    Irbtools.replace_library_callback :fancy_irb do
+      FancyIrb.start rocket_mode: false
+    end
+
+    Irbtools.start

data/MIT-LICENSE.txt

@@ -1,4 +1,4 @@
-Copyright (c) 2010-2019 Jan Lelis
+Copyright (c) 2010-2020 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,16 +1,22 @@
-# Irbtools [![version](https://badge.fury.io/rb/irbtools.svg)](https://badge.fury.io/rb/irbtools)
-
-     _ _|        |      |                  |
-       |    __|  __ \   __|   _ \    _ \   |   __|
-       |   |     |   |  |    (   |  (   |  | \__ \
-     ___| _|    _.__/  \__| \___/  \___/  _| ____/
+# Irbtools [![version](https://badge.fury.io/rb/irbtools.svg)](https://badge.fury.io/rb/irbtools) [![[travis]](https://travis-ci.org/janlelis/irbtools.svg)](https://travis-ci.org/janlelis/irbtools)
 
+```ruby
+                                                                                 _|          _|
+ _|_|_|  _|_|_|    _|_|_|        _|                          _|                _|    _|_|_|    _|
+   _|    _|    _|  _|    _|    _|_|_|_|    _|_|      _|_|    _|    _|_|_|      _|          _|  _|
+   _|    _|_|_|    _|_|_|        _|      _|    _|  _|    _|  _|  _|_|          _|      _|_|    _|
+   _|    _|    _|  _|    _|      _|      _|    _|  _|    _|  _|      _|_|      _|          _|  _|
+ _|_|_|  _|    _|  _|_|_|    _|    _|_|    _|_|      _|_|    _|  _|_|_|        _|    _|_|_|    _|
+                                                                                 _|          _|
+```
 
-Improvements for Ruby's IRB console, like colored output and a lot of
+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!
 
+**Compatible with Ruby 2.7's new IRB**
+
 ## Setup
 
     $ gem install irbtools
@@ -20,126 +26,128 @@ just create a new one. Add the following content:
 
     require 'irbtools'
 
-You also need to add irbtools to your project's Gemfile:
+You also need to add irbtools to your project's `Gemfile`:
 
     gem 'irbtools', require: 'irbtools/binding'
 
-Then start IRB (with **Irbtools** loaded) from the console or directly from your code with:
+Then start IRB (with **Irbtools** loaded) from the terminal or directly from your code with:
 
     binding.irb
 
-If the `binding_of_caller` gem is available (e.g. see below), you can omit the `binding`:
-
-    irb
-
-### More Improvements
+### Enable More Gems
 
 Some suggested gems will not be installed to ensure wider general support. For
-the full feature set, you can add **irbtools-more** and change your
+the full feature set, you can install **irbtools-more**. To do so, change your
 `.irbrc` to:
 
     require 'irbtools/more'
 
-and edit your Gemfile to
+and edit your `Gemfile` to read like this:
 
     gem 'irbtools-more', require: 'irbtools/binding'
 
-
-### Included Gems and Libraries
-#### IRB Improvements
-
-*   Colored output:
-    [wirb](https://github.com/janlelis/wirb/)
-    [fancy_irb](https://github.com/janlelis/fancy_irb)
-*   Custom views for specific objects:
-    [hirb](https://tagaholic.me/2009/03/13/hirb-irb-on-the-good-stuff.html)
-*   **(irbtools-more)** Correction suggestions for misspelled method/constant names:
-    [did_you_mean](https://github.com/yuki24/did_you_mean)
-*   **(irbtools-more)** Better tab-completion:
-    [bond](https://tagaholic.me/bond/)
-
-#### Utils
-
-*   Useful IRB commands (see below):
-    [every_day_irb](https://github.com/janlelis/irbtools/tree/master/lib/every_day_irb.rb)
-    [debugging](https://github.com/janlelis/debugging)
-    [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
-*   Clipboard Access:
-    [clipboard](https://github.com/janlelis/clipboard)
-*   Terminal colors:
-    [paint](https://github.com/janlelis/paint)
-*   Load an editor into your IRB session:
-    [interactive_editor](https://github.com/jberkel/interactive_editor)
-
-#### Introspection
-
-*   Displays a method's source:
-    [code](https://github.com/janlelis/code)
-*   Access to *ri* docs:
-    [ori](https://github.com/dadooda/ori)
-*   Manipulate instance variables with ease:
-    [instance](https://github.com/rubyworks/instance/) (not loaded in Rails context)
-*   Platform information:
-    [ruby_version](https://github.com/janlelis/ruby_version)
-    [ruby_engine](https://github.com/janlelis/ruby_engine)
-    [os](https://github.com/rdp/os)
-    [ruby_info](https://github.com/janlelis/ruby_info)
-*   Improved method lookup path inspection:
-    [method_locator](https://github.com/ryanlecompte/method_locator)
-*   Finds methods that turn one value into another value:
-    [methodfinder](https://github.com/citizen428/methodfinder)
-*   **(irbtools-more)** Awesome lookup path inspection:
-    [looksee](https://github.com/oggy/looksee)
-
-
-### Irbtools Methods
-
-Besides improving IRB itself, you will get the following methods:
-
-Method / Constant | Arguments  | Description
------- | ---------- | -----------
-`beep` | | Ring terminal bell.
-`cat` | path | Read file contents.
-`cd` | path = nil | Changes the directory. Can also be used in these forms: `~cd` (change to home directory), `-cd` (change to previous directory).
-`clear` | | Clear the terminal.
-`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.
-`colorize` | string | Syntax highlight a Ruby string.
-`copy` | string | Copy something to the clipboard.
-`copy_input` | | Copy session history to the clipboard.
-`copy_output` | | Copy session output history to the clipboard.
-`ed` / `emacs` / `mate` / `mvim` / `nano` / `vi` / `vim` | filename = nil | Start an editor in the session context.
-`RubyEngine` | | Show the Ruby engine.
-`howtocall` | object = self, method_or_proc | Displays parameter names and types for a proc or method.
-`RubyInfo` | | List general information about the Ruby environment.
-`ld` | file | Shortcut for `load lib.to_s + '.rb'`.
-`ls` | path = "." | List directory content.
-`mf` | object1, object2 | Find methods that turn one value into another value.
-`mof` | object, depth = 0, grep = // | Print a method list, ordered by modules.
-`OS` | | Query operating system information.
-`pa` | string, color | Print a string in the specified color.
-`page` | what, options = {} | Page long content.
-`paste` | | Paste clipboard content.
-`q` | *args | Like `Kernel#p`, but prints results on one line, with different colors.
-`ray` | path | Syntax highlight a Ruby file.
-`re` | string, regexg, groups = nil | Assists you when matching regexes againts strings.
-`reset!` | | Restart the current IRB session.
-`rq` | lib | Shortcut for `require lib.to_s`. Use it like this: `rq:prime`.
-`rr` | lib | Shortcut for `require_relative lib.to_s`.
-`rrq` / `rerequire` | lib | Hack to remove a library from `$LOADED_FEATURES` and `require` it again.
-`session_history` | number_of_lines = nil | Return a string of all commands issued in the current session.
-`RubyVersion` | | Show the Ruby version.
-`wp` | inspect_string | Syntax-highlight a Ruby object.
-`Object#instance` | | Proxy object to read and manipulate instance variables / run eval (not loaded in Rails context).
-`Object#lp` | | **(irbtools-more)** Supercharged method introspection in IRB.
-`Object#mlp` / `Object#method_lookup_path` | | Traverse an object's method lookup path to find all places where a method may be defined.
-`Object#ri` | *args | Show ri documentation for this object or method.
-
-
-### Advanced tweaking
+## Features
+
+### Irbtools' 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/)
+
+### Irbtools' Included 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
+- 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)
+
+#### 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)
+`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
+
+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)
+`copy` | string | Copy something to the clipboard | [clipboard](https://github.com/janlelis/clipboard)
+`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)
+`pa` | string, color | Print a string in the specified color | [paint](https://github.com/janlelis/paint#utilities)
+`page` | what, options = {} | Use pager to improve viewing longer content | [hirb](https://github.com/cldwalker/hirb#pager), irbtools
+`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)
+`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
+------ | ---------- | -----------|-
+`cat` | path | Read file contents | [every_day_irb](https://github.com/janlelis/every_day_irb)
+`cd` | path = nil | Change the directory. Can also be used in these forms: `~cd` (change to home directory), `-cd` (change to previous directory) | [cd](https://github.com/janlelis/cd)
+`chmod` | mode, path | Set file mode for file | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`chmod_R` | mode, path | Set file mode for directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`chown` | user, group, path | Set file owner for file | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`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)
+`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)
+`mkdir` | path | Create a new directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`mkdir_p` | path | Create a new directory (with `-p` option) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`cp` | source, destination | Move file or directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`pwd` | | Return current directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`ray` | path | Syntax highlight a Ruby file | [coderay](https://github.com/rubychan/coderay), irbtools
+`rm` | path | Delete a file (`rm`) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`rm_r` | path | Delete a file or directory (`rm -r`) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`rm_rf` | path | Delete a file or directory, with force (`rm -rf`) | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+`rmdir` | path | Delete an empty directory | [fileutils](https://ruby-doc.org/stdlib/libdoc/fileutils/rdoc/FileUtils.html)
+
+### Advanced Tweaking
 
 See [CONFIGURE.md](https://github.com/janlelis/irbtools/blob/master/CONFIGURE.md).
 
-
 ### Troubleshooting: ANSI colors on Windows
 
 Windows: ANSI support can be enabled via
@@ -147,52 +155,32 @@ Windows: ANSI support can be enabled via
 [ConEmu](https://conemu.github.io/) or
 [WSL](https://docs.microsoft.com/en-us/windows/wsl/about).
 
-
 ### Troubleshooting: Clipboard not working on Linux
 
 Clipboard support requires **xsel** or **xclip**. On ubuntu, do:
 
     sudo apt-get install xsel
 
-
-### Troubleshooting: Unicode causes wrong display widths
-
-If you use double-width unicode characters, you will need to paste the
-following snippet to your `~/.irbrc` file.
-
-```ruby
-Irbtools.replace_library_callback :fancy_irb do
-  FancyIrb.start east_asian_width: true
-end
-```
-
-This setting is deactivated by default, because of performance issues.
-
-
 ### Hint: Debundle
 
-If you do not want to add **Irbtools** to your project's Gemfile, you will need a
+If you do not want to add **Irbtools** to your project's `Gemfile`, you will need a
 [debundle hack](https://github.com/janlelis/debundle.rb). Put it at the
-beginning of your `~/.irbrc` file and you are fine (until it breaks).
-
+beginning of your `~/.irbrc` file and you are fine.
 
 ### Hint: No ANSI / IRB extension
 
-You can use Irbtools without colors/irb extensions. To do so, put this into `~/.irbrc`:
+You can use **Irbtools** without colors/IRB extensions. To do so, put this into `~/.irbrc`:
 
 ```ruby
 require 'irbtools/non_fancy'
 Irbtools.start
 ```
 
+### Hint: Web Console and Other Approaches
 
-### Hint: Web Console
-
-**Irbtools** works well together with the amazing
-[web-console!](https://github.com/rails/web-console)
-
+**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-2019 Jan Lelis <https://janlelis.com> released under the MIT
+Copyright (c) 2010-2020 Jan Lelis <https://janlelis.com> released under the MIT
 license.

data/Rakefile

@@ -1,18 +1,12 @@
 require 'fileutils'
 require "rspec/core/rake_task"
 
-
 task :test => :spec
 task :default => :spec
 RSpec::Core::RakeTask.new(:spec) do |t|
   t.rspec_opts = '--backtrace --color'
 end
 
-
-def gemspec1
-  @gemspec1 ||= eval(File.read('every_day_irb.gemspec'), binding, 'every_day_irb.gemspec')
-end
-
 def gemspec2
   @gemspec2 ||= eval(File.read('irbtools.gemspec'), binding, 'irbtools.gemspec')
 end
@@ -23,25 +17,21 @@ end
 
 desc "Build the gems"
 task :gem => :gemspec do
-  sh "gem build #{gemspec1.name}.gemspec"
   sh "gem build #{gemspec2.name}.gemspec"
   sh "gem build #{gemspec3.name}.gemspec"
   FileUtils.mkdir_p 'pkg'
-  FileUtils.mv "#{gemspec1.name}-#{gemspec1.version}.gem", 'pkg'
   FileUtils.mv "#{gemspec2.name}-#{gemspec2.version}.gem", 'pkg'
   FileUtils.mv "#{gemspec3.name}-#{gemspec3.version}.gem", 'pkg'
 end
 
 desc "Install the gem locally (without docs)"
 task :install => :gem do
-  sh %{gem install pkg/#{gemspec1.name}-#{gemspec1.version}.gem --no-document}
   sh %{gem install pkg/#{gemspec2.name}-#{gemspec2.version}.gem --no-document}
   sh %{gem install pkg/#{gemspec3.name}-#{gemspec3.version}.gem --no-document}
 end
 
 desc "Validate the gemspec"
 task :gemspec do
-  gemspec1.validate
   gemspec2.validate
   gemspec3.validate
 end

data/irbtools.gemspec

@@ -5,11 +5,11 @@ Gem::Specification.new do |s|
   s.name = 'irbtools'
   s.version = Irbtools::VERSION
 
-  s.homepage              = 'https://github.com/janlelis/irbtools'
+  s.homepage              = 'https://irb.tools'
   s.authors               = ["Jan Lelis"]
+  s.email                 = ["hi@ruby.consulting"]
   s.summary               = 'Irbtools happy IRB.'
-  s.description           = "Irbtools make Ruby's IRB more productive."
-  s.email                 = 'mail@janlelis.de'
+  s.description           = "The Irbtools make working with Ruby's IRB console more fun & productive."
   s.files                 = %w[
     lib/irbtools.rb
     lib/irbtools/version.rb
@@ -26,40 +26,38 @@ Gem::Specification.new do |s|
   s.extra_rdoc_files      = %w[
     README.md
     CONFIGURE.md
-    CHANGELOG.txt
+    CHANGELOG.md
     MIT-LICENSE.txt
   ]
   s.license               = 'MIT'
 
-  s.required_ruby_version = '~> 2.0'
-  s.add_development_dependency 'rspec', '~> 3.2'
-  s.add_development_dependency 'rake', '~> 10.4'
+  s.required_ruby_version = '>= 2.0', '< 4.0'
 
   # # #
   # Dependencies
 
-  # core functionality
+  # Core Functionality
+  s.add_dependency %q<irb>,           ">= 0.9.6"
   s.add_dependency %q<every_day_irb>, "~> 2.0"
-  s.add_dependency %q<fancy_irb>,     "~> 1.1"
-  s.add_dependency %q<wirb>,          "~> 2.0"
+  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
+  # Utils
   s.add_dependency %q<paint>,         ">= 0.9", "< 3.0"
-  s.add_dependency %q<clipboard>,     "~> 1.1"
+  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"
 
-  # introspection / docs
-  s.add_dependency %q<code>,          "~> 0.9"
+  # Introspection / Docs
+  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.0"
-  s.add_dependency %q<method_locator>,"~> 0.0", ">= 0.0.4"
+  s.add_dependency %q<methodfinder>,  "~> 2.2"
   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<instance>,      "~> 0.2"
 end

data/lib/irbtools/hirb.rb

@@ -7,6 +7,15 @@ Irbtools.add_library :hirb, thread: :paint do
     Hirb::Pager.command_pager(what, options = {})
   end
 
+  # Workaround for newer IRB versions
+  if defined? IRB::Irb
+    IRB::Irb.class_eval do
+      def output_value(_ = false)
+        Hirb::View.view_or_page_output(@context.last_value) || non_hirb_view_output
+      end
+    end
+  end
+
   # page wirb output hacks
   class Hirb::Pager
     alias original_activated_by? activated_by?

data/lib/irbtools/libraries.rb

@@ -28,22 +28,28 @@ unless Irbtools.ripl?
 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
 
 require_relative 'hirb'
 
-unless defined?(Rails)
-  Irbtools.add_library 'instance', thread: 30
+Irbtools.add_library 'object_shadow', thread: :paint do
+  ObjectShadow.include(ObjectShadow::DeepInspect)
 end
 
-Irbtools.add_library 'ori', thread: 50 do
+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
+
   class Object
     # patch ori to also allow shell-like "Array#slice" syntax
     def ri(*args)
@@ -63,12 +69,6 @@ Irbtools.add_library 'ori', thread: 50 do
   end
 end
 
-Irbtools.add_library 'method_locator', thread: 60 do
-  module MethodLocator
-    alias mlp method_lookup_path
-  end
-end
-
 Irbtools.add_library 'ruby_info', thread: :ri
 Irbtools.add_library 'os', thread: :os
 Irbtools.add_library 'ruby_engine', thread: :re

data/lib/irbtools/version.rb

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

metadata

@@ -1,43 +1,29 @@
 --- !ruby/object:Gem::Specification
 name: irbtools
 version: !ruby/object:Gem::Version
-  version: 2.2.2
+  version: 3.0.4
 platform: ruby
 authors:
 - Jan Lelis
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-04-01 00:00:00.000000000 Z
+date: 2020-12-24 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
-  name: rspec
+  name: irb
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-  type: :development
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '3.2'
-- !ruby/object:Gem::Dependency
-  name: rake
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.4'
-  type: :development
+        version: 0.9.6
+  type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: '10.4'
+        version: 0.9.6
 - !ruby/object:Gem::Dependency
   name: every_day_irb
   requirement: !ruby/object:Gem::Requirement
@@ -58,14 +44,20 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.2'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 1.2.1
 - !ruby/object:Gem::Dependency
   name: wirb
   requirement: !ruby/object:Gem::Requirement
@@ -73,6 +65,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.1
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -80,6 +75,9 @@ dependencies:
     - - "~>"
       - !ruby/object:Gem::Version
         version: '2.0'
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.2.1
 - !ruby/object:Gem::Dependency
   name: hirb
   requirement: !ruby/object:Gem::Requirement
@@ -140,14 +138,14 @@ dependencies:
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.3'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '1.1'
+        version: '1.3'
 - !ruby/object:Gem::Dependency
   name: interactive_editor
   requirement: !ruby/object:Gem::Requirement
@@ -197,67 +195,67 @@ dependencies:
       - !ruby/object:Gem::Version
         version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: code
+  name: object_shadow
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '1.1'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.9'
+        version: '1.1'
 - !ruby/object:Gem::Dependency
-  name: ori
+  name: code
   requirement: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.9.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
-    - - "~>"
+    - - ">="
       - !ruby/object:Gem::Version
-        version: 0.1.0
+        version: 0.9.2
+    - - "<"
+      - !ruby/object:Gem::Version
+        version: '2.0'
 - !ruby/object:Gem::Dependency
-  name: methodfinder
+  name: ori
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.1.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '2.0'
+        version: 0.1.0
 - !ruby/object:Gem::Dependency
-  name: method_locator
+  name: methodfinder
   requirement: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.0.4
+        version: '2.2'
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
     requirements:
     - - "~>"
       - !ruby/object:Gem::Version
-        version: '0.0'
-    - - ">="
-      - !ruby/object:Gem::Version
-        version: 0.0.4
+        version: '2.2'
 - !ruby/object:Gem::Dependency
   name: ruby_version
   requirement: !ruby/object:Gem::Requirement
@@ -314,31 +312,18 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: '0'
-- !ruby/object:Gem::Dependency
-  name: instance
-  requirement: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-  type: :runtime
-  prerelease: false
-  version_requirements: !ruby/object:Gem::Requirement
-    requirements:
-    - - "~>"
-      - !ruby/object:Gem::Version
-        version: '0.2'
-description: Irbtools make Ruby's IRB more productive.
-email: mail@janlelis.de
+description: The Irbtools make working with Ruby's IRB console more fun & productive.
+email:
+- hi@ruby.consulting
 executables: []
 extensions: []
 extra_rdoc_files:
 - README.md
 - CONFIGURE.md
-- CHANGELOG.txt
+- CHANGELOG.md
 - MIT-LICENSE.txt
 files:
-- CHANGELOG.txt
+- CHANGELOG.md
 - CONFIGURE.md
 - MIT-LICENSE.txt
 - README.md
@@ -353,7 +338,7 @@ files:
 - lib/irbtools/minimal.rb
 - lib/irbtools/non_fancy.rb
 - lib/irbtools/version.rb
-homepage: https://github.com/janlelis/irbtools
+homepage: https://irb.tools
 licenses:
 - MIT
 metadata: {}
@@ -363,16 +348,19 @@ require_paths:
 - lib
 required_ruby_version: !ruby/object:Gem::Requirement
   requirements:
-  - - "~>"
+  - - ">="
     - !ruby/object:Gem::Version
       version: '2.0'
+  - - "<"
+    - !ruby/object:Gem::Version
+      version: '4.0'
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
   - - ">="
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
+rubygems_version: 3.1.2
 signing_key: 
 specification_version: 4
 summary: Irbtools happy IRB.