17"""Internal functions for working with frame-filters."""
26def get_priority(filter_item):
27 """Internal worker function to return the frame-filter's priority
28 from a frame filter object. This is a fail free function as it is
29 used in sorting and filtering. If a badly implemented frame
30 filter does not implement the priority attribute, return zero
31 (otherwise sorting/filtering will fail and prevent other frame
32 filters from executing).
35 filter_item: An object conforming to the frame filter
39 The priority of the frame filter from the "priority"
44 return getattr(filter_item,
"priority", 0)
47def set_priority(filter_item, priority):
48 """Internal worker function to set the frame-filter's priority.
51 filter_item: An object conforming to the frame filter
53 priority: The priority to assign as an integer.
56 filter_item.priority = priority
59def get_enabled(filter_item):
60 """Internal worker function to return a filter's enabled state
61 from a frame filter object. This is a fail free function as it is
62 used in sorting and filtering. If a badly implemented frame
63 filter does not implement the enabled attribute, return False
64 (otherwise sorting/filtering will fail and prevent other frame
65 filters from executing).
68 filter_item: An object conforming to the frame filter
72 The enabled state of the frame filter from the "enabled"
79 return getattr(filter_item,
"enabled",
False)
82def set_enabled(filter_item, state):
83 """Internal Worker function to set the frame-filter's enabled
87 filter_item: An object conforming to the frame filter
89 state: True or False, depending on desired state.
92 filter_item.enabled = state
96 """Internal Worker function to return the frame filter
97 dictionary, depending on the name supplied as an argument. If the
98 name is not "all", "global" or "progspace", it is assumed to name
102 name: The name of the list, as specified by GDB user commands.
105 A dictionary object for a single specified dictionary, or a
106 list containing all the items for "all"
109 gdb.GdbError: A dictionary of that name cannot be found.
118 glob = gdb.frame_filters.values()
120 return_iter = itertools.chain(glob, prog)
122 return_iter = itertools.chain(return_iter, objfile.frame_filters.values())
127 return gdb.frame_filters
129 if name ==
"progspace":
131 return cp.frame_filters
134 if name == objfile.filename:
135 return objfile.frame_filters
137 msg =
"Cannot find frame-filter dictionary for '" + name +
"'"
138 raise gdb.GdbError(msg)
142 """Internal Worker function to merge all known frame-filter
143 lists, prune any filters with the state set to "disabled", and
144 sort the list on the frame-filter's "priority" attribute.
147 sorted_list: A sorted, pruned list of frame filters to
151 all_filters = return_list(
"all")
152 sorted_frame_filters = sorted(all_filters, key=get_priority, reverse=
True)
154 sorted_frame_filters = filter(get_enabled, sorted_frame_filters)
156 return sorted_frame_filters
162def _frame_iterator(frame, frame_low, frame_high, dap_semantics):
164 sorted_list = list(_sort_list())
168 if not dap_semantics
and len(sorted_list) == 0:
171 frame_iterator = FrameIterator(frame)
176 decorator = DAPFrameDecorator
178 decorator = FrameDecorator
179 frame_iterator = map(decorator, frame_iterator)
181 for ff
in sorted_list:
182 frame_iterator = ff.filter(frame_iterator)
189 slice_length = abs(frame_low)
192 sliced = collections.deque()
194 for frame_item
in frame_iterator:
195 if count >= slice_length:
198 sliced.append(frame_item)
210 frame_high = frame_high + 1
212 sliced = itertools.islice(frame_iterator, frame_low, frame_high)
217def frame_iterator(frame, frame_low, frame_high):
218 """Helper function that will execute the chain of frame filters.
219 Each filter is executed in priority order. After the execution
220 completes, slice the iterator to frame_low - frame_high range. An
221 iterator is always returned. The iterator will always yield
222 frame decorator objects, but note that these decorators have
223 slightly different semantics from the ordinary ones: they will
224 always return a fully-qualified 'filename' (if possible) and will
225 never substitute the objfile name.
228 frame: The initial frame.
230 frame_low: The low range of the slice, counting from 0. If
231 this is a negative integer then it indicates a backward slice
232 (ie bt -4) which counts backward from the last frame in the
235 frame_high: The high range of the slice, inclusive. If this
236 is -1 then it indicates all frames until the end of the stack
240 frame_iterator: The sliced iterator after all frame
241 filters have had a chance to execute.
244 return _frame_iterator(frame, frame_low, frame_high,
True)
247def execute_frame_filters(frame, frame_low, frame_high):
248 """Internal function called from GDB that will execute the chain
249 of frame filters. Each filter is executed in priority order.
250 After the execution completes, slice the iterator to frame_low -
254 frame: The initial frame.
256 frame_low: The low range of the slice, counting from 0. If
257 this is a negative integer then it indicates a backward slice
258 (ie bt -4) which counts backward from the last frame in the
261 frame_high: The high range of the slice, inclusive. If this
262 is -1 then it indicates all frames until the end of the stack
266 frame_iterator: The sliced iterator after all frame
267 filters have had a chance to execute, or None if no frame
268 filters are registered.
272 return _frame_iterator(frame, frame_low, frame_high,
False)