pry 0.10.4 → 0.12.2

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: f1b85ec70167eee63c4f58e11c27f2c1f94f49db
-  data.tar.gz: 08a2b56e67aef2cdaf4fb6c4aa3ac0c1e8bf395f
+  metadata.gz: 6320662aa62bb2b7410cb900e5e0d75e075413da
+  data.tar.gz: d72635ecb0613ee87e6bf7fbc37c71573f1137ce
 SHA512:
-  metadata.gz: f82d5ccba499a9dc6a11bc48496424f691248134bad714cdaf8704bc95ffd3368fa07471d3651f464fcf92cac0b0779860276fa973783f1b2bd34b338c14ce92
-  data.tar.gz: 088a2f47add7c3e16ca078f4e84ebac15b05051d945b3f5c25a295292ec6478bf5bbe0c6752a143f16d323116fbf1e19ebd72b5fbbfa716830a9181a768fe20a
+  metadata.gz: 396ab2db71196633ab518104409ae367d67c9c9e64a318bdecbef0e40010364cc207211f808f2e616d9909ec93b256b5bc0f58a458f7ac97d195eee8ee6d7e71
+  data.tar.gz: f74d3c223f09b7d06af0a30500176a6caa10474646ce59fb787d6a5936ab420828a399679d55f7fa0a106ab2f5f45d622748cb13804af85032621151c1147a94

data/CHANGELOG.md

@@ -1,11 +1,243 @@
-### 0.10.3
+### HEAD
 
-* cherry-pick 0d1d72b and e0e5c75 to fix the install of Pry on Windows.
+### [v0.12.2][v0.12.2] (November 12, 2018)
 
-### 0.10.2
+#### Bug fixes
 
-* cherry-pick c2ed9ec135bd791a32c70fbe05cc0508ea17c4040e from master (fix inf. loop with prepended methods source retrieval)
-* Update some specs for recent ruby versions  (2.2+)
+* Restore removed deprecations, which were removed by accident due to a bad
+  rebase.
+
+### [v0.12.1][v0.12.1] (November 12, 2018)
+
+#### Bug fixes
+
+* Stopped creating a new hash each time `Pry::Prompt#[]` is invoked
+  ([#1855](https://github.com/pry/pry/pull/1855))
+* Fixed `less` pager not working when it's available
+  ([#1861](https://github.com/pry/pry/pull/1861))
+
+### [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.
+  **breaking change**.
+
+See pull request [#1679](https://github.com/pry/pry/pull/1679).
+
+* Add a new category module: "Pry::Platform". Loosely related to #1668 below.
+
+See pull request [#1670](https://github.com/pry/pry/pull/1670)
+
+* Add `mac_osx?` and `linux?` utility functions to Pry::Helpers::BaseHelpers.
+
+See pull request [#1668](https://github.com/pry/pry/pull/1668).
+
+* Add utility functions for drawing colorised text on a colorised background.
+
+See pull request [#1673](https://github.com/pry/pry/pull/1673).
+
+#### Bug fixes
+
+* Fix a case of infinite recursion in `Pry::Method::WeirdMethodLocator#find_method_in_superclass`
+  that users of the [Hanami](http://hanamirb.org/) web framework experienced and
+  reported since 2015.
+
+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:
+
+      pry(main)> d = Pry::Config.from_hash({}, Pry::Config::Default.new)
+      pry(main)> d.method(:exception_whitelist=) # Error
+
+See pull request [#1688](https://github.com/pry/pry/pull/1688).
+
+* Do not capture unused Proc objects in Text helper methods `no_color` and `no_paging`,
+  for performance reasons. Improve the documentation of both methods.
+
+See pull request [#1691](https://github.com/pry/pry/pull/1691).
+
+* Fix `String#pp` output color.
+
+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))
+* Improve Ruby 2.4 support ([#1611](https://github.com/pry/pry/pull/1611)):
+  * Deprecated constants are hidden from `ls` output by default, use the `-d` switch to see them.
+  * Fix warnings that originate in Pry while using the repl.
+* Improve completion speed in large applications. ([#1588](https://github.com/pry/pry/pull/1588))
+* Pry::ColorPrinter.pp: add `newline` argument and pass it on to PP. ([#1603](https://github.com/pry/pry/pull/1603))
+* Use `less` or system pager pager on MS Windows if it is available. ([#1512](https://github.com/pry/pry/pull/1512))
+* Add `Pry.configure` as an alternative to the current way of changing configuration options in `.pryrc` files. ([#1502](https://github.com/pry/pry/pull/1502))
+* Add `Pry::Config::Behavior#eager_load!` to add a possible workaround for issues like ([#1501](https://github.com/pry/pry/issues/1501))
+* Remove Slop as a runtime dependency by vendoring v3.4 as Pry::Slop.
+  People can depend on Slop v4 and Pry at the same time without running into version conflicts. ([#1497](https://github.com/pry/pry/issues/1497))
+* Fix auto-indentation of code that uses a single-line rescue ([#1450](https://github.com/pry/pry/issues/1450))
+* Remove "Pry::Config#refresh", please use "Pry::Config#clear" instead.
+* Defining a method called "ls" no longer breaks the "ls" command ([#1407](https://github.com/pry/pry/issues/1407))
+* Don't raise when directory permissions don't allow file expansion ([#1432](https://github.com/pry/pry/issues/1432))
+* Syntax highlight <tt> tags in documentation output.
+* Add support for BasicObject subclasses who implement their own #inspect (#1341)
+* Fix 'include RSpec::Matchers' at the top-level (#1277)
+* Add 'gem-readme' command, prints the README file bundled with a rubygem
+* Add 'gem-search' command, searches for a gem with the rubygems.org HTTP API
+* Fixed bug in the `cat` command where it was impossible to use line numbers with files ([#1349](https://github.com/pry/pry/issues/1349))
+* Fixed uncaught Errno::EOPNOTSUPP exception when $stdout is a socket ([#1352](https://github.com/pry/pry/issues/1352))
+* Display a warning when you cd'ed inside a C object and executed 'show-source' without arguments ([#691](https://github.com/pry/pry/issues/691))
+* Make the stagger_output method more reliable by reusing possibly available Pry instance ([#1364](https://github.com/pry/pry/pull/1364))
+* Make the 'gem-install' message less confusing by removing backticks ([#1350](https://github.com/pry/pry/pull/1350))
+* Fixed error when Pry was trying to load incompatible versions of plugins ([#1312](https://github.com/pry/pry/issues/1312))
+* Fixed bug when `hist --clear` led to ArgumentError ([#1340](https://github.com/pry/pry/pull/1340))
+* Fixed the "uninitialized constant Pry::ObjectPath::StringScanner" exception during autocomplete ([#1330](https://github.com/pry/pry/issues/1330))
+* Secured usage of colours with special characters (RL_PROMPT_START_IGNORE and RL_PROMPT_END_IGNORE) in Pry::Helpers::Text ([#493](https://github.com/pry/pry/issues/493#issuecomment-39232771))
+* Fixed regression with `pry -e` when it messes the terminal ([#1387](https://github.com/pry/pry/issues/1387))
+* Fixed regression with space prefixes of expressions ([#1369](https://github.com/pry/pry/issues/1369))
+* Introduced the new way to define hooks for commands (with `Pry.hooks.add_hook("{before,after}_commandName")`). The old way is deprecated, but still supported (with `Pry.commands.{before,after}_command`) ([#651](https://github.com/pry/pry/issues/651))
+* Removed old API's using `Pry::Hooks.from_hash` altogether
+* Removed hints on Foreman support (see [this](https://github.com/ddollar/foreman/pull/536))
+* Fixed support for the tee command ([#1334](https://github.com/pry/pry/issues/1334))
+* Implemented support for CDPATH for ShellCommand ([#1433](https://github.com/pry/pry/issues/1433), [#1434](https://github.com/pry/pry/issues/1434))
+* `Pry::CLI.parse_options` does not start Pry anymore ([#1393](https://github.com/pry/pry/pull/1393))
+* The gem uses CPU-less platforms for Windows now ([#1410](https://github.com/pry/pry/pull/1410))
+* Add `Pry::Config::Memoization` to make it easier to implement your own `Pry::Config::Default` class.([#1503](https://github.com/pry/pry/pull/1503/))
+* Lazy load the config defaults for `Pry.config.history` and `Pry.config.gist`.
 
 ### 0.10.1
 
@@ -13,7 +245,6 @@
 * Move to rspec for testing (from bacon)
 * Clean up ruby warnings
 
-
 ### 0.10.0
 
 #### Features
@@ -376,7 +607,7 @@
   * Fewer internal methods polluting output
 
 ### 0.9.8.4 (2012/6/3)
-* ~/.pry_history wasnt being created (if it did not exist)! FIXED
+* ~/.pry_history wasn't being created (if it did not exist)! FIXED
 * `hist --save` saved colors! FIXED
 * added Pry#add_sticky_local API for adding sticky locals to individual pry instances
 
@@ -384,7 +615,7 @@
 * various tweaks to improve rbx support
 * commands now support optional block arguments
 * much improved help command
-* updated method_source dependencya
+* updated method_source dependency
 * added wtf command
 * jruby should now work in windows (though without color)
 
@@ -412,7 +643,7 @@ MAJOR NEW FEATURES
 - added gist command (removed gist-method, new gist command is more general)
 
 complete CHANGELOG:
-* CommandError's no longer cause the current input to be disgarded
+* CommandError's no longer cause the current input to be discarded
 * Better syntax highlighting for rbx code code
 * added cat --in to show pry input history
 * prefixed temporary file names with 'pry'
@@ -425,7 +656,7 @@ complete CHANGELOG:
 * added CommandSet#{before_command,after_command} for enhancing builtin commands
 * added checking for namespace collisions with pry commands, set Pry.config.collision_warning
 * work around namespace collisions by ensuring lines starting with a space are executed as
-* ruby.work around namespace collisions by prensuring lines starting with a space are executed as ruby
+* ruby.work around namespace collisions by pressuring lines starting with a space are executed as ruby
 * added handlers for Ctrl+C (SIGINT) on jruby, these are now caught as in other ruby versions
 * removed dependency on ruby_parser
 * prevented colours leaking across the pry prompt
@@ -445,7 +676,7 @@ complete CHANGELOG:
 
 ### 0.9.7.4 (2011/11/5)
 * ls -M now works in modules (bugfix)
-* added exception msg for bad cd object/path
+* added exception message for bad cd object/path
 * no longer die when encounter exceptions in .pryrc
 * baked in CoolLine support
 * Pry.config.input in .pryrc now respected
@@ -462,7 +693,7 @@ complete CHANGELOG:
 * changed ^D so it no longer resets indent level automatically
 
 ### 0.9.7.1 (2011/10/26)
-* fixed gem dependecy issues
+* fixed gem dependency issues
 
 ### 0.9.7 (2011/10/25)
 
@@ -503,7 +734,7 @@ complete CHANGELOG:
 * play -m --open uses show-input to show play'd code
 * added "unindent" helper to make adding help to commands easier
 * local ./.pryrc now loaded after ~/.pryrc if it exists
-* cat --ex N and edit --ex N now can navigate through backtrace, where cat --ex (with no args) moves throuh successive levels of the backtrace automatically with state stored on the exceptino object itself
+* cat --ex N and edit --ex N now can navigate through backtrace, where cat --ex (with no args) moves through successive levels of the backtrace automatically with state stored on the exception object itself
 * new option Pry.config.exception_window_size determines window size for cat --ex
 * input_stack now implemented - pushing objects onto a pry instance's input_stack causes the instance to read from those objects in turn as it encounters EOF on the previous object. On finishing the input_stack the input object for the pry instance is set back to Pry.config.input, if this fails, pry breaks out of the REPL (throw(:breakout)) with an error message
 * Pry.config.system() defines how pry runs system commands
@@ -536,10 +767,10 @@ complete CHANGELOG:
 * fixed bug #200 ( https://github.com/pry/pry/issues/200 )- string interpolation bug (thanks to ryanf)
 * show-doc and stat now display method visibility (update WIKI)
 * got rid of warnings caused by stricter ruby 1.9.3 rules
-* remove interpolation of command names and fix interpolation error messag (update WIKI) (thanks ryanf!)
+* remove interpolation of command names and fix interpolation error message (update WIKI) (thanks ryanf!)
 * 'nested sessions' now use binding stacks (so each instance manages its own collection of bindings without spawning other instances)
 * 'cd ..' just pops a binding off the binding_stack with special behaviour when only one binding in stack - it breaks out of the repl loop
-* added switch-to command (like jump-to but doesnt unwind the stack)
+* added switch-to command (like jump-to but doesn't unwind the stack)
 * show-method and show-doc now accept multiple method names
 * control_d hook added (Pry.config.control_d_handler)
 * behaviour of ^d is now to break out of current expr if in multi-line expr, or break out of current context if nested, or break out of pry repl loop if at top-level
@@ -633,7 +864,7 @@ complete CHANGELOG:
 * -I mode for pry commandline
 * --color mode for pry commandline
 * clean up requires (put them all in one place)
-* simple-prompt command and toggle-color commandd.
+* simple-prompt command and toggle-color command.
 
 ### 0.6.3 (2011/2/28)
 * Using MethodSource 0.3.4 so 1.8 show-method support provided
@@ -716,3 +947,7 @@ complete CHANGELOG:
 
 ### 0.1.0 (2010/12/8)
 * release!
+
+[v0.12.0]: https://github.com/pry/pry/releases/tag/v0.12.0
+[v0.12.1]: https://github.com/pry/pry/releases/tag/v0.12.1
+[v0.12.2]: https://github.com/pry/pry/releases/tag/v0.12.2

data/LICENSE

@@ -3,7 +3,7 @@ License
 
 (The MIT License)
 
-Copyright (c) 2013 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,27 +1,16 @@
-[![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)](http://inch-ci.org/github/pry/pry)
-
-<center>
-![The Pry Logo](https://dl.dropbox.com/u/26521875/pry%20stuff/logo/pry_logo_350.png)
-
-© John Mair ([banisterfiend](https://twitter.com/banisterfiend)) 2013<br>
-
-**Please** [DONATE](http://www.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**
-
-[Tealeaf Academy](http://www.gotealeaf.com)<br/>
-[Atomic Object](http://www.atomicobject.com/)<br/>
-[Hashrocket](http://hashrocket.com/)<br/>
-[Intridea](http://intridea.com/)<br/>
-[Gaslight](http://gaslight.co/home)<br/>
+[![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://www.dropbox.com/s/zp8o63kquby2rln/pry_logo_350.png?raw=1)
 
 **Other Resources**
 
-[Skip to the website (recommended)](http://pry.github.com) <br />
+[Skip to the website (recommended)](http://pryrepl.org/) <br />
 [Skip to the wiki](https://github.com/pry/pry/wiki)
-</center>
+
 
 Pry is a powerful alternative to the standard IRB shell for Ruby. It is
 written from scratch to provide a number of advanced features,
@@ -44,7 +33,7 @@ including:
 
 Pry also aims to be more than an IRB replacement; it is an
 attempt to bring REPL driven programming to the Ruby language. It is
-currently not as powerful as tools like [SLIME](http://en.wikipedia.org/wiki/SLIME) for lisp, but that is the
+currently not as powerful as tools like [SLIME](https://en.wikipedia.org/wiki/SLIME) for lisp, but that is the
 general direction Pry is heading.
 
 Pry is also fairly flexible and allows significant user
@@ -53,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
@@ -64,8 +53,8 @@ methods. The additional docs are accessed through the `show-doc` and
 
 * Install the [gem](https://rubygems.org/gems/pry): `gem install pry`
 * Browse the comprehensive [documentation at the official Pry wiki](https://github.com/pry/pry/wiki)
-* Read the [YARD API documentation](http://rdoc.info/github/pry/pry/master/file/README.markdown)
-* See the [source code](http://github.com/pry/pry)
+* Read the [YARD API documentation](http://www.rubydoc.info/github/pry/pry/)
+* See the [source code](https://github.com/pry/pry)
 
 ### Commands
 
@@ -137,20 +126,22 @@ implementing developer consoles and applying hot patches.
 
 code:
 
-    # test.rb
-    require 'pry'
+```ruby
+# test.rb
+require 'pry'
 
-    class A
-      def hello() puts "hello world!" end
-    end
+class A
+  def hello() puts "hello world!" end
+end
 
-    a = A.new
+a = A.new
 
-    # start a REPL session
-    binding.pry
+# start a REPL session
+binding.pry
 
-    # program resumes here (after pry session)
-    puts "program resumes here."
+# program resumes here (after pry session)
+puts "program resumes here."
+```
 
 Pry session:
 
@@ -179,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 ~
@@ -314,10 +304,10 @@ We can also use `ri` in the normal way:
 
 ### Gist integration
 
-If the `gist` gem is installed then method source or documentation can be gisted to github with the
+If the `gist` gem is installed then method source or documentation can be gisted to GitHub with the
 `gist` command.  The `gist` command is capable of gisting [almost any REPL content](https://gist.github.com/cae143e4533416529726), including methods, documentation,
 input expressions, command source, and so on. In the example below we will gist the C source
-code for the `Symbol#to_proc` method to github:
+code for the `Symbol#to_proc` method to GitHub:
 
     pry(main)> gist -m Symbol#to_proc
     Gist created at https://gist.github.com/5332c38afc46d902ce46 and added to clipboard.
@@ -351,7 +341,7 @@ Many other commands are available in Pry; to see the full list type
 with basic instructions for use; some commands have a more extensive
 help that can be accessed via typing `command_name --help`. A command
 will typically say in its description if the `--help` option is
-avaiable.
+available.
 
 ### Use Pry as your Rails Console
 
@@ -382,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
@@ -397,10 +387,4 @@ 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)](http://github.com/banister), for full list
-of contributors see the
-[CONTRIBUTORS](https://github.com/pry/pry/blob/master/CONTRIBUTORS) file.
+Problems or questions? File an issue at [GitHub](https://github.com/pry/pry/issues).

data/bin/pry

@@ -1,16 +1,8 @@
 #!/usr/bin/env ruby
-
-# (C) John Mair (banisterfiend)
-# MIT license
-
 $0 = 'pry'
 
-begin
-  require 'pry'
-rescue LoadError
-  require 'rubygems'
-  require 'pry'
-end
+require 'pry'
 
 # Process command line options and run Pry
-Pry::CLI.parse_options
+opts = Pry::CLI.parse_options
+Pry::CLI.start(opts)

data/lib/pry/basic_object.rb

@@ -0,0 +1,6 @@
+class Pry::BasicObject < BasicObject
+  [:Kernel, :Pry].each do |constant|
+    const_set constant, ::Object.const_get(constant)
+  end
+  include Kernel
+end