master

Features

Added metadata to the gem (such as changelog URI, source code URI & bug tracker URI), so it shows on https://rubygems.org/gems/pry (#1869)
Added ability to forward ARGV to a Pry session via -- (or -) when launching Pry from shell (#1902)
Added Pry::Config::LazyValue & Pry::Config::MemoizedValue, which allow storing callable procs in the config (#2024)
Added the rc_file config option that tells Pry the path to pryrc (#2027)
Added the --code flag to the wtf command, which shows code for each backtrace frame (#2037)
Added the ability to paste method call chains with leading dots (#2060)

API changes

Pry::Prompt is a class now and it can be instantiated to create new prompts on the fly that are not registered with Pry::Prompt#add. Learn more about its API in the docs (#1877)

Deprecations

Deprecated Pry.config.exception_whitelist in favor of Pry.config.unrescued_exceptions (#1874)
Deprecated Pry.config.prompt = Pry::Prompt[:simple][:value] in favor of Pry.config.prompt = Pry::Prompt[:simple] when setting Pry prompt via pryrc. Pry::Prompt[:simple] would return an instance of Pry::Prompt instead of Hash (#1877)
Deprecated setting prompt via an array of two procs: (#1877)
```
# Deprecated, emits a warning.
Pry.config.prompt = [proc {}, proc {}]
```
This will be removed in the next release.
Deprecated the show-doc command. The show-source -d is the new recommended way of reading docs (#1934)
Deprecated Pry::Command#_pry_. Use Pry::Command#pry_instance instead (#1989)

Breaking changes

Deleted deprecated Pry::Platform (#1863)
Deleted deprecated Pry#{input/output}_array (#1884)
Deleted deprecated Pry::Prompt::MAP (#1866)
Deleted deprecated methods of Pry::Helpers::BaseHelpers such as mac_osx?, linux?, windows?, windows_ansi?, jruby?, jruby_19?, mri?, mri_19?, mri_2? (#1867)
Deleted deprecated Pry::Command#text (#1865)
Deleted deprecated Pry::Method#all_from_common (#1868)
Deleted install-command (#1979)
Deleted Pry::Helpers::BaseHelpers#command_dependencies_met? (#1979)
Deleted commands: gem-cd, gem-install, gem-list, gem-open, gem-readme, gem-search, gem-stats (#1981)
Deleted deprecated commands: edit-method and show-command (#2001)
Deleted Pry::Command#disabled_commands (#2001)
Deleted Pry::BlockCommand#opts (use #context instead) (#2003)
Deleted Pry.lazy (use Pry::Config::LazyValue instead) (#2024)

Bug fixes

Fixed bug where using Pry.config.prompt_name can return a Pry::Config::Lazy instead of expected instance of String (#1890)
Fixed LoadError being raised when using auto completions and Bundler (#1896)
Fixed bug where Pry.input_ring doesn't append duplicate elements (#1898)
Fixed Ruby 2.6 warning about Binding#source_location (#1904)
Fixed wrong winsize when custom output is passed to Pry (#2045)
Fixed XDG_CONFIG_HOME & XDG_DATA_HOME precedence. When these env variables are set, Pry no longer uses traditional files like ~/.pryrc & ~/.pry_history. Instead, the env variable paths are loaded first (#2056)

v0.12.2 (November 12, 2018)

Bug fixes

Restore removed deprecations, which were removed by accident due to a bad rebase.

v0.12.1 (November 12, 2018)

Bug fixes

Stopped creating a new hash each time Pry::Prompt#[] is invoked (#1855)
Fixed less pager not working when it's available (#1861)

v0.12.0 (November 5, 2018)

Major changes

Dropped support for Rubinius (#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)
Added a new command, gem-stat, that prints gem statistics such as gem dependencies and downloads (#1707)
Added support for nested exceptions for the wtf command (#1791)

Added support for dynamic prompt names (#1833)

# 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, #1844, (#1848))
Removed the simple-prompt. Use change-prompt simple instead. The list-prompt command was removed and embedded as change-prompt --list (#1849)

API changes

The following methods started accepting the new optional config parameter (#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)
Added Pry.lazy, which is a helper method for values that need to be calculated dynamically. Currently, only config.prompt_name supports it (#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)

Breaking changes

Deleted the Pry::Helpers::Text.bright_default alias for Pry::Helpers::Text.bold (#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).
- It's been renamed to Pry::Ring (#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)

Deprecations

Deprecated _pry_.input_array & _pry_.output_array in favour of _pry_.input_ring & _pry_.output_ring respectively (#1814)
Deprecated Pry::Command#text. Please use #black, #white, etc. directly instead (as you would with helper functions from BaseHelpers and CommandHelpers) (#1701)
Deprecated _pry_.input_array & _pry_.output_array in favour of _pry_.input_ring and _pry_.output_ring respectively (#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, (#1845))
Deprecated Pry::Prompt::MAP. You should use Pry::Prompt.all instead to access the same map (#1846)

Bug fixes

Fixed a bug where cd Hash.new reported self as an instance of Pry::Config in the prompt (#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)
Fixed possible double loading of Pry plugins' cli.rb on Ruby (>= 2.4) due to the realpath changes while invoking require (#1762, #1774)
Fixed NoMethodError on code objects that have a comment but no source when invoking show-source (#1779)
Fixed negative argument (ArgumentError) upon pasting code with tabs, which used to confuse automatic indentation (#1771)
Fixed Pry not being able to load history on Ruby 2.4.4+ when it contains the null character (#1789)
Fixed Pry raising errors on cd'ing into some objects that redefine method_missing and respond_to? (#1811)
Fixed bug when indentation leaves parts of input after pressing enter when Readline is enabled with mode indicators for vi mode (#1813, #1820, #1825)
Fixed edit not writing to history (#1749)

Other changes

Deprecated the Data constant to match Ruby 2.5 in the ls command (#1731)

0.11.3

Features

Add Pry::Testable, an improved modular replacement for PryTestHelpers. breaking change.

See pull request #1679.

Add a new category module: "Pry::Platform". Loosely related to #1668 below.

See pull request #1670

Add mac_osx? and linux? utility functions to Pry::Helpers::BaseHelpers.

See pull request #1668.

Add utility functions for drawing colorised text on a colorised background.

See pull request #1673.

Bug fixes

Fix a case of infinite recursion in Pry::Method::WeirdMethodLocator#find_method_in_superclass that users of the Hanami web framework experienced and reported since 2015.

See pull request #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.

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.

Fix String#pp output color.

See pull request #1674.

0.11.0

Add alias 'whereami[?!]+' for 'whereami' command. (#1597)
Improve Ruby 2.4 support (#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)
Pry::ColorPrinter.pp: add newline argument and pass it on to PP. (#1603)
Use less or system pager pager on MS Windows if it is available. (#1512)
Add Pry.configure as an alternative to the current way of changing configuration options in .pryrc files. (#1502)
Add Pry::Config::Behavior#eager_load! to add a possible workaround for issues like (#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)
Fix auto-indentation of code that uses a single-line rescue (#1450)
Remove "Pry::Config#refresh", please use "Pry::Config#clear" instead.
Defining a method called "ls" no longer breaks the "ls" command (#1407)
Don't raise when directory permissions don't allow file expansion (#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)
Fixed uncaught Errno::EOPNOTSUPP exception when $stdout is a socket (#1352)
Display a warning when you cd'ed inside a C object and executed 'show-source' without arguments (#691)
Make the stagger_output method more reliable by reusing possibly available Pry instance (#1364)
Make the 'gem-install' message less confusing by removing backticks (#1350)
Fixed error when Pry was trying to load incompatible versions of plugins (#1312)
Fixed bug when hist --clear led to ArgumentError (#1340)
Fixed the "uninitialized constant Pry::ObjectPath::StringScanner" exception during autocomplete (#1330)
Secured usage of colours with special characters (RL_PROMPT_START_IGNORE and RL_PROMPT_END_IGNORE) in Pry::Helpers::Text (#493)
Fixed regression with pry -e when it messes the terminal (#1387)
Fixed regression with space prefixes of expressions (#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)
Removed old API's using Pry::Hooks.from_hash altogether
Removed hints on Foreman support (see this)
Fixed support for the tee command (#1334)
Implemented support for CDPATH for ShellCommand (#1433, #1434)
Pry::CLI.parse_options does not start Pry anymore (#1393)
The gem uses CPU-less platforms for Windows now (#1410)
Add Pry::Config::Memoization to make it easier to implement your own Pry::Config::Default class.(#1503)
Lazy load the config defaults for Pry.config.history and Pry.config.gist.

0.10.1

Fix bugs with jruby
Move to rspec for testing (from bacon)
Clean up ruby warnings

0.10.0

Features

Added a watch command that lets you see how values change over time.
Added an experimental Pry.auto_resize! method
- Makes Pry notice that your window has resized and tell Readline about it
- Fixes various bugs with command history after a window resize
- Off by default, but can be called from your .pryrc if you're brave
play now has an -e/--expression flag
- Evaluates until the end of the first valid expression
History gets appended to ~/.pry_history after every input, not just at quit
Return values render with more accurate syntax highlighting
Return values start rendering immediately and stream into the pager
User can override .pryrc location by setting $PRYRC env var (#893)
User can whitelist objects whose inspect output should appear in prompt (#885)
- See Pry.config.prompt_safe_objects
whereami is now aliased to @
Added arguments to whereami:
- -m shows the surrounding method
- -c shows the surrounding class
- -f shows the entire file
Lazy load configuration values (Pry.config). (#1096)
Defer requiring readline until Pry is started for the first time. (#1117)
Add option to disable input completer through _pry_.config.completer = nil
Add list-prompts command. (#1175)
- Lists the available prompts available for use.
Add change-prompt command. (#1175)
- Switches the current prompt, by name.
Add list-inspectors command. (#1176)
- Lists the inspectors available to print Ruby return values.
Add change-inspector command. (#1176)
- Switches the current inspector, by name.
Add show-source -e. (#1185)
- Evaluate the given Ruby expression and show the source of its return value.
Add Pry.config.windows_console_warning(#1218)
- Windows JRuby users who don't want warnings about ansicon can set Pry.config.windows_console_warning = false.
Add arguments to play command.
- -p prints the code before playing it.
- -e allows you to play expressions from your session.
Add cd - to switch to the previous binding.
Allow prying into frozen objects.

Dependency changes

Remove dependency on ffi gem on JRuby (#1158)
Remove optional dependency on Bond (#1166)
- Bond support has been extracted to the pry-bond plugin
Remove dependency on openstruct (#1096)
Drop support for Ruby 1.8.7 (0.9.12.x will continue to be available)
Add support for Ruby 2.1
Require Coderay ~> 1.1.0
Remove deprecated hooks API (#1209)
Add 64-bit windows support.

Bug fixes, etc.

The gem-install command can require gems like net-ssh thanks to better logic for guessing what path to require. (#1188)
toggle-color command toggles the local _pry_.color setting instead of the global Pry.color.
Update Pry::CLIPPED_PRINT to include a hex representation of object ID when printing a return value. (#1162)
Wrap exceptions in a proxy instead of adding singleton methods. (#1145)
- Pry#last_exception= now supports exception objects that have been frozen.
binding.pry inside .pryrc file now works, with some limitations (@richo / #1118)
Add support for BasicObjects to ls (#984)
Allow ls -c <anything> (#891)
Fix indentation not working if the mathn stdlib was loaded (#872)
Fix hist's --exclude-pry switch (#874)
Fix gem-install on JRuby (#870)
Fix source lookup for instrumented classes (#923)
Improved thread safety when multiple instances are running (#944)
Make edit ignore -n/--no-reload flag and disable_auto_reload config in cases where the user was editing a tempfile
Make gem-cd use the most recent gem, not the oldest
Make install-command honor .gemrc switches (#666)
Make hist with no parameters show just the current session's history (#205)
- hist --all shows older history
Make -s/--super flag of show-source/show-doc work when method name is being inferred from context (#877)
Rename --installed-plugins flag to --plugins
Strip ANSI codes from prompt before measuring length for indentation (#493)
Fix bug in edit regarding recognition of file names without suffix.
Reduced download size by removing tests etc. from distributed gem.

Dev-facing changes

CommandSet#commands, sometimes referenced through Pry.commands.commands, renamed to CommandSet#to_hash. It returns a duplicate of the internal hash a CommandSet uses.
CommandSet#keys is now an alias of CommandSet#list_commands.
All commands should now reference configuration values via _pry_.config (local) and not Pry.config (global). (#1096)
- This change improves support for concurrent environments and context-specific Pry sessions. _pry_.config inherits default values from Pry.config but can override them locally.
rake pry now accepts switches prefixed with _ (e.g., rake pry _v)
Pagers now act like IOs and accept streaming output
- See _pry_.pager.page and _pry_.pager.open.
The Pry class has been broken up into two smaller classes.
- Pry represents non-UI-specific session state, including the eval string
- Pry::REPL controls the user-facing interface
- This should make it easier to drive Pry from alternative interfaces
- Pry.start now has a :driver option that defaults to Pry::REPL
- This involved a lot of refactoring and may break plugins that depend on the old layout
Add ColorPrinter subclass of PP for colorized object inspection
Add [] and []= methods to CommandSet, which find and replace commands
- Example: Pry.commands["help"] = MyHelpCommand
The completion API has been refactored (see fdb703a8de4ef3)
Pry.config.input_stack (and the input stack concept in general) no longer exists
There's a new Pry::Terminal class that implements a number of different methods of determining the terminal's dimensions
Add ReplTester class for high-level simulation of Pry sessions in tests
Add Pry.main. Returns the special instance of Object referenced by self of TOPLEVEL_BINDING: "main".
Changed second argument of Pry.view_clip() from Fixnum to Hash to support returning a string with or without a hex representation of object ID. (#1162)
The output and pager objects will now strip color-codes, so commands should always print in color.
Commands now have a state hash that is persistent across invocations of the command in the same pry session.

0.9.12.6 (2014/01/28)

Don't fail if Bond is not installed (#1106)

0.9.12.5 (2014/01/27)

Fix early readline errors by deferring require of readline (#1081, #1095)

0.9.12.4 (2013/11/23)

Fix issue with Coderay colors being black, even when on a black background (#1016)

0.9.12.3 (2013/09/11)

Bump Coderay dependency (#987)
Fix consecutive newlines in heredocs being collapsed (#962)
Fix pager not working in JRuby > 1.7.5 (#992)

0.9.12.2 (2013/05/10)

Make reload-code with no args reload "current" file (#920)

0.9.12.1 (2013/04/21)

Add workaround for JRuby crashing bug (#890)
- Related to http://jira.codehaus.org/browse/JRUBY-7114

0.9.12 (2013/02/12)

Features

pry --gem (see 19bfc13aa)
show-source now works on commands created with create_command
whereami now has -m (method), -c (class), and -f (file) options
show-source now falls back to superclass (and displays warning) if it can't find class code
show-source/show-doc now indicate when -a option is available

Bug fixes, etc.

Fix commands breaking due to Slop looking at ARGV instead of command parameters (#828)
Fix pager breaking in some situations (#845)
Fix broken rendering of some docs (#795)
Silence warnings during failed tab-completion attempts
Fix broken prompt when prompt is colored (#822 / #823)
Added reload-method as alias for reload-code (for backwards compatibility)
Reopen Readline.output if it is not a tty (see 1538bc0990)

0.9.11.4 (2013/01/20)

Fix pager not rendering color codes in some circumstances
Add Pry.last_internal_error, useful for devs debugging commands

0.9.11.3 (2013/01/17)

Fix Pry.run_command
Improve ls output
Add :requires_gem => "jist" to gist command (so dependencies can be installed via install-command)
Improve help for edit command

0.9.11.2 (2013/01/16)

Fix minor bug in gist on Windows: rescue Jist::ClipboardError rather than letting the scary error spill out to users and potentially having them think the gist didn't post.

0.9.11.1 (2013/01/16)

Fix minor bug in gist command where I neglected to remove a call to a non-existent method (no_arg) which was called when gist is invoked with no parameters

0.9.11 (2013/01/16)

Dependency changes

Upgrade slop to ~> 3.4
New optional dependency: bond
- You'll need to perform gem install bond
- It improves autocompletion if you use Readline
- Does not work for libedit (More info: https://github.com/pry/pry/wiki/FAQ#wiki-readline)
- Big thanks to cldwalker

Features

Basic Ruby 2.0 support (#738)
JRuby 1.7.0+ support (#732)
New reload-code command
- Reload code for methods, classes, commands, objects and so on
- Examples: reload-code MyClass, reload-code my_method, reload-code my_obj
Bond tab completion (see "Dependency changes")
Consolidate "show" commands into show-source
- show-source can now extract source for:
  - Classes
  - Methods
  - Procs
  - Pry commands
  - Arbitrary objects (it shows the source for the class of the object)
- As a result, show-command is now removed
gist, play, and save-file now infer object type without requiring flags
- Examples: play MyClass, play my_file.rb, play my_method
Consolidate editing commands into edit
- edit can now edit:
  - Files
  - Methods
  - Classes
  - Pry commands
- As a result, edit-method is now removed
- Examples: edit MyClass, edit my_file.rb, edit my_method
amend-line and play now properly indent code added to input buffer
Support for multiple require switches (pry -rubygems -r./a.rb) (#674)
Support for multiple exec switches (pry -e ':one' -e ':two')
Ability to customize the name displayed in the prompt (#695)
--patch switch for edit --ex command (#716)
Respect the $PAGER environment variable (#736)
disable-pry command (#497)
Two new hooks, before_eval and after_eval
Tab completion for Array#<tab> in show-source and show-doc
gem-install immediately requires gems
-l switch for ls command (displays local variables)
gem-open command
fix-indent command
Subcommands API
Public test API for plugin writers (see d1489a)
Tabular ls output
--no-line-numbers switch for whereami command
--lines switch for play command

Bug fixes, etc.

Use single escape instead of double in find-method (#652)
Fix blank string delimiters (#657)
Fix unwanted binding_impl_method local in scratch bindings (#622)
Fix edit-method -p changing constant lookup (#645)
Fix .pryrc loading twice when invoked from $HOME directory (#682)
Fix Pry not remembering initial pwd (#675)
Fix multiline object coloring (#717)
Fix show-method not supporting String::new notation (#719)
Fix whereami command not showing correct line numbers (#754)
Fix buggy Cucumber AST output (#751)
Fix while/until do loops indentation (#787)
Fix --no-plugins switch (#526)
Ensure all errors go to the error handler (#774)
Fix .pryrc loading with wrong __FILE__
Fix pager not working if less is not available
Fix ^D in nested REPL
Many small improvements to error message clarity and documentation formatting

0.9.10 (2012/07/04)

Dependency changes

Upgrade slop to version 3 (#561)
Switch from gist gem to jist (#590)
Upgrade method_source to 0.8

Features

Add --hist, -o and -k flags to gist command (#572)
Support show-source/show-doc on methods defined in class_eval (#584)
Support show-source/show-doc on gem methods defined in C (#585)
Add --disable-plugin and --select-plugin options (#596)
Allow cd - to switch between bindings (#597)
Add Pry.config.should_load_local_rc to turn off ./.pryrc (#612)
Allow running a file of Pry input with pry <file>
Support colours in ri command
Add before_eval hook
The prompt proc now gets a lot more data when its arity is 1

Bug fixes, etc.

Removed the req command (#554)
Fix rendering bugs when starting Pry (#567)
Fix Array#pretty_print on Jruby (#568)
Fix edit on Windows (#575)
Fix find-method in the presence of badly behaved objects (#576)
Fix whereami in ERb files on Rails (#580)
Raise fewer exceptions while tab completing (#632)
Don't immediately quit Pry when an error happens in Readline (#605)
Support for ansicon to give JRuby Windows users colour (#606)
Massive speed improvements to show-source for modules (#613)
Improve whereami command when not in a binding.pry (#620)
Support embedded documents (=begin ... =end) (#622)
Support editing files with spaces in the name (#627)
Renamed __binding_impl__ to __pry__
Support for absolute paths in $EDITOR
Fix cat command on files with unknown extensions
Many, many internal refactorings and tidyings

0.9.9.6 (2012/05/09)

Fix ZeroDivisionError in correct_indentation (#558)

0.9.9.5 (2012/05/09)

Fix ZeroDivisionError in correct_indentation (#558)
Fix double highlighting in RDoc (#562)
Automatically create configuration for plugins (#548)

0.9.9.4 (2012/04/26)

Fix NoMethodError: undefined method winsize' for #<IO:>` (#549)
Fixes for JRuby
Fix syntax error on exit (550)
Heredoc content no longer auto-indented

0.9.9.3 (2012/04/19)

Fix show-doc failing on some core classes, like Bignum

0.9.9.2 (2012/04/18)

Make correct_indentation's auto-colorization respect Pry.color

0.9.9.1 (2012/04/18)

Clear up confusion in show-source/show-doc docs
- -a switch applies to classes as well as modules

0.9.9 (2012/04/18)

New features

Lines of input are syntax highlighted upon Enter keypress
show-source command can now show class/module source code
- Use -a to see all monkeypatches
- Hard dependency on ruby18_source_location gem in MRI 1.8
show-doc command can now show class/module docs
- Use -a to see docs for all monkeypatches
- Hard dependency on ruby18_source_location gem in MRI 1.8
New find-method command
- Performs a recursive search in a namespace for the existence of methods
- Can find methods whose names match a regex or methods which contain provided code
- This command is like a ruby-aware grep, very cool (thanks swarley)
pry-coolline now works properly
alias_command method now much more powerful
- Example: alias_command "lM", "ls -M"
whereami is now more intelligent
- Automatically shows entire source code of current method if current context is a method (thanks robgleeson)
New raise-up command
- Allows you to raise an exception that will bubble out of pry (ending the session) and escape into enclosing program

Bug fixes, etc.

Fixed crash when paging under Windows
Lines ending with \ are incomplete (kudos to fowl)
edit-method -n no longer blocks (thanks misfo)
Show instance methods of modules by default in ls
Docs for REPL-defined methods can now be displayed using show-doc
Autoload ruby18_source_location on MRI 1.8, when available
- See https://github.com/conradirwin/ruby18_source_location
Tab completion should work on first line now (historic bug fixed)
:quiet => true option added to Pry.start, turns off whereami
Another easter egg added
Show unloaded constants in yellow for ls
Improved documentation for Pry.config options
Improved auto-indentation
JRuby: heuristics used to clean up ls output
- Fewer internal methods polluting output

0.9.8.4 (2012/6/3)

~/.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

0.9.8.3 (2012/3/2)

various tweaks to improve rbx support
commands now support optional block arguments
much improved help command
updated method_source dependency
added wtf command
jruby should now work in windows (though without color)

0.9.8.2 (2012/2/9)

fixed bugs related to --super
upgraded slop dependency
added edit -c (edit current line)
edit now respects Pry.config.disable_autoreload option

0.9.8.1 (2012/1/30)

fixed broken --no-plugins option
Ensure ARGV is not mutated during option parsing.
Use a more rbx-friendly test for unicodeness
Use rbx-{18,19}mode as indicated http://about.travis-ci.org/docs/user/languages/ruby/
Don't explode in gem-list [Fixes #453, #454]
Check for command-name collision on assignment [Fixes #450]

0.9.8 (2012/1/25)

MAJOR NEW FEATURES

upgraded command api, https://github.com/pry/pry/wiki/Custom-commands
added a system of hooks for customizing pry behaviour
changed syntax checking to use eval() for improved accuracy
added save-file command
added gist command (removed gist-method, new gist command is more general)

complete CHANGELOG:

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'
show-doc now supports -l and -b options (line numbers)
play now supports -i and -d options
moved UserCommandAPI command-set to pry-developer_tools plugin
added :when_started event for hooks, called in Pry.start
added a man page
added rename method to Pry::CommandSet (commands can be renamed)
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 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
fixed edge cases in Pry::Method, for methods with crazy names and methods that have been 'undef'd
refactored history handling code for clarity and correctness
added Pry::WrappedModule as a counterpart to Pry::Method
made a trailing , cause pry to wait for further input
removed gist-method command, added gist command
added pry-backtrace command to show history of current session
fixed whereami within 'super' methods
replaced inline version guards by Pry::Helpers::BaseHelpers.{rbx?,jruby?,windows?} etc.
removed the CommandProcessor, its functionality is part of the new Command class
changed cd .. at the top level so it doesn't quit pry.
changed edit-command to no-longer need a command set argument
fixed empty lines so that they don't replace _ by nil
fixed SyntaxErrors at the REPL level so they don't replace ex.

0.9.7.4 (2011/11/5)

ls -M now works in modules (bugfix)
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

0.9.7.3 (2011/10/28)

really fixed indentation for 'super if' and friends
Fixed indentation for tmux
added Pry.config.correct_indent option (to toggle whether indentation
corrected optional param behaviour for method signatures: e.g Signature meth(param1=?, param2=?)

0.9.7.2 (2011/10/27)

fixed indentation for 'super if' and 'ensure', 'next if', etc
refactored Pry#run_command so it can accept an eval_string parameter (so amend-line and so on can work with it)
changed ^D so it no longer resets indent level automatically

0.9.7.1 (2011/10/26)

fixed gem dependency issues

0.9.7 (2011/10/25)

MAJOR NEW FEATURES:

upgraded ls command to have a more intuitive interface
added automatic indentation (thanks YorickPeterse!)
added Pry::Method wrapper class to encapsulate method-related functionality

complete CHANGELOG:

fixed syntax highlighting for object literals
fixed ActiveSupport method-naming conflict with "in?"
added --super option to edit-method, show-method, and friends - making it easier to operate on superclass methods
officially added edit --in to open previous expressions in an editor
whereami now works for REPL-defined code
started using JRuby parser for input validation in JRuby (thanks pangloss!)
fixed bug where ~/.pryrc could be loaded more than once (thanks kelseyjudson!)
added parse_options! helper to pull option parsing out of commands
Pry now respects the terminal's input encoding
moved some requires out of the startup process for improved speed
added input_array info to DEFAULT_PROMPT, e.g [1] pry(main)>
added --no-history option to pry binary (prevent history being LOADED, history will still be saved)

0.9.6.2 (2011/9/27)

downgrading to CodeRay 0.9.8 due to problems with 1.0 and rails (autoloading problem) see #280 on pry and #6 on CodeRay
also added (as a minor feature) cirwin's implementation of edit --in
added early break/exit for objectpath errors (the 'cd 34/@hello/bad_path/23')

0.9.6 (2011/9/19)

restored previous behavior of command-line switches (allowing "-rfilename")
removed -p option (--play) from edit command
edit with no arguments now edits the current or most recent expression
edit auto-reloads .rb files (need to specify -n to suppress)
added -p option (--patch) to edit-method command, which allows monkeypatching methods without touching the original file
edit-method can now edit REPL-defined methods
cat --ex now works on exceptions in REPL-defined code
play -m now uses eval_string.replace()
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 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
now injecting target_self method into command scope
play now performs 'show-input' always unless eval_string contains a valid expression (i.e it's about to be eval'd)
play and hist --replay now push the current input object onto the input_stack before redirecting input to a StringIO (works much better with pry-remote now)

0.9.5 (2011/9/8)

MAJOR NEW FEATURES:

JRuby support, including show-method/edit-method and editor integration on both 1.8 and 1.9 versions
extended cd syntax: cd ../@x/y
play command now works much better with in array (this is a very powerful feature, esp with Pry::NAV_PROMPT)
history saving/loading is now lightning fast
'edit' (entered by itself) now opens current lines in input buffer in an editor, and evals on exit
'edit' command is also, in general more intelligent
ls output no longer in array format, and colors can be configured, e.g: Pry.config.ls.ivar_color = :bright_blue
new switch-to command for moving around the binding stack without exiting out of sessions
more sophisticated prompts, Pry::NAV_PROMPT to ease deep spelunking of code
major bug fix for windows systems
much better support for huge objects, should no longer hang pry (see #245)
cat --ex and edit --ex now work better

complete CHANGELOG:

tempfile should end in .rb (for edit -t)
ls output should not be in array format
fix history saving (should not save all of Readline::HISTORY, but only what changed)
prevent blank lines going to Readline::HISTORY (thanks cirwin!)
ensure that cat --ex emulates the whereami format - includes line numbers and formatted the same, etc
fixed bug #200 ( pry#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 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 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
can no longer interpolate command name itself e.g #{x}-#{y} where x = "show" and y = "doc"
^C no longer captured
got rid of Pry.active_instance, Pry.last_exception and friends.
also special locals now shared among bindings in a pry instance (i.e ex (and friends) re-injected into new binding entered with 'cd')
renamed inp and out to in and out (to avoid collisions with actual locals in debugging scope)
added third parameter to prompts, the pry instance itself (_pry) see pry#233 for why it's important
cd behaviour when no args performs the same as cd /
commands with keep_retval can now return nil (to suppress output now return 'void' instead)
Pry::CommandProcessor::Result introduced
Pry.view_clip() modified to be more robust and properly display Class#name
edit command when invoked with no args now works like edit -t
when edit is invoked (with no args or with -t) inside a multi-line expression input buffer, it dumps that buffer into a temp file and takes you to it
got rid of Pry#null_input? since all that was needed was eval_string.empty?
cd command now supports complex syntax: cd ../@y/y/../z
JRuby is no longer a 2nd class citizen, almost full JRuby support, passing 100% tests
added Pry::NAV_PROMPT (great new navigation prompt, per robgleeson) and Pry::SIMPLE_PRINT for simple (IRB-style) print output (just using inspect)
pry now passed as 3rd parameter to :before_session hook
ls colors now configurable via Pry.config.ls.local_var_color = :bright_red etc
ls separator configurable via, e.g Pry.config.ls.separator = " "
Pry.view_clip() now only calls inspect on a few immediates, otherwise uses the #<> syntax, which has been truncated further to exclude teh mem address, again related to #245

0.9.3 (2011/7/27)

cat --ex (cats 5 lines above and below line in file where exception was raised)
edit --ex (edits line in file where exception was raised)
edit -t (opens a temporary file and evals it in current context when closed)
pry -r requires now happen after plugin loading (so as not to interfere with
new Pry.config.disable_auto_reload option, for turning off auto reloading by edit-method and related (thanks ryanf)
add better error messages for cd command
fixed exotic object regression - BasicObject.new etc now return "=> unknown"
added reload-method command (reloads the associated file of a method)
converted: import => import-set, version => pry-version, install => install-command
Pry.config.command_prefix support (thanks ryanf!)
fixed indentation for simple-prompt
hist command now excludes last line of input (the command invocation itself)
hist now has history alias
missing plugins no longer raise exception, just print a warning to $stderr
fixed jedit editor support

0.9.2 (2011/6/21)

fixed string interpolation bug (caused valid ruby code not to execute, sorry!)
fixed ls command, so it can properly display members of Object and classes, and BasicObject, etc
added a few git related commands to experimental command set, blame and diff

0.9.0 (2011/6/17)

plugin system
regex commands
show-method works on methods defined in REPL
new command system/API
rubinius core support
more backports to ruby 1.8
inp/out special locals
ex backtrace navigation object (ex.line, ex.file)
readline history saving/loading
prompt stack
more hooks
amend-line
play
show-input
edit
much more comprehensive test suite
support for new and old rubygems API
changed -s behaviour of ls (now excludes Object methods)
removed eval-file, lls, lcd, and a few other commands

0.7.6.1 (2011/3/26)

added slightly better support for YARD
now @param and @return tags are colored green and markdown code is syntax highlighted using coderay

0.7.6 (2011/3/26)

whereami command now accepts parameter AROUND, to display AROUND lines on eitherside of invocation line.
made it so whereami is invoked even if no method exists in current context (i.e in rspec tests)
added rubinius support for whereami invocation in HOOKS by checking for unknown.rb rather than just

0.7.0 (2011/3/15)

add pry-doc support with syntax highlighting for docs
add 'mj' option to ls (restrict to singleton methods)
add ex local to hold last exception raised in an exception

0.6.8 (2011/3/6)

add whereami command, a la the ir_b gem
make whereami run at the start of every session
make .pryrc be loaded by run-time pry sessions

0.6.7 (2011/3/4)

color support
--simple-prompt for pry commandline
-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 command.

0.6.3 (2011/2/28)

Using MethodSource 0.3.4 so 1.8 show-method support provided
Set class added to list of classes that are inspected

0.6.1 (2011/2/26)

!@ command alias for exit_all
cd / for breaking out to pry top level (jump-to 0)
made -e option work in a more effective way for pry command line invocation
exit and exit-all commands now accept a parameter, this parameter becomes the return value of repl()
command method from CommandBase now accepts a :keep_retval arg that determines if command value is returned to pry session or just nil (nil was old behaviour)
tests for new :keep_retval and exit-all/exit behaviour; :keep_retval will remain undocumented.

0.5.8 (2011/2/22)

Added -c (context) option to show-doc, show-methods and eval-file
Fixed up ordering issue of -c and -r parameters to command line pry

0.5.7 (2011/2/21)

Added pry executable, auto-loads .pryrc in user's home directory, if it exists.

0.5.5 (2011/2/19)

Added Pry.run_command
More useful error messages
Easter eggs (game and cohen-poem)

0.5.0 (2011/2/17)

Use clipped version of Pry.view() for large objects
Exit Pry session on ^d
Use Shellwords for breaking up parameters to pry commands
Use OptionParser to parse options for default pry commands
Add version command
Refactor 'status' command: add current method info
Add meth_name_from_binding utility lambda to commands.rb
Add -M, -m, -v(erbose), -a(ll), -s(uper), -l(ocals), -i(ivars), -k(klass vars), etc options to ls
add -M(instance method) options to show-method and show-doc
add --help option to most commands
Get rid of ls_method and ls_imethods (subsumed by more powerful ls)
Get rid of show_idoc and show_imethod
Add special eval-file command that evals target file in current context

0.4.5 (2011/1/27)

fixed show_method (though fragile as it references binding_impl directly, making a name change to that method difficult

0.4.4 (2011/1/27)

oops, added examples/ directory

0.4.3 (2011/1/26)

added alias_command and desc methods to Pry::CommandBase
changed behaviour of ls_methods and ls_imethods to return sorted lists of methods

0.4.1 (2011/1/23)

made it so a 'def meth;end' in an object Pry session defines singleton methods, not methods on the class (except in the case of immediates)
reorganized documentation, moving customization to a separate wiki file
storing wiki in a nested git repo, as github wiki pages have their own repo
added more tests for new method definition behaviour

0.4.0 (2011/1/21)

added command API
added many new commands, i.e ls_methods and friends
modified other commands
now accepts greater customization, can modify: input, output, hooks, prompt, print object
added tab completion (even completes commands)
added extensive tests
added examples
many more changes

0.1.3 (2010/12/9)

Got rid of rubygems dependency, refactored some code.

0.1.2 (2010/12/8)

now rescuing SyntaxError as well as Racc::Parser error in valid_expression?

0.1.0 (2010/12/8)

release!

Files

CHANGELOG.md

Latest commit

History

CHANGELOG.md

File metadata and controls

master

Features

API changes

Deprecations

Breaking changes

Bug fixes

v0.12.2 (November 12, 2018)

Bug fixes

v0.12.1 (November 12, 2018)

Bug fixes

v0.12.0 (November 5, 2018)

Major changes

Features

API changes

Breaking changes

Deprecations

Bug fixes

Other changes

0.11.3

Features

Bug fixes

0.11.0

0.10.1

0.10.0

Features

Dependency changes

Bug fixes, etc.

Dev-facing changes

0.9.12.6 (2014/01/28)

0.9.12.5 (2014/01/27)

0.9.12.4 (2013/11/23)

0.9.12.3 (2013/09/11)

0.9.12.2 (2013/05/10)

0.9.12.1 (2013/04/21)

0.9.12 (2013/02/12)

Features

Bug fixes, etc.

0.9.11.4 (2013/01/20)

0.9.11.3 (2013/01/17)

0.9.11.2 (2013/01/16)

0.9.11.1 (2013/01/16)

0.9.11 (2013/01/16)

Dependency changes

Features

Bug fixes, etc.

0.9.10 (2012/07/04)

Dependency changes

Features

Bug fixes, etc.

0.9.9.6 (2012/05/09)

0.9.9.5 (2012/05/09)

0.9.9.4 (2012/04/26)

0.9.9.3 (2012/04/19)

0.9.9.2 (2012/04/18)

0.9.9.1 (2012/04/18)

0.9.9 (2012/04/18)

New features

Bug fixes, etc.

0.9.8.4 (2012/6/3)

0.9.8.3 (2012/3/2)

0.9.8.2 (2012/2/9)

0.9.8.1 (2012/1/30)

0.9.8 (2012/1/25)

0.9.7.4 (2011/11/5)

0.9.7.3 (2011/10/28)

0.9.7.2 (2011/10/27)

0.9.7.1 (2011/10/26)

0.9.7 (2011/10/25)

0.9.6.2 (2011/9/27)

0.9.6 (2011/9/19)

0.9.5 (2011/9/8)

0.9.3 (2011/7/27)

0.9.2 (2011/6/21)

0.9.0 (2011/6/17)