pry 0.11.3 → 0.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 2b64fffecceb1735b3224542dddf8210a4eea3ea
-  data.tar.gz: 00453f4390dc9d7d31a5a0215823f2f57929b097
+SHA256:
+  metadata.gz: d07ef96499f7a86674cffc2a3716d4d922c33046c0134585292915b27af11f70
+  data.tar.gz: 544a3c577b01fc131ee3ab5c6a85dd89594675de8a4019a536a98afd29ee71a8
 SHA512:
-  metadata.gz: 9fa428d4b7e63c0260dfd1082de23e978adc52461fb1123e415baed4101171a664ba7928511acbfe17d9aa034002f0e5f61645de6fa7cba036be1b87fd05525b
-  data.tar.gz: 91ca93bd5bd1948952ddb11bccc0ab03e1f792e7025f3ff77461c89801993f5141c1e5fbe85e123308b2d19c8ec86daf662c4e419b3bfef571d54f044e729758
+  metadata.gz: 0510a99ee011dd860352f7fdc7c7c5cd721fa44b2b72d7f2c354fc90af53a481ec53e1a6fc29a01fdf81f8130b756977c7d3dd885cc34418416d81f4ae7244e8
+  data.tar.gz: a8622184f84e20196899c1629c4f45733ed57416d2cb104345099fb64842d92eb105de264627f203b047816328e1201d94b6dd876719d3dc82ab49eba5f22e5b

data/CHANGELOG.md

@@ -1,5 +1,140 @@
 ### HEAD
 
+### [v0.12.0][v0.12.0] (November 5, 2018)
+
+#### Major changes
+
+* Dropped support for Rubinius ([#1785](https://github.com/pry/pry/pull/1785))
+
+#### Features
+
+* Added a new command, `clear-screen`, that clears the content of the screen Pry
+  is running in regardless of platform (Windows or UNIX-like)
+  ([#1723](https://github.com/pry/pry/pull/1723))
+* Added a new command, `gem-stat`, that prints gem statistics such as gem
+  dependencies and downloads ([#1707](https://github.com/pry/pry/pull/1707))
+* Added support for nested exceptions for the `wtf` command
+  ([#1791](https://github.com/pry/pry/pull/1791))
+* Added support for dynamic prompt names
+  ([#1833](https://github.com/pry/pry/pull/1833))
+
+  ```rb
+  # pryrc
+  Pry.config.prompt_name = Pry.lazy { rand(100) }
+
+  # Session
+  [1] 80(main)>
+  [2] 87(main)>
+  [3] 30(main)>
+  ```
+* Added support for XDG Base Directory Specification
+  ([#1609](https://github.com/pry/pry/pull/1609),
+  [#1844](https://github.com/pry/pry/pull/1844),
+  ([#1848](https://github.com/pry/pry/pull/1848)))
+* Removed the `simple-prompt`. Use `change-prompt simple` instead. The
+  `list-prompt` command was removed and embedded as `change-prompt --list`
+  ([#1849](https://github.com/pry/pry/pull/1849))
+
+#### API changes
+
+* The following methods started accepting the new optional `config` parameter
+  ([#1809](https://github.com/pry/pry/pull/1809)):
+  * `Pry::Helpers.tablify(things, line_length, config = Pry.config)`
+  * `Pry::Helpers.tablify_or_one_line(heading, things, config = Pry.config)`
+  * `Pry::Helpers.tablify_to_screen_width(things, options, config = Pry.config)`
+  * `Pry::Helpers::Table.new(items, args, config = Pry.config)`
+
+  You are expected to pass a session-local `_pry_.config` instead of the global
+  one.
+
+* Added new method `Pry::Config.assign`, for creating a Config non-recursively
+  ([#1725](https://github.com/pry/pry/issues/1725))
+* Added `Pry.lazy`, which is a helper method for values that need to be
+  calculated dynamically. Currently, only `config.prompt_name` supports it
+  ([#1833](https://github.com/pry/pry/pull/1833))
+* `Pry::Prompt` responds to `.[]`, `.all` & `.add` now. The `Pry::Prompt.add`
+  method must be used for implementing custom prompts. See the API in the
+  documentation for the class ([#1846](https://github.com/pry/pry/pull/1846))
+
+#### Breaking changes
+
+* Deleted the `Pry::Helpers::Text.bright_default` alias for
+  `Pry::Helpers::Text.bold` ([#1795](https://github.com/pry/pry/pull/1795))
+* `Pry::Helpers.tablify_to_screen_width(things, options, config = Pry.config)`
+  requires `options` or `nil` in place of them.
+* `Pry::Helpers::Table.new(items, args, config = Pry.config)` requires `args`
+  or `nil` in place of them.
+* Completely revamped `Pry::HistoryArray`
+  ([#1818](https://github.com/pry/pry/pull/1818)).
+  * It's been renamed to `Pry::Ring`
+    ([#1817](https://github.com/pry/pry/pull/1817))
+  * The implementation has changed and as result, the following methods were
+    removed:
+    * `Pry::Ring#length` (use `Pry::Ring#count` instead)
+    * `#empty?`, `#each`, `#inspect`, `#pop!`, `#to_h`
+  * To access old Enumerable methods convert the ring to Array with `#to_a`
+  * Fixed indexing for elements (e.g. `_pry_.input_ring[0]` always return some
+    element and not `nil`)
+* Renamed `Pry.config.prompt_safe_objects` to `Pry.config.prompt_safe_contexts`
+* Removed deprecated `Pry::CommandSet#before_command` &
+  `Pry::CommandSet#after_command` ([#1838](https://github.com/pry/pry/pull/1838))
+
+#### Deprecations
+
+* Deprecated `_pry_.input_array` & `_pry_.output_array` in favour of
+  `_pry_.input_ring` & `_pry_.output_ring` respectively
+  ([#1814](https://github.com/pry/pry/pull/1814))
+* Deprecated `Pry::Command#text`. Please use `#black`, `#white`, etc. directly
+  instead (as you would with helper functions from `BaseHelpers` and
+  `CommandHelpers`) ([#1701](https://github.com/pry/pry/pull/1701))
+* Deprecated `_pry_.input_array` & `_pry_.output_array` in favour of
+  `_pry_.input_ring` and `_pry_.output_ring` respectively
+  ([#1817](https://github.com/pry/pry/pull/1817))
+* Deprecated `Pry::Platform`. Use `Pry::Helpers::Platform` instead. Note that
+  `Pry::Helpers::BaseHelpers` still includes the `Platform` methods but emits a
+  warning. You must switch to `Pry::Helpers::Platform` in your code
+  ([#1838](https://github.com/pry/pry/pull/1838),
+  ([#1845](https://github.com/pry/pry/pull/1845)))
+* Deprecated `Pry::Prompt::MAP`. You should use `Pry::Prompt.all` instead to
+  access the same map ([#1846](https://github.com/pry/pry/pull/1846))
+
+#### Bug fixes
+
+* Fixed a bug where `cd Hash.new` reported `self` as an instance of Pry::Config
+  in the prompt ([#1725](https://github.com/pry/pry/pull/1725))
+* Silenced the `Could not find files for the given pattern(s)` error message
+  coming from `where` on Windows, when `less` or another pager is not installed
+  ([#1767](https://github.com/pry/pry/pull/1767))
+* Fixed possible double loading of Pry plugins' `cli.rb` on Ruby (>= 2.4) due to
+  [the `realpath` changes while invoking
+  `require`](https://bugs.ruby-lang.org/issues/10222)
+  ([#1762](https://github.com/pry/pry/pull/1762),
+  [#1774](https://github.com/pry/pry/pull/1762))
+* Fixed `NoMethodError` on code objects that have a comment but no source when
+  invoking `show-source` ([#1779](https://github.com/pry/pry/pull/1779))
+* Fixed `negative argument (ArgumentError)` upon pasting code with tabs, which
+  used to confuse automatic indentation
+  ([#1771](https://github.com/pry/pry/pull/1771))
+* Fixed Pry not being able to load history on Ruby 2.4.4+ when it contains the
+  null character ([#1789](https://github.com/pry/pry/pull/1789))
+* Fixed Pry raising errors on `cd`'ing into some objects that redefine
+  `method_missing` and `respond_to?`
+  ([#1811](https://github.com/pry/pry/pull/1811))
+* Fixed bug when indentation leaves parts of input after pressing enter when
+  Readline is enabled with mode indicators for vi mode
+  ([#1813](https://github.com/pry/pry/pull/1813),
+  [#1820](https://github.com/pry/pry/pull/1820),
+  [#1825](https://github.com/pry/pry/pull/1825))
+* Fixed `edit` not writing to history
+  ([#1749](https://github.com/pry/pry/issues/1749))
+
+#### Other changes
+
+* Deprecated the `Data` constant to match Ruby 2.5 in the `ls` command
+  ([#1731](https://github.com/pry/pry/pull/1731))
+
+### 0.11.3
+
 #### Features
 
 * Add Pry::Testable, an improved modular replacement for PryTestHelpers.
@@ -25,7 +160,7 @@ See pull request [#1673](https://github.com/pry/pry/pull/1673).
   that users of the [Hanami](http://hanamirb.org/) web framework experienced and
   reported since 2015.
 
-See pull request [#1639](https://github.com/pry/pry/pull/1689).
+See pull request [#1689](https://github.com/pry/pry/pull/1689).
 
 * Fix a bug where Method objects were not returned for setters inherited
   from a default (Pry::Config::Default). Eg, this is no longer an error:
@@ -44,6 +179,7 @@ See pull request [#1691](https://github.com/pry/pry/pull/1691).
 
 See pull request [#1674](https://github.com/pry/pry/pull/1674).
 
+
 ### 0.11.0
 
 * Add alias 'whereami[?!]+' for 'whereami' command. ([#1597](https://github.com/pry/pry/pull/1597))
@@ -795,3 +931,5 @@ complete CHANGELOG:
 
 ### 0.1.0 (2010/12/8)
 * release!
+
+[v0.12.0]: https://github.com/pry/pry/releases/tag/v0.12.0

data/LICENSE

@@ -3,7 +3,7 @@ License
 
 (The MIT License)
 
-Copyright (c) 2016 John Mair (banisterfiend)
+Copyright (c) 2018 The Pry Team
 
 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,20 +1,10 @@
-[![Build Status](https://img.shields.io/travis/pry/pry.svg)](https://travis-ci.org/pry/pry)
-[![Code Climate](https://img.shields.io/codeclimate/github/pry/pry.svg)](https://codeclimate.com/github/pry/pry)
-[![Inline docs](http://inch-ci.org/github/pry/pry.svg?style=shields)](http://inch-ci.org/github/pry/pry)
+[![Circle Build Status](https://circleci.com/gh/pry/pry.svg?style=shield)](https://circleci.com/gh/pry/pry)
+[![Code Climate](https://codeclimate.com/github/pry/pry.svg)](https://codeclimate.com/github/pry/pry)
+[![Gem Version](https://badge.fury.io/rb/pry.svg)](http://badge.fury.io/rb/pry)
+[![Documentation Status](http://inch-ci.org/github/pry/pry.svg?branch=master)](http://inch-ci.org/github/pry/pry)
+[![Downloads](https://img.shields.io/gem/dt/pry.svg?style=flat)](https://rubygems.org/gems/pry)
 <br><br>
-![logo for Pry](https://dl.dropbox.com/u/26521875/pry%20stuff/logo/pry_logo_350.png)
-
-© John Mair ([banisterfiend](https://twitter.com/banisterfiend)) 2016<br>
-
-**Please** [DONATE](http://pledgie.com/campaigns/15899) to the Pry project - Pry was a **huge** amount of work and every donation received is encouraging and supports Pry's continued development!
-
-**Sponsors**
-
-[Launch School](https://launchschool.com)<br/>
-[Atomic Object](https://atomicobject.com/)<br/>
-[Hashrocket](https://hashrocket.com/)<br/>
-[Intridea](http://www.intridea.com)<br/>
-[Gaslight](https://teamgaslight.com)<br/>
+![logo for Pry](https://www.dropbox.com/s/zp8o63kquby2rln/pry_logo_350.png?raw=1)
 
 **Other Resources**
 
@@ -52,10 +42,10 @@ is trivial to set it to read from any object that has a `readline` method and wr
 `puts` method - many other aspects of Pry are also configurable making
 it a good choice for implementing custom shells.
 
-Pry comes with an executable so it can be invoked at the command line.
-Just enter `pry` to start. A `.pryrc` file in the user's home directory will
-be loaded if it exists. Type `pry --help` at the command line for more
-information.
+Pry comes with an executable so it can be invoked at the command line.  Just
+enter `pry` to start. A `pryrc` file in `$XDG_CONFIG_HOME/pry/` or the user's
+home directory will be loaded if it exists. Type `pry --help` at the command
+line for more information.
 
 Try `gem install pry-doc` for additional documentation on Ruby Core
 methods. The additional docs are accessed through the `show-doc` and
@@ -180,9 +170,8 @@ present working directory into the Pry prompt and bring in (limited at this stag
 We can also interpolate Ruby code directly into the shell by
 using the normal `#{}` string interpolation syntax.
 
-In the code below we're going to switch to `shell-mode` and edit the
-`.pryrc` file in the home directory. We'll then cat its contents and
-reload the file.
+In the code below we're going to switch to `shell-mode` and edit the `pryrc`
+file. We'll then cat its contents and reload the file.
 
     pry(main)> shell-mode
     pry main:/home/john/ruby/projects/pry $ .cd ~
@@ -383,7 +372,7 @@ gem.
 
 You can toggle the syntax highlighting on and off in a session by
 using the `toggle-color` command. Alternatively, you can turn it off
-permanently by putting the line `Pry.color = false` in your `~/.pryrc`
+permanently by putting the line `Pry.color = false` in your `pryrc`
 file.
 
 ### Future Directions
@@ -399,9 +388,3 @@ between commands and running commands in background
 ### Contact
 
 Problems or questions? File an issue at [GitHub](https://github.com/pry/pry/issues).
-
-### Contributors
-
-Pry is primarily the work of [John Mair (banisterfiend)](https://github.com/banister), for full list
-of contributors see the
-[CONTRIBUTORS](https://github.com/pry/pry/blob/master/CONTRIBUTORS) file.

data/bin/pry

@@ -1,8 +1,4 @@
 #!/usr/bin/env ruby
-
-# (C) John Mair (banisterfiend)
-# MIT license
-
 $0 = 'pry'
 
 require 'pry'

data/lib/pry.rb

@@ -1,6 +1,3 @@
-# (C) John Mair (banisterfiend) 2016
-# MIT License
-#
 require 'pp'
 require 'pry/forwardable'
 require 'pry/input_lock'
@@ -13,6 +10,7 @@ class Pry
   # The default hooks - display messages when beginning and ending Pry sessions.
   DEFAULT_HOOKS = Pry::Hooks.new.add_hook(:before_session, :default) do |out, target, _pry_|
     next if _pry_.quiet?
+
     _pry_.run_command("whereami --quiet")
   end
 
@@ -46,47 +44,18 @@ class Pry
     else
       output.puts "#{exception.class}: #{exception.message}"
       output.puts "from #{exception.backtrace.first}"
+
+      if exception.respond_to? :cause
+        cause = exception.cause
+        while cause
+          output.puts "Caused by #{cause.class}: #{cause}\n"
+          output.puts "from #{cause.backtrace.first}"
+          cause = cause.cause
+        end
+      end
     end
   end
 
-  DEFAULT_PROMPT_NAME = 'pry'
-
-  # The default prompt; includes the target and nesting level
-  DEFAULT_PROMPT = [
-                    proc { |target_self, nest_level, pry|
-                      "[#{pry.input_array.size}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}> "
-                    },
-
-                    proc { |target_self, nest_level, pry|
-                      "[#{pry.input_array.size}] #{pry.config.prompt_name}(#{Pry.view_clip(target_self)})#{":#{nest_level}" unless nest_level.zero?}* "
-                    }
-                   ]
-
-  DEFAULT_PROMPT_SAFE_OBJECTS = [String, Numeric, Symbol, nil, true, false]
-
-  # A simple prompt - doesn't display target or nesting level
-  SIMPLE_PROMPT = [proc { ">> " }, proc { " | " }]
-
-  NO_PROMPT = [proc { '' }, proc { '' }]
-
-  SHELL_PROMPT = [
-                  proc { |target_self, _, _pry_| "#{_pry_.config.prompt_name} #{Pry.view_clip(target_self)}:#{Dir.pwd} $ " },
-                  proc { |target_self, _, _pry_| "#{_pry_.config.prompt_name} #{Pry.view_clip(target_self)}:#{Dir.pwd} * " }
-                 ]
-
-  # A prompt that includes the full object path as well as
-  # input/output (_in_ and _out_) information. Good for navigation.
-  NAV_PROMPT = [
-                proc do |_, _, _pry_|
-                  tree = _pry_.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
-                  "[#{_pry_.input_array.count}] (#{_pry_.config.prompt_name}) #{tree}: #{_pry_.binding_stack.size - 1}> "
-                end,
-                proc do |_, _, _pry_|
-                  tree = _pry_.binding_stack.map { |b| Pry.view_clip(b.eval("self")) }.join " / "
-                  "[#{_pry_.input_array.count}] (#{ _pry_.config.prompt_name}) #{tree}: #{_pry_.binding_stack.size - 1}* "
-                end,
-               ]
-
   # Deal with the ^D key being pressed. Different behaviour in different cases:
   #   1. In an expression behave like `!` command.
   #   2. At top-level session behave like `exit` command.
@@ -112,10 +81,6 @@ class Pry
     end
   end
 
-  # Store the current working directory. This allows show-source etc. to work if
-  # your process has changed directory since boot. [Issue #675]
-  INITIAL_PWD = Dir.pwd
-
   # This is to keep from breaking under Rails 3.2 for people who are doing that
   # IRB = Pry thing.
   module ExtendCommandBundle; end
@@ -133,9 +98,8 @@ require 'pathname'
 
 require 'pry/version'
 require 'pry/repl'
-require 'pry/rbx_path'
 require 'pry/code'
-require 'pry/history_array'
+require 'pry/ring'
 require 'pry/helpers'
 require 'pry/code_object'
 require 'pry/method'
@@ -146,6 +110,12 @@ require 'pry/command_set'
 require 'pry/commands'
 require 'pry/plugins'
 require 'pry/core_extensions'
+require 'pry/basic_object'
+require 'pry/config/behavior'
+require 'pry/config/memoization'
+require 'pry/config/default'
+require 'pry/config/convenience'
+require 'pry/config'
 require 'pry/pry_class'
 require 'pry/pry_instance'
 require 'pry/cli'

data/lib/pry/cli.rb

@@ -1,12 +1,9 @@
 class Pry
-
   # Manage the processing of command line options
   class CLI
-
     NoOptionsError = Class.new(StandardError)
 
     class << self
-
       # @return [Proc] The Proc defining the valid command line options.
       attr_accessor :options
 
@@ -57,22 +54,19 @@ class Pry
         self.option_processors = nil
       end
 
-      def parse_options(args=ARGV)
+      def parse_options(args = ARGV)
         unless options
           raise NoOptionsError, "No command line options defined! Use Pry::CLI.add_options to add command line options."
         end
 
-        # Load config files etc first, ensuring that cli options will take precedence.
-        Pry.initial_session_setup
-
         self.input_args = args
 
         begin
           opts = Pry::Slop.parse!(
             args,
-            :help => true,
-            :multiple_switches => false,
-            :strict => true,
+            help: true,
+            multiple_switches: false,
+            strict: true,
             &options
           )
         rescue Pry::Slop::InvalidOptionError
@@ -81,6 +75,7 @@ class Pry
           exit
         end
 
+        Pry.initial_session_setup
         Pry.final_session_setup
 
         # Option processors are optional.
@@ -113,16 +108,14 @@ class Pry
         end
 
         # Start the session (running any code passed with -e, if there is any)
-        Pry.start(context, :input => StringIO.new(Pry.config.exec_string))
+        Pry.start(context, input: StringIO.new(Pry.config.exec_string))
       end
-
     end
 
     reset
   end
 end
 
-
 # Bring in options defined by plugins
 Pry::Slop.new do
   on "no-plugins" do
@@ -136,12 +129,12 @@ end
 
 # The default Pry command line options (before plugin options are included)
 Pry::CLI.add_options do
-  banner %{Usage: pry [OPTIONS]
-Start a Pry session.
-See http://pryrepl.org/ for more information.
-Copyright (c) 2016 John Mair (banisterfiend)
---
-}
+  banner(
+    "Usage: pry [OPTIONS]\n" \
+    "Start a Pry session.\n" \
+    "See http://pryrepl.org/ for more information.\n"
+  )
+
   on :e, :exec=, "A line of code to execute in context before the session starts" do |input|
     Pry.config.exec_string += "\n" if Pry.config.exec_string.length > 0
     Pry.config.exec_string += input
@@ -159,7 +152,7 @@ Copyright (c) 2016 John Mair (banisterfiend)
     Pry.config.color = false
   end
 
-  on :f, "Suppress loading of ~/.pryrc and ./.pryrc" do
+  on :f, "Suppress loading of pryrc" do
     Pry.config.should_load_rc = false
     Pry.config.should_load_local_rc = false
   end
@@ -187,18 +180,18 @@ Copyright (c) 2016 John Mair (banisterfiend)
   end
 
   on "simple-prompt", "Enable simple prompt mode" do
-    Pry.config.prompt = Pry::SIMPLE_PROMPT
+    Pry.config.prompt = Pry::Prompt[:simple][:value]
   end
 
   on "noprompt", "No prompt mode" do
-    Pry.config.prompt = Pry::NO_PROMPT
+    Pry.config.prompt = Pry::Prompt[:none][:value]
   end
 
   on :r, :require=, "`require` a Ruby script at startup" do |file|
     Pry.config.requires << file
   end
 
-  on :I=, "Add a path to the $LOAD_PATH", :as => Array, :delimiter => ":" do |load_path|
+  on :I=, "Add a path to the $LOAD_PATH", as: Array, delimiter: ":" do |load_path|
     load_path.map! do |path|
       /\A\.\// =~ path ? path : File.expand_path(path)
     end
@@ -220,6 +213,6 @@ Copyright (c) 2016 John Mair (banisterfiend)
 
   on(:c, :context=,
      "Start the session in the specified context. Equivalent to `context.pry` in a session.",
-     :default => "Pry.toplevel_binding"
+     default: "Pry.toplevel_binding"
      )
 end