Class: Pry::WrappedModule::Candidate

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Includes:
CodeObject::Helpers, Helpers::DocumentationHelpers
Defined in:
lib/pry/wrapped_module/candidate.rb

Overview

This class represents a single candidate for a module/class definition. It provides access to the source, documentation, line and file for a monkeypatch (reopening) of a class/module.

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Forwardable

def_private_delegators

Methods included from CodeObject::Helpers

#c_method?, #c_module?, #command?, #module_with_yard_docs?, #real_method_object?

Methods included from Helpers::DocumentationHelpers

#get_comment_content, get_comment_content, #process_comment_markup, process_comment_markup, #process_rdoc, process_rdoc, #process_yardoc, process_yardoc, #process_yardoc_tag, process_yardoc_tag, #strip_comments_from_c_code, strip_comments_from_c_code, #strip_leading_whitespace, strip_leading_whitespace

Constructor Details

#initialize(wrapper, rank) ⇒ Candidate

Returns a new instance of Candidate

Parameters:

  • wrapper (Pry::WrappedModule)

    The associated Pry::WrappedModule instance that owns the candidates.

  • rank (Fixnum)

    The rank of the candidate to retrieve. Passing 0 returns 'primary candidate' (the candidate with largest number of methods), passing 1 retrieves candidate with second largest number of methods, and so on, up to Pry::WrappedModule#number_of_candidates() - 1

Raises:



39
40
41
42
43
44
45
46
47
48
49
50
51
# File 'lib/pry/wrapped_module/candidate.rb', line 39

def initialize(wrapper, rank)
  @wrapper = wrapper

  if number_of_candidates <= 0
    raise CommandError, "Cannot find a definition for #{name} module!"
  elsif rank > (number_of_candidates - 1)
    raise CommandError, "No such module candidate. Allowed candidates range is from 0 to #{number_of_candidates - 1}"
  end

  @source = @source_location = nil
  @rank = rank
  @file, @line = source_location
end

Instance Attribute Details

#fileString (readonly) Also known as: source_file

Returns The file where the module definition is located.

Returns:

  • (String)

    The file where the module definition is located.



15
16
17
# File 'lib/pry/wrapped_module/candidate.rb', line 15

def file
  @file
end

#lineFixnum (readonly) Also known as: source_line

Returns The line where the module definition is located.

Returns:

  • (Fixnum)

    The line where the module definition is located.



19
20
21
# File 'lib/pry/wrapped_module/candidate.rb', line 19

def line
  @line
end

Instance Method Details

#class_regexesObject (private)



98
99
100
101
102
103
# File 'lib/pry/wrapped_module/candidate.rb', line 98

def class_regexes
  mod_type_string = wrapped.class.to_s.downcase
  [/^\s*#{mod_type_string}\s+(?:(?:\w*)::)*?#{wrapped.name.split(/::/).last}/,
   /^\s*(::)?#{wrapped.name.split(/::/).last}\s*?=\s*?#{wrapped.class}/,
   /^\s*(::)?#{wrapped.name.split(/::/).last}\.(class|instance)_eval/]
end

#docString

Returns The documentation for the candidate.

Returns:

  • (String)

    The documentation for the candidate.

Raises:



65
66
67
68
# File 'lib/pry/wrapped_module/candidate.rb', line 65

def doc
  return nil if file.nil?
  @doc ||= get_comment_content(Pry::Code.from_file(file).comment_describing(line))
end

#first_line_of_module_definition(file, line) ⇒ Fixnum (private)

Locate the first line of the module definition.

Parameters:

  • file (String)

    The file that contains the module definition (somewhere).

  • line (Fixnum)

    The module definition should appear before this line (if it exists).

Returns:

  • (Fixnum)

    The line where the module is defined. This line number is one-indexed.



93
94
95
96
# File 'lib/pry/wrapped_module/candidate.rb', line 93

def first_line_of_module_definition(file, line)
  searchable_lines = lines_for_file(file)[0..(line - 2)]
  searchable_lines.rindex { |v| class_regexes.any? { |r| r =~ v } } + 1
end

#first_method_source_locationArray (private)

This method is used by Candidate#source_location as a starting point for the search for the candidate's definition.

Returns:

  • (Array)

    The source location of the base method used to calculate the source location of the candidate.



109
110
111
# File 'lib/pry/wrapped_module/candidate.rb', line 109

def first_method_source_location
  @first_method_source_location ||= method_candidates[@rank].first.source_location
end

#last_method_source_locationArray (private)

Returns The source location of the last method in this candidate's module definition.

Returns:

  • (Array)

    The source location of the last method in this candidate's module definition.



115
116
117
# File 'lib/pry/wrapped_module/candidate.rb', line 115

def last_method_source_location
  @end_method_source_location ||= method_candidates[@rank].last.source_location
end

#number_of_lines_in_first_chunkFixum (private)

Return the number of lines between the start of the class definition and the start of the last method. We use this value so we can quickly grab these lines from the file (without having to check each intervening line for validity, which is expensive) speeding up source extraction.

Returns:

  • (Fixum)

    Number of lines.



124
125
126
127
128
# File 'lib/pry/wrapped_module/candidate.rb', line 124

def number_of_lines_in_first_chunk
  end_method_line = last_method_source_location.last

  end_method_line - line
end

#sourceString

Returns The source for the candidate, i.e the complete module/class definition.

Returns:

  • (String)

    The source for the candidate, i.e the complete module/class definition.

Raises:



56
57
58
59
60
61
# File 'lib/pry/wrapped_module/candidate.rb', line 56

def source
  return nil if file.nil?
  return @source if @source

  @source ||= strip_leading_whitespace(Pry::Code.from_file(file).expression_at(line, number_of_lines_in_first_chunk))
end

#source_locationArray?

Returns A [String, Fixnum] pair representing the source location (file and line) for the candidate or nil if no source location found.

Returns:

  • (Array, nil)

    A [String, Fixnum] pair representing the source location (file and line) for the candidate or nil if no source location found.



73
74
75
76
77
78
79
80
81
82
# File 'lib/pry/wrapped_module/candidate.rb', line 73

def source_location
  return @source_location if @source_location

  file, line = first_method_source_location
  return nil if !file.is_a?(String)

  @source_location = [file,  first_line_of_module_definition(file, line)]
rescue Pry::RescuableException
  nil
end