mirror of
https://github.com/pry/pry.git
synced 2022-11-09 12:35:05 -05:00
37 KiB
37 KiB
HEAD
- Improve Ruby 2.4 support:
- 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::Lazy
to make it easier to reimplementPry::Config::Default
without knowing its implementation #1503 - Lazy load the config defaults for
Pry.config.history
andPry.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
- 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.
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
- 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.
Bug fixes, etc.
- 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.
Dev-facing changes
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
fdb703a8de
) 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.
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
(see19bfc13aa
)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
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 forreload-code
(for backwards compatibility) - Reopen
Readline.output
if it is not a tty (see1538bc0990
)
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"
togist
command (so dependencies can be installed viainstall-command
) - Improve help for
edit
command
0.9.11.2 (2013/01/16)
- 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.
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 whengist
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
- You'll need to perform
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
, 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
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 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
0.9.10 (2012/07/04)
Dependency changes
- Upgrade
slop
to version 3 (#561) - Switch from
gist
gem tojist
(#590) - Upgrade
method_source
to 0.8
Features
- 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
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 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
0.9.9.6 (2012/05/09)
- Fix
ZeroDivisionError
incorrect_indentation
(#558)
0.9.9.5 (2012/05/09)
- Fix
ZeroDivisionError
incorrect_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, likeBignum
0.9.9.2 (2012/04/18)
- Make
correct_indentation
's auto-colorization respectPry.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
- 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
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 - 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
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 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)
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 ( 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 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 https://github.com/pry/pry/issues/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 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.
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!