- Configure
code
as a supported editor on Pry::Editor (#2236) - Added support for Ruby 3.2 (#2263)
- Added support for Ruby 3.1 (#2228)
- Short circuit eval regexes in finding module definition (#2253)
- Revert "Escape non-printing characters" (#2235)
- Fixed bug where WeirdMethodLocator would fail to find the source of a method breaking whereami (#2244)
- Fixed bug where pry would throw an FrozenError when dealing with incomplete tokens (#2136)
- Restore --no-history CLI flag functionality (#2196)
- Fixed bug where reading from the
_out_
sticky local variable could return wrong results (#2201)
- Remove support for Ruby 1.9 and JRuby < 9.0 (#2239)
v0.14.1 (April 12, 2021)
- Fixed bad coloring of some RDoc-style docs (#2182)
- Fixed broken
--plugins
option. It shows a warning now (#2180) - Fixed bad output on printing non-visible characters with color codes (#2154)
- Fixed bad output when colors are disabled and a string with color codes is printed (#2158)
v0.14.0 (February 8, 2021)
- Made
?
an alias toshow-source -d
(#2133) - Added support for Ruby 3.0
-
Deleted support for plugin autoloading (#2119). In order to load a Pry plugin you must
require
it from yourpryrc
or add it to your Gemfile.# ~/.pryrc require 'pryrc'
v0.13.1 (April 12, 2020)
- Fixed bug where on invalid input only the last syntax error is displayed (instead of all of them) (#2117)
- Fixed
Pry::Config
raisingNoMethodError
on undefined option instead of returningnil
(usually invoked viaPry.config.foo_option
calls) (#2126) - Fixed
help
command not displaying regexp aliases properly (#2120) - Fixed
pry-backtrace
not working (#2122)
v0.13.0 (March 21, 2020)
- 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 topryrc
(#2027) - Added the
--code
flag to thewtf
command, which shows code for each backtrace frame (#2037) - Added the ability to paste method call chains with leading dots (#2060)
Pry::Prompt
is a class now and it can be instantiated to create new prompts on the fly that are not registered withPry::Prompt#add
. Learn more about its API in the docs (#1877)
-
Deprecated
Pry.config.exception_whitelist
in favor ofPry.config.unrescued_exceptions
(#1874) -
Deprecated
Pry.config.prompt = Pry::Prompt[:simple][:value]
in favor ofPry.config.prompt = Pry::Prompt[:simple]
when setting Pry prompt viapryrc
.Pry::Prompt[:simple]
would return an instance ofPry::Prompt
instead ofHash
(#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. Theshow-source -d
is the new recommended way of reading docs (#1934) -
Deprecated
Pry::Command#_pry_
. UsePry::Command#pry_instance
instead (#1989)
- 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 asmac_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
andshow-command
(#2001) - Deleted
Pry::Command#disabled_commands
(#2001) - Deleted
Pry::BlockCommand#opts
(use#context
instead) (#2003) - Deleted
Pry.lazy
(usePry::Config::LazyValue
instead) (#2024)
- Fixed bug where using
Pry.config.prompt_name
can return aPry::Config::Lazy
instead of expected instance ofString
(#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 customoutput
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) - Fixed the
$SAFE will become a normal global variable in Ruby 3.0
warning on Ruby 2.7 (#2107) - Fixed bug when
whereami -c
cannot show beginning of the class, which is on the same line as another expression (#2098) - Fixed bug when
Object#owner
is defined, which results into somewhat broken method introspection (#2113) - Fixed bug when indentation leaves parts of input after pressing enter when Readline is enabled with mode indicators for vi mode. This was supposed to be fixed in v0.12.2 but it regressed (#2114)
v0.12.2 (November 12, 2018)
- Restore removed deprecations, which were removed by accident due to a bad rebase.
v0.12.1 (November 12, 2018)
- 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)
- Dropped support for Rubinius (#1785)
-
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
. Usechange-prompt simple
instead. Thelist-prompt
command was removed and embedded aschange-prompt --list
(#1849)
-
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, onlyconfig.prompt_name
supports it (#1833) -
Pry::Prompt
responds to.[]
,.all
&.add
now. ThePry::Prompt.add
method must be used for implementing custom prompts. See the API in the documentation for the class (#1846)
- Deleted the
Pry::Helpers::Text.bright_default
alias forPry::Helpers::Text.bold
(#1795) Pry::Helpers.tablify_to_screen_width(things, options, config = Pry.config)
requiresoptions
ornil
in place of them.Pry::Helpers::Table.new(items, args, config = Pry.config)
requiresargs
ornil
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
(usePry::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 notnil
)
- It's been renamed to
- Renamed
Pry.config.prompt_safe_objects
toPry.config.prompt_safe_contexts
- Removed deprecated
Pry::CommandSet#before_command
&Pry::CommandSet#after_command
(#1838)
- 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 fromBaseHelpers
andCommandHelpers
) (#1701) - Deprecated
_pry_.input_array
&_pry_.output_array
in favour of_pry_.input_ring
and_pry_.output_ring
respectively (#1817) - Deprecated
Pry::Platform
. UsePry::Helpers::Platform
instead. Note thatPry::Helpers::BaseHelpers
still includes thePlatform
methods but emits a warning. You must switch toPry::Helpers::Platform
in your code (#1838, (#1845)) - Deprecated
Pry::Prompt::MAP
. You should usePry::Prompt.all
instead to access the same map (#1846)
- Fixed a bug where
cd Hash.new
reportedself
as an instance of Pry::Config in the prompt (#1725) - Silenced the
Could not find files for the given pattern(s)
error message coming fromwhere
on Windows, whenless
or another pager is not installed (#1767) - Fixed possible double loading of Pry plugins'
cli.rb
on Ruby (>= 2.4) due to therealpath
changes while invokingrequire
(#1762, #1774) - Fixed
NoMethodError
on code objects that have a comment but no source when invokingshow-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 redefinemethod_missing
andrespond_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)
- Deprecated the
Data
constant to match Ruby 2.5 in thels
command (#1731)
- 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?
andlinux?
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.
- 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
andno_paging
, for performance reasons. Improve the documentation of both methods.
See pull request #1691.
- Fix
String#pp
output color.
See pull request #1674.
- 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.
- Deprecated constants are hidden from
- 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 (withPry.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 ownPry::Config::Default
class.(#1503) - Lazy load the config defaults for
Pry.config.history
andPry.config.gist
.
- Fix bugs with jruby
- Move to rspec for testing (from bacon)
- Clean up ruby warnings
- 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
- See
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
.
- Windows JRuby users who don't want warnings about ansicon can set
- 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.
- Remove dependency on
ffi
gem on JRuby (#1158) - Remove optional dependency on Bond (#1166)
- Bond support has been extracted to the
pry-bond
plugin
- Bond support has been extracted to the
- 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.
- The
gem-install
command can require gems likenet-ssh
thanks to better logic for guessing what path to require. (#1188) toggle-color
command toggles the local_pry_.color
setting instead of the globalPry.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 anddisable_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 ofshow-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.
CommandSet#commands
, sometimes referenced throughPry.commands.commands
, renamed toCommandSet#to_hash
. It returns a duplicate of the internal hash a CommandSet uses.CommandSet#keys
is now an alias ofCommandSet#list_commands
.- All commands should now reference configuration values via
_pry_.config
(local) and notPry.config
(global). (#1096)- This change improves support for concurrent environments and
context-specific Pry sessions.
_pry_.config
inherits default values fromPry.config
but can override them locally.
- This change improves support for concurrent environments and
context-specific Pry sessions.
rake pry
now accepts switches prefixed with_
(e.g.,rake pry _v
)- Pagers now act like
IO
s and accept streaming output- See
_pry_.pager.page
and_pry_.pager.open
.
- See
- The
Pry
class has been broken up into two smaller classes.Pry
represents non-UI-specific session state, including the eval stringPry::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 toPry::REPL
- This involved a lot of refactoring and may break plugins that depend on the old layout
- Add
ColorPrinter
subclass ofPP
for colorized object inspection - Add
[]
and[]=
methods toCommandSet
, which find and replace commands- Example:
Pry.commands["help"] = MyHelpCommand
- Example:
- 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 ofTOPLEVEL_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
andpager
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.
- Don't fail if Bond is not installed (#1106)
- Fix early readline errors by deferring require of readline (#1081, #1095)
- Fix issue with Coderay colors being black, even when on a black background (#1016)
- Bump Coderay dependency (#987)
- Fix consecutive newlines in heredocs being collapsed (#962)
- Fix pager not working in JRuby > 1.7.5 (#992)
- Make
reload-code
with no args reload "current" file (#920)
- Add workaround for JRuby crashing bug (#890)
- Related to http://jira.codehaus.org/browse/JRUBY-7114
pry --gem
(see 19bfc13aa)show-source
now works on commands created withcreate_command
whereami
now has-m
(method),-c
(class), and-f
(file) optionsshow-source
now falls back to superclass (and displays warning) if it can't find class codeshow-source
/show-doc
now indicate when-a
option is available
- 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 forreload-code
(for backwards compatibility) - Reopen
Readline.output
if it is not a tty (see 1538bc0990)
- Fix pager not rendering color codes in some circumstances
- Add
Pry.last_internal_error
, useful for devs debugging commands
- Fix
Pry.run_command
- Improve
ls
output - Add
:requires_gem => "jist"
togist
command (so dependencies can be installed viainstall-command
) - Improve help for
edit
command
- Fix minor bug in
gist
on Windows: rescueJist::ClipboardError
rather than letting the scary error spill out to users and potentially having them think the gist didn't post.
- Fix minor bug in
gist
command where I neglected to remove a call to a non-existent method (no_arg
) which was called whengist
is invoked with no parameters
- 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
- You'll need to perform
- 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
, andsave-file
now infer object type without requiring flags- Examples:
play MyClass
,play my_file.rb
,play my_method
- Examples:
- 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
andplay
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 foredit --ex
command (#716)- Respect the
$PAGER
environment variable (#736) disable-pry
command (#497)- Two new hooks,
before_eval
andafter_eval
- Tab completion for
Array#<tab>
inshow-source
andshow-doc
gem-install
immediately requires gems-l
switch forls
command (displays local variables)gem-open
commandfix-indent
command- Subcommands API
- Public test API for plugin writers (see d1489a)
- Tabular
ls
output --no-line-numbers
switch forwhereami
command--lines
switch forplay
command
- 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 supportingString::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
- Upgrade
slop
to version 3 (#561) - Switch from
gist
gem tojist
(#590) - Upgrade
method_source
to 0.8
- Add
--hist
,-o
and-k
flags togist
command (#572) - Support
show-source
/show-doc
on methods defined inclass_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
- 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 abinding.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
- Fix
ZeroDivisionError
incorrect_indentation
(#558)
- Fix
ZeroDivisionError
incorrect_indentation
(#558) - Fix double highlighting in RDoc (#562)
- Automatically create configuration for plugins (#548)
- Fix
NoMethodError: undefined method
winsize' for #<IO:>` (#549) - Fixes for JRuby
- Fix syntax error on
exit
(550) - Heredoc content no longer auto-indented
- Fix
show-doc
failing on some core classes, likeBignum
- Make
correct_indentation
's auto-colorization respectPry.color
- Clear up confusion in
show-source
/show-doc
docs-a
switch applies to classes as well as modules
- 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
- Use
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
- Use
- 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 properlyalias_command
method now much more powerful- Example:
alias_command "lM", "ls -M"
- Example:
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
- 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 - Tab completion should work on first line now (historic bug fixed)
:quiet => true
option added toPry.start
, turns offwhereami
- 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
- ~/.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
- 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)
- fixed bugs related to --super
- upgraded slop dependency
- added edit -c (edit current line)
- edit now respects Pry.config.disable_autoreload option
- 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]
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.
- 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
- 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=?)
- 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
- fixed gem dependency issues
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)
- 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')
- 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 expressionedit
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)
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
- 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
- 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
- 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
- added slightly better support for YARD
- now @param and @return tags are colored green and markdown
code
is syntax highlighted using coderay
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
- 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
- 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
- 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.
- Using MethodSource 0.3.4 so 1.8 show-method support provided
Set
class added to list of classes that are inspected
- !@ 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 forpry
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 justnil
(nil
was old behaviour)- tests for new :keep_retval and exit-all/exit behaviour; :keep_retval will remain undocumented.
- 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
- Added pry executable, auto-loads .pryrc in user's home directory, if it exists.
- Added Pry.run_command
- More useful error messages
- Easter eggs (game and cohen-poem)
- 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
- fixed show_method (though fragile as it references binding_impl directly, making a name change to that method difficult
- oops, added examples/ directory
- added alias_command and desc methods to Pry::CommandBase
- changed behaviour of ls_methods and ls_imethods to return sorted lists of methods
- 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
- 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
- Got rid of rubygems dependency, refactored some code.
- now rescuing SyntaxError as well as Racc::Parser error in valid_expression?
- release!