Module: Debugger::FrameFunctions

Defined in:
lib/ruby-debug/commands/frame.rb

Overview

Mix-in module to assist in command parsing.

Instance Method Summary collapse

Instance Method Details

#adjust_frame(frame_pos, absolute, context = @state.context) ⇒ Object

:nodoc:



4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
 
# File 'lib/ruby-debug/commands/frame.rb', line 4

def adjust_frame(frame_pos, absolute, context=@state.context)
  @state.frame_pos = 0 if context != @state.context
  if absolute
    if frame_pos < 0
      abs_frame_pos = context.stack_size + frame_pos
    else
      abs_frame_pos = frame_pos
    end
  else
    abs_frame_pos = @state.frame_pos + frame_pos
  end

  if abs_frame_pos >= context.stack_size then
    errmsg "Adjusting would put us beyond the oldest (initial) frame.\n"
    return
  elsif abs_frame_pos < 0 then
    errmsg "Adjusting would put us beyond the newest (innermost) frame.\n"
    return
  end
  if @state.frame_pos != abs_frame_pos then
    @state.previous_line = nil
    @state.frame_pos = abs_frame_pos
  end
  
  @state.file = context.frame_file(@state.frame_pos)
  @state.line = context.frame_line(@state.frame_pos)
  
  print_frame(@state.frame_pos, true)
end

#get_frame_call(prefix, pos, context) ⇒ Object 



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
 
# File 'lib/ruby-debug/commands/frame.rb', line 34

def get_frame_call(prefix, pos, context)
  id = context.frame_method(pos)
  klass = context.frame_class(pos)
  call_str = ""
  if id
    args = context.frame_args(pos)
    locals = context.frame_locals(pos)
    if Command.settings[:callstyle] != :short && klass
      if Command.settings[:callstyle] == :tracked
        arg_info = context.frame_args_info(pos)
      end
      call_str << "#{klass}." 
    end
    call_str << id.id2name
    if args.any?
      call_str << "("
      args.each_with_index do |name, i|
        case Command.settings[:callstyle] 
        when :short
          call_str += "%s, " % [name]
        when :last
          klass = locals[name].class
          if klass.inspect.size > 20+3
            klass = klass.inspect[0..20]+"..." 
          end
          call_str += "%s#%s, " % [name, klass]
        when :tracked
          if arg_info && arg_info.size > i
            call_str += "#{name}: #{arg_info[i].inspect}, "
          else
            call_str += "%s, " % name
          end
        end
        if call_str.size > self.class.settings[:width] - prefix.size
          # Strip off trailing ', ' if any but add stuff for later trunc
          call_str[-2..-1] = ",...XX"
          break
        end
      end
      call_str[-2..-1] = ")" # Strip off trailing ', ' if any 
    end
  end
  return call_str
end

#print_frame(pos, adjust = false, context = @state.context) ⇒ Object 



79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
 
# File 'lib/ruby-debug/commands/frame.rb', line 79

def print_frame(pos, adjust = false, context=@state.context)
  file = context.frame_file(pos)
  line = context.frame_line(pos)
  klass = context.frame_class(pos)

  unless Command.settings[:full_path]
    path_components = file.split(/[\\\/]/)
    if path_components.size > 3
      path_components[0...-3] = '...'
      file = path_components.join(File::ALT_SEPARATOR || File::SEPARATOR)
    end
  end

  frame_num = "#%d " % pos
  call_str = get_frame_call(frame_num, pos, context)
  file_line = "at line %s:%d\n" % [CommandProcessor.canonic_file(file), line]
  print frame_num
  unless call_str.empty?
    print call_str
    print ' '
    if call_str.size + frame_num.size + file_line.size > self.class.settings[:width]
      print "\n       "
    end
  end
  print file_line
  if ENV['EMACS'] && adjust
    fmt = (Debugger.annotate.to_i > 1 ?
           "\032\032source %s:%d\n" : "\032\032%s:%d\n")
    print fmt % [CommandProcessor.canonic_file(file), line]
  end
end

#truncated_callstack?(context, sentinal = nil, cs = caller) ⇒ Boolean

Check if call stack is truncated. This can happen if Debugger.start is not called low enough in the call stack. An array of additional callstack lines from caller is returned if definitely truncated, false if not, and nil if we don’t know.

We determine truncation based on a passed in sentinal set via caller which can be nil.

First we see if we can find our position in caller. If so, then we compare context position to that in caller using sentinal as a place to start ignoring additional caller entries. sentinal is set by rdebug, but if it’s not set, i.e. nil then additional entries are presumably ones that we haven’t recorded in context

Returns:

  • (Boolean) 


124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
 
# File 'lib/ruby-debug/commands/frame.rb', line 124

def truncated_callstack?(context, sentinal=nil, cs=caller)
  recorded_size = context.stack_size
  to_find_fl = "#{context.frame_file(0)}:#{context.frame_line(0)}"
  top_discard = false
  cs.each_with_index do |fl, i|
    fl.gsub!(/in `.*'$/, '')
    fl.gsub!(/:$/, '')
    if fl == to_find_fl
      top_discard = i
      break 
    end
  end
  if top_discard
    cs = cs[top_discard..-1]
    return false unless cs
    return cs unless sentinal
    if cs.size > recorded_size+2 && cs[recorded_size+2] != sentinal 
      # caller seems to truncate recursive calls and we don't.
      # See if we can find sentinal in the first 0..recorded_size+1 entries
      return false if cs[0..recorded_size+1].any?{ |f| f==sentinal }
      return cs
    end
    return false
  end
  return nil
end