class Pry::ObjectPath

`ObjectPath` implements the resolution of “object paths”, which are strings that are similar to filesystem paths but meant for traversing Ruby objects. Examples of valid object paths include:

x
@foo/@bar
"string"/upcase
Pry/Method

Object paths are mostly relevant in the context of the `cd` command. @see github.com/pry/pry/wiki/State-navigation

Constants

SPECIAL_TERMS

Public Class Methods

new(path_string, current_stack) click to toggle source

@param [String] path_string The object path expressed as a string. @param [Array<Binding>] current_stack The current state of the binding

stack.
# File lib/pry/object_path.rb, line 19
def initialize(path_string, current_stack)
  @path_string   = path_string
  @current_stack = current_stack
end

Public Instance Methods

resolve() click to toggle source

@return [Array<Binding>] a new stack resulting from applying the given

path to the current stack.
# File lib/pry/object_path.rb, line 26
def resolve
  scanner = StringScanner.new(@path_string.strip)
  stack   = @current_stack.dup

  begin
    next_segment  = ""

    loop do
      # Scan for as long as we don't see a slash
      next_segment << scanner.scan(/[^\/]*/)

      if complete?(next_segment) || scanner.eos?
        scanner.getch # consume the slash
        break
      else
        next_segment << scanner.getch # append the slash
      end
    end

    case next_segment.chomp
    when ""
      stack = [stack.first]
    when "::"
      stack.push(TOPLEVEL_BINDING)
    when "."
      next
    when ".."
      stack.pop unless stack.size == 1
    else
      stack.push(Pry.binding_for(stack.last.eval(next_segment)))
    end
  rescue RescuableException => e
    return handle_failure(next_segment, e)
  end until scanner.eos?

  stack
end