Class: Pry::Command::ShowInfo

Inherits:
Pry::ClassCommand show all
Extended by:
Helpers::BaseHelpers
Defined in:
lib/pry/commands/show_info.rb

Direct Known Subclasses

ShowDoc, ShowSource

Constant Summary

Constants inherited from Pry::Command

VOID_VALUE

Instance Attribute Summary

Attributes inherited from Pry::ClassCommand

#args, #opts

Attributes inherited from Pry::Command

#_pry_, #arg_string, #captures, #command_block, #command_set, #context, #eval_string, #output, #target

Instance Method Summary collapse

Methods included from Helpers::BaseHelpers

colorize_code, command_dependencies_met?, find_command, heading, highlight, jruby?, jruby_19?, mri?, mri_19?, mri_20?, mri_21?, mri_2?, not_a_real_file?, rbx?, safe_send, safe_send, silence_warnings, stagger_output, use_ansi_codes?, windows?, windows_ansi?

Methods inherited from Pry::ClassCommand

#call, doc, #help, inherited, #setup, #slop, source, source_file, source_line, source_location, #subcommands

Methods inherited from Pry::Command

banner, #block, #call_safely, #check_for_command_collision, #command_name, command_name, #command_options, command_regex, #commands, convert_to_regex, default_options, #dependencies_met?, #description, doc, group, hooks, #initialize, inspect, #interpolate_string, #match, match_score, matches?, name, #name, options, #process_line, #run, #source, source, source_file, source_line, source_location, #source_location, #state, subclass, #target_self, #text, #tokenize, #void

Methods included from Pry::CodeObject::Helpers

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

Methods included from Helpers::DocumentationHelpers

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

Methods included from Helpers::CommandHelpers

absolute_index_number, absolute_index_range, command_error, get_method_or_raise, internal_binding?, one_index_number, one_index_range, one_index_range_or_number, restrict_to_lines, set_file_and_dir_locals, temp_file, unindent

Methods included from Helpers::OptionsHelpers

method_object, method_options

Constructor Details

This class inherits a constructor from Pry::Command

Instance Method Details

#code_object_header(code_object, line_num) ⇒ Object


97
98
99
100
101
102
103
104
105
106
107
108
# File 'lib/pry/commands/show_info.rb', line 97

def code_object_header(code_object, line_num)
  if code_object.real_method_object?
    method_header(code_object, line_num)

    # It sucks we have to test for both Pry::WrappedModule and WrappedModule::Candidate,
    # probably indicates a deep refactor needs to happen in those classes.
  elsif code_object.is_a?(Pry::WrappedModule) || code_object.is_a?(Pry::WrappedModule::Candidate)
    module_header(code_object, line_num)
  else
    ""
  end
end

#code_object_with_accessible_source(code_object) ⇒ Pry::WrappedModule, ...

This method checks whether the `code_object` is a WrappedModule, if it is, then it returns the first candidate (monkeypatch) with accessible source (or docs). If `code_object` is not a WrappedModule (i.e a method or a command) then the `code_object` itself is just returned.


40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
# File 'lib/pry/commands/show_info.rb', line 40

def code_object_with_accessible_source(code_object)
  if code_object.is_a?(WrappedModule)
    candidate = code_object.candidates.find(&:source)
    if candidate
      return candidate
    else
      raise CommandError, no_definition_message if !valid_superclass?(code_object)

      @used_super = true
      code_object_with_accessible_source(code_object.super)
    end
  else
    code_object
  end
end

#complete(input) ⇒ Object


179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
# File 'lib/pry/commands/show_info.rb', line 179

def complete(input)
  if input =~ /([^ ]*)#([a-z0-9_]*)\z/
    prefix, search = [$1, $2]
    methods = begin
                Pry::Method.all_from_class(binding.eval(prefix))
              rescue RescuableException
                return super
              end
    methods.map do |method|
      [prefix, method.name].join('#') if method.name.start_with?(search)
    end.compact
  else
    super
  end
end

#content_and_header_for_code_object(code_object) ⇒ Object


60
61
62
# File 'lib/pry/commands/show_info.rb', line 60

def content_and_header_for_code_object(code_object)
  header(code_object) << content_for(code_object)
end

#content_and_headers_for_all_module_candidates(mod) ⇒ Object


64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
# File 'lib/pry/commands/show_info.rb', line 64

def content_and_headers_for_all_module_candidates(mod)
  result = "Found #{mod.number_of_candidates} candidates for `#{mod.name}` definition:\n"
  mod.number_of_candidates.times do |v|
    candidate = mod.candidate(v)
    begin
      result << "\nCandidate #{v+1}/#{mod.number_of_candidates}: #{candidate.source_file} @ line #{candidate.source_line}:\n"
      content = content_for(candidate)

      result << "Number of lines: #{content.lines.count}\n\n" << content
    rescue Pry::RescuableException
      result << "\nNo content found.\n"
      next
    end
  end
  result
end

#file_and_line_for(code_object) ⇒ Object

takes into account possible yard docs, and returns yard_file / yard_line Also adjusts for start line of comments (using start_line_for), which it has to infer by subtracting number of lines of comment from start line of code_object


171
172
173
174
175
176
177
# File 'lib/pry/commands/show_info.rb', line 171

def file_and_line_for(code_object)
  if code_object.module_with_yard_docs?
    [code_object.yard_file, code_object.yard_line]
  else
    [code_object.source_file, start_line_for(code_object)]
  end
end

#header(code_object) ⇒ Object

Generate a header (meta-data information) for all the code object types: methods, modules, commands, procs…


87
88
89
90
91
92
93
94
95
# File 'lib/pry/commands/show_info.rb', line 87

def header(code_object)
  file_name, line_num = file_and_line_for(code_object)
  h = "\n#{Pry::Helpers::Text.bold('From:')} #{file_name} "
  h << code_object_header(code_object, line_num)
  h << "\n#{Pry::Helpers::Text.bold('Number of lines:')} " <<
    "#{content_for(code_object).lines.count}\n\n"
  h << Helpers::Text.bold('** Warning:') << " Cannot find code for #{@original_code_object.nonblank_name}. Showing superclass #{code_object.nonblank_name} instead. **\n\n" if @used_super
  h
end

#header_optionsObject


140
141
142
143
144
145
146
# File 'lib/pry/commands/show_info.rb', line 140

def header_options
  {
    :owner => true,
    :visibility => true,
    :signature => nil
  }
end

#method_header(code_object, line_num) ⇒ Object


110
111
112
113
114
115
116
117
# File 'lib/pry/commands/show_info.rb', line 110

def method_header(code_object, line_num)
  h = ""
  h << (code_object.c_method? ? "(C Method):" : "@ line #{line_num}:")
  h << method_sections(code_object)[:owner]
  h << method_sections(code_object)[:visibility]
  h << method_sections(code_object)[:signature]
  h
end

#method_sections(code_object) ⇒ Object


132
133
134
135
136
137
138
# File 'lib/pry/commands/show_info.rb', line 132

def method_sections(code_object)
  {
    :owner => "\n#{text.bold("Owner:")} #{code_object.owner || "N/A"}\n",
    :visibility => "#{text.bold("Visibility:")} #{code_object.visibility}",
    :signature => "\n#{text.bold("Signature:")} #{code_object.signature}"
  }.merge(header_options) { |key, old, new| (new && old).to_s }
end

#module_header(code_object, line_num) ⇒ Object


119
120
121
122
123
124
125
126
127
128
129
130
# File 'lib/pry/commands/show_info.rb', line 119

def module_header(code_object, line_num)
  h = ""
  h << "@ line #{line_num}:\n"
  h << text.bold(code_object.module? ? "Module" : "Class")
  h << " #{text.bold('name:')} #{code_object.nonblank_name}"

  if code_object.number_of_candidates > 1
    h << (text.bold("\nNumber of monkeypatches: ") << code_object.number_of_candidates.to_s)
    h << ". Use the `-a` option to display all available monkeypatches"
  end
  h
end

#no_definition_messageObject


81
82
83
# File 'lib/pry/commands/show_info.rb', line 81

def no_definition_message
  "Couldn't locate a definition for #{obj_name}!"
end

#obj_nameObject


152
153
154
# File 'lib/pry/commands/show_info.rb', line 152

def obj_name
  @obj_name ||= args.empty? ? nil : args.join(' ')
end

#options(opt) ⇒ Object


7
8
9
10
11
12
# File 'lib/pry/commands/show_info.rb', line 7

def options(opt)
  opt.on :s, :super, "Select the 'super' method. Can be repeated to traverse the ancestors", :as => :count
  opt.on :l, "line-numbers", "Show line numbers"
  opt.on :b, "base-one", "Show line numbers but start numbering at 1 (useful for `amend-line` and `play` commands)"
  opt.on :a, :all,  "Show all definitions and monkeypatches of the module/class"
end

#processObject

Raises:


14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
# File 'lib/pry/commands/show_info.rb', line 14

def process
  code_object = Pry::CodeObject.lookup(obj_name, _pry_, :super => opts[:super])
  raise CommandError, no_definition_message if !code_object
  @original_code_object = code_object

  if show_all_modules?(code_object)
    # show all monkey patches for a module

    result = content_and_headers_for_all_module_candidates(code_object)
  else
    # show a specific code object
    co = code_object_with_accessible_source(code_object)
    result = content_and_header_for_code_object(co)
  end

  set_file_and_dir_locals(code_object.source_file)
  _pry_.pager.page result
end

#show_all_modules?(code_object) ⇒ Boolean

Returns:

  • (Boolean)

148
149
150
# File 'lib/pry/commands/show_info.rb', line 148

def show_all_modules?(code_object)
  code_object.is_a?(Pry::WrappedModule) && opts.present?(:all)
end

#start_line_for(code_object) ⇒ Object


160
161
162
163
164
165
166
# File 'lib/pry/commands/show_info.rb', line 160

def start_line_for(code_object)
  if opts.present?(:'base-one')
    1
  else
    code_object.source_line || 1
  end
end

#use_line_numbers?Boolean

Returns:

  • (Boolean)

156
157
158
# File 'lib/pry/commands/show_info.rb', line 156

def use_line_numbers?
  opts.present?(:b) || opts.present?(:l)
end

#valid_superclass?(code_object) ⇒ Boolean

Returns:

  • (Boolean)

56
57
58
# File 'lib/pry/commands/show_info.rb', line 56

def valid_superclass?(code_object)
  code_object.super && code_object.super.wrapped != Object
end