/pry-full

Get up and going with a good set of pry tools right away.

Primary LanguageRubyOtherNOASSERTION

pry-full

Get up and going with a good set of pry tools right away.

Dependent Gems

pry-doc

Allows you to look into the Ruby builtin classes with the ? and $ commands.

  • ? [].pop

  • $ [].pop

  • …etc.

pry-docmore

Shows docs for dollar-vars and keywords

  • show-docmores

  • ? module

  • ? $`

pry-debugger

An essential gem. Turns Pry into a steppable debugger.

  • Making the basic "require'pry';binding.pry" from a script come alive.

  • In conjunction with plymouth or pry-rescue, to explore failing tests.

  • Following calls into other libs.

pry-stack_explorer

Allows you to navigate the call stack.

  • So many. TODO = document some.

pry-rescue

Provides Pry.rescue do … end to capture any exceptions and start pry from the context of the source of the exception.

  • Shortens write-run-debug cycles when exceptions are involved.

  • Exploring causes of hard-to-replicate exceptions.

  • cd-cause to source of exceptions in code run within Pry

  • Rescues on test failure via require of pry-rescue/minitest and pry-rescue/rspec

bond

An excellent tabcompletion gem. Having this dep enables new Pry stuff. Note that pry v0.9.10 doesn't have this feature, so you must use a repo version.

  • require 'x<tab>

  • {asdf: 1, hjkl: 2}[:a<tab>

  • Chain.of.calls.<tab> # Old pry completion was generic in this case.

jist

Replacement for the undermaintained gist gem.

  • Improved implementation for Pry's gist command.

  • Check out the jist -h output on the CLI, by the way.

pry-theme

Alternative syntax highlighting.

  • Being more snazzy

  • Making pry more like your editor, so you can scan more easily.

pry-pretty-numeric

A very simple, but nice, plugin. Turns 12345689 into 12_345_689 on output (Which is legal Ruby input).

  • Any time you have big numbers.

pry-syntax-hacks

Cirwin's wild bag of tricks. The caveat is that it's pretty wild and tricky - especially since input with @s can get rewritten as an instance_variable_get. Still, this is only a matter of understanding the dialect used, and adapting accordingly.

  • Direct member access; User.new.@secret_password

  • Calling private methods; User.new.!hash_password('foo')

  • Accessing Pry outer bindings; cd (a = Object.new) then puts ../a

pry-highlight

Reformat strings with pretty-printing. Auto-detects JSON/XML/Ruby.

  • After a method produces ugly XML, do ">>" by itself to see it prettied.

  • Pass in the string as an arg, e.g., >> '{"a":1}'

  • Pass in any Ruby as an arg, >> File.read("/var/www/foo.html")

pry-editline

Pop the current line into a text editor. In tpope's words, "Whenever I'm using IRB or Pry, my editor always feels too far away. Yes, there are [ways to] spawn an editor and evaluate the result, but that's not what I need. Usually I'm about 80 characters or so into a hairy one-liner when I think, "you know, I really wish I was in Vim right about now." In Bash, one can load the current command line into an editor with C-x C-e. And now, you can do so in IRB and Pry."

  • Ctrl+x, Ctrl+e or Ctrl+o (if in Emacs mode or Vi Insert Mode)

  • v or o (if in Vi Normal Mode)

pry-git

Method-level git commands.

  • Blame/diff a specific method.

pry-developer_tools

Mostly for Pry/Pry Plugin development, but can be useful interactively.

  • define-command 'r', 'rerun' do run 'history --replay -1' end

  • reload-command show-method

  • edit-command show-method

  • edit-command -p show-method

awesome_print

Not a Pry plugin, but a useful tool, still.

  • Gnarly objects. ap the_gnarly_obj