Class: Pry::Command::AmendLine

Inherits:
Pry::ClassCommand show all
Defined in:
lib/pry/commands/amend_line.rb

Constant Summary

Constants inherited from Pry::Command

VOID_VALUE

Constants included from Helpers::Text

Helpers::Text::COLORS

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, #hooks, #output, #target

Instance Method Summary collapse

Methods inherited from Pry::ClassCommand

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

Methods inherited from Pry::Command

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

Methods included from Pry::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

Methods included from Helpers::Text

#bold, #default, #indent, #no_color, #no_pager, #strip_color, #with_line_numbers

Methods included from Helpers::CommandHelpers

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

Methods included from Helpers::OptionsHelpers

#method_object, method_object, #method_options, method_options

Methods included from Helpers::BaseHelpers

#colorize_code, #command_dependencies_met?, #find_command, #heading, #highlight, #not_a_real_file?, #safe_send, #silence_warnings, #stagger_output, #use_ansi_codes?

Methods included from Platform

#jruby?, #jruby_19?, #known_engines, #linux?, #mac_osx?, #mri?, #mri_19?, #mri_2?, #rbx?, #windows?, #windows_ansi?

Constructor Details

This class inherits a constructor from Pry::Command

Instance Method Details

#amended_input(string) ⇒ String (private)

Returns A new string with the amendments applied to it.

Parameters:

  • string (String)

    The string to amend.

Returns:

  • (String)

    A new string with the amendments applied to it.



31
32
33
34
35
36
37
38
39
40
41
42
43
# File 'lib/pry/commands/amend_line.rb', line 31

def amended_input(string)
  input_array = eval_string.each_line.to_a

  if arg_string == "!"
    delete_from_array(input_array, line_range)
  elsif arg_string.start_with?(">")
    insert_into_array(input_array, line_range)
  else
    replace_in_array(input_array, line_range)
  end

  input_array.join
end

#delete_from_array(array, range) ⇒ Object (private)



45
46
47
# File 'lib/pry/commands/amend_line.rb', line 45

def delete_from_array(array, range)
  array.slice!(range)
end

#insert_into_array(array, range) ⇒ Object (private)



49
50
51
52
# File 'lib/pry/commands/amend_line.rb', line 49

def insert_into_array(array, range)
  insert_slot = Array(range).first
  array.insert(insert_slot, arg_string[1..-1] << "\n")
end

#line_countFixnum (private)

Returns The number of lines currently in eval_string (the input buffer).

Returns:

  • (Fixnum)

    The number of lines currently in eval_string (the input buffer).



59
60
61
# File 'lib/pry/commands/amend_line.rb', line 59

def line_count
  eval_string.lines.count
end

#line_rangeRange, Fixnum (private)

The lines (or line) that will be modified by the amend-line.

Returns:

  • (Range, Fixnum)

    The lines or line.



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

def line_range
  start_line_number, end_line_number = start_and_end_line_number
  if start_line_number
    zero_indexed_range_from_one_indexed_numbers(start_line_number,
                                                end_line_number)
  else
    line_count - 1
  end
end

#processObject

Raises:



19
20
21
22
23
24
25
# File 'lib/pry/commands/amend_line.rb', line 19

def process
  raise CommandError, "No input to amend." if eval_string.empty?

  eval_string.replace amended_input(eval_string)
  run "fix-indent"
  run "show-input"
end

#replace_in_array(array, range) ⇒ Object (private)



54
55
56
# File 'lib/pry/commands/amend_line.rb', line 54

def replace_in_array(array, range)
  array[range] = arg_string + "\n"
end

#start_and_end_line_numberArray<Fixnum>? (private)

Returns the (one-indexed) start and end lines given by the user. The lines in this range will be affected by the amend-line. Returns nil if no lines were specified by the user.

Returns:

  • (Array<Fixnum>, nil)


67
68
69
70
71
72
# File 'lib/pry/commands/amend_line.rb', line 67

def start_and_end_line_number
  start_line_number, end_line_number = args
  end_line_number ||= start_line_number.to_i

  [start_line_number.to_i, end_line_number.to_i] if start_line_number
end

#zero_indexed_range_from_one_indexed_numbers(start_line_number, end_line_number) ⇒ Range (private)

Takes two numbers that are 1-indexed, and returns a range (or number) that is 0-indexed. 1-indexed means the first element is indentified by 1 rather than by 0 (as is the case for Ruby arrays).

Parameters:

  • start_line_number (Fixnum)

    One-indexed number.

  • end_line_number (Fixnum)

    One-indexed number.

Returns:

  • (Range)

    The zero-indexed range.



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

def zero_indexed_range_from_one_indexed_numbers(start_line_number, end_line_number)
  # FIXME: one_index_number is a horrible name for this method
  one_index_number(start_line_number)..one_index_number(end_line_number)
end