pry--pry/CHANGELOG.md

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)

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)

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 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 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 ( 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 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!