##// END OF EJS Templates
Merge pull request #12450 from meeseeksmachine/auto-backport-of-pr-12445-on-7.x...
Matthias Bussonnier -
r25906:e6fc538c merge
parent child Browse files
Show More
@@ -1,804 +1,811 b''
1 # -*- coding: utf-8 -*-
1 # -*- coding: utf-8 -*-
2 """
2 """
3 Pdb debugger class.
3 Pdb debugger class.
4
4
5 Modified from the standard pdb.Pdb class to avoid including readline, so that
5 Modified from the standard pdb.Pdb class to avoid including readline, so that
6 the command line completion of other programs which include this isn't
6 the command line completion of other programs which include this isn't
7 damaged.
7 damaged.
8
8
9 In the future, this class will be expanded with improvements over the standard
9 In the future, this class will be expanded with improvements over the standard
10 pdb.
10 pdb.
11
11
12 The code in this file is mainly lifted out of cmd.py in Python 2.2, with minor
12 The code in this file is mainly lifted out of cmd.py in Python 2.2, with minor
13 changes. Licensing should therefore be under the standard Python terms. For
13 changes. Licensing should therefore be under the standard Python terms. For
14 details on the PSF (Python Software Foundation) standard license, see:
14 details on the PSF (Python Software Foundation) standard license, see:
15
15
16 https://docs.python.org/2/license.html
16 https://docs.python.org/2/license.html
17 """
17 """
18
18
19 #*****************************************************************************
19 #*****************************************************************************
20 #
20 #
21 # This file is licensed under the PSF license.
21 # This file is licensed under the PSF license.
22 #
22 #
23 # Copyright (C) 2001 Python Software Foundation, www.python.org
23 # Copyright (C) 2001 Python Software Foundation, www.python.org
24 # Copyright (C) 2005-2006 Fernando Perez. <fperez@colorado.edu>
24 # Copyright (C) 2005-2006 Fernando Perez. <fperez@colorado.edu>
25 #
25 #
26 #
26 #
27 #*****************************************************************************
27 #*****************************************************************************
28
28
29 import bdb
29 import bdb
30 import functools
30 import functools
31 import inspect
31 import inspect
32 import linecache
32 import linecache
33 import sys
33 import sys
34 import warnings
34 import warnings
35 import re
35 import re
36
36
37 from IPython import get_ipython
37 from IPython import get_ipython
38 from IPython.utils import PyColorize
38 from IPython.utils import PyColorize
39 from IPython.utils import coloransi, py3compat
39 from IPython.utils import coloransi, py3compat
40 from IPython.core.excolors import exception_colors
40 from IPython.core.excolors import exception_colors
41 from IPython.testing.skipdoctest import skip_doctest
41 from IPython.testing.skipdoctest import skip_doctest
42
42
43
43
44 prompt = 'ipdb> '
44 prompt = 'ipdb> '
45
45
46 #We have to check this directly from sys.argv, config struct not yet available
46 #We have to check this directly from sys.argv, config struct not yet available
47 from pdb import Pdb as OldPdb
47 from pdb import Pdb as OldPdb
48
48
49 # Allow the set_trace code to operate outside of an ipython instance, even if
49 # Allow the set_trace code to operate outside of an ipython instance, even if
50 # it does so with some limitations. The rest of this support is implemented in
50 # it does so with some limitations. The rest of this support is implemented in
51 # the Tracer constructor.
51 # the Tracer constructor.
52
52
53 def make_arrow(pad):
53 def make_arrow(pad):
54 """generate the leading arrow in front of traceback or debugger"""
54 """generate the leading arrow in front of traceback or debugger"""
55 if pad >= 2:
55 if pad >= 2:
56 return '-'*(pad-2) + '> '
56 return '-'*(pad-2) + '> '
57 elif pad == 1:
57 elif pad == 1:
58 return '>'
58 return '>'
59 return ''
59 return ''
60
60
61
61
62 def BdbQuit_excepthook(et, ev, tb, excepthook=None):
62 def BdbQuit_excepthook(et, ev, tb, excepthook=None):
63 """Exception hook which handles `BdbQuit` exceptions.
63 """Exception hook which handles `BdbQuit` exceptions.
64
64
65 All other exceptions are processed using the `excepthook`
65 All other exceptions are processed using the `excepthook`
66 parameter.
66 parameter.
67 """
67 """
68 warnings.warn("`BdbQuit_excepthook` is deprecated since version 5.1",
68 warnings.warn("`BdbQuit_excepthook` is deprecated since version 5.1",
69 DeprecationWarning, stacklevel=2)
69 DeprecationWarning, stacklevel=2)
70 if et==bdb.BdbQuit:
70 if et==bdb.BdbQuit:
71 print('Exiting Debugger.')
71 print('Exiting Debugger.')
72 elif excepthook is not None:
72 elif excepthook is not None:
73 excepthook(et, ev, tb)
73 excepthook(et, ev, tb)
74 else:
74 else:
75 # Backwards compatibility. Raise deprecation warning?
75 # Backwards compatibility. Raise deprecation warning?
76 BdbQuit_excepthook.excepthook_ori(et,ev,tb)
76 BdbQuit_excepthook.excepthook_ori(et,ev,tb)
77
77
78
78
79 def BdbQuit_IPython_excepthook(self,et,ev,tb,tb_offset=None):
79 def BdbQuit_IPython_excepthook(self,et,ev,tb,tb_offset=None):
80 warnings.warn(
80 warnings.warn(
81 "`BdbQuit_IPython_excepthook` is deprecated since version 5.1",
81 "`BdbQuit_IPython_excepthook` is deprecated since version 5.1",
82 DeprecationWarning, stacklevel=2)
82 DeprecationWarning, stacklevel=2)
83 print('Exiting Debugger.')
83 print('Exiting Debugger.')
84
84
85
85
86 class Tracer(object):
86 class Tracer(object):
87 """
87 """
88 DEPRECATED
88 DEPRECATED
89
89
90 Class for local debugging, similar to pdb.set_trace.
90 Class for local debugging, similar to pdb.set_trace.
91
91
92 Instances of this class, when called, behave like pdb.set_trace, but
92 Instances of this class, when called, behave like pdb.set_trace, but
93 providing IPython's enhanced capabilities.
93 providing IPython's enhanced capabilities.
94
94
95 This is implemented as a class which must be initialized in your own code
95 This is implemented as a class which must be initialized in your own code
96 and not as a standalone function because we need to detect at runtime
96 and not as a standalone function because we need to detect at runtime
97 whether IPython is already active or not. That detection is done in the
97 whether IPython is already active or not. That detection is done in the
98 constructor, ensuring that this code plays nicely with a running IPython,
98 constructor, ensuring that this code plays nicely with a running IPython,
99 while functioning acceptably (though with limitations) if outside of it.
99 while functioning acceptably (though with limitations) if outside of it.
100 """
100 """
101
101
102 @skip_doctest
102 @skip_doctest
103 def __init__(self, colors=None):
103 def __init__(self, colors=None):
104 """
104 """
105 DEPRECATED
105 DEPRECATED
106
106
107 Create a local debugger instance.
107 Create a local debugger instance.
108
108
109 Parameters
109 Parameters
110 ----------
110 ----------
111
111
112 colors : str, optional
112 colors : str, optional
113 The name of the color scheme to use, it must be one of IPython's
113 The name of the color scheme to use, it must be one of IPython's
114 valid color schemes. If not given, the function will default to
114 valid color schemes. If not given, the function will default to
115 the current IPython scheme when running inside IPython, and to
115 the current IPython scheme when running inside IPython, and to
116 'NoColor' otherwise.
116 'NoColor' otherwise.
117
117
118 Examples
118 Examples
119 --------
119 --------
120 ::
120 ::
121
121
122 from IPython.core.debugger import Tracer; debug_here = Tracer()
122 from IPython.core.debugger import Tracer; debug_here = Tracer()
123
123
124 Later in your code::
124 Later in your code::
125
125
126 debug_here() # -> will open up the debugger at that point.
126 debug_here() # -> will open up the debugger at that point.
127
127
128 Once the debugger activates, you can use all of its regular commands to
128 Once the debugger activates, you can use all of its regular commands to
129 step through code, set breakpoints, etc. See the pdb documentation
129 step through code, set breakpoints, etc. See the pdb documentation
130 from the Python standard library for usage details.
130 from the Python standard library for usage details.
131 """
131 """
132 warnings.warn("`Tracer` is deprecated since version 5.1, directly use "
132 warnings.warn("`Tracer` is deprecated since version 5.1, directly use "
133 "`IPython.core.debugger.Pdb.set_trace()`",
133 "`IPython.core.debugger.Pdb.set_trace()`",
134 DeprecationWarning, stacklevel=2)
134 DeprecationWarning, stacklevel=2)
135
135
136 ip = get_ipython()
136 ip = get_ipython()
137 if ip is None:
137 if ip is None:
138 # Outside of ipython, we set our own exception hook manually
138 # Outside of ipython, we set our own exception hook manually
139 sys.excepthook = functools.partial(BdbQuit_excepthook,
139 sys.excepthook = functools.partial(BdbQuit_excepthook,
140 excepthook=sys.excepthook)
140 excepthook=sys.excepthook)
141 def_colors = 'NoColor'
141 def_colors = 'NoColor'
142 else:
142 else:
143 # In ipython, we use its custom exception handler mechanism
143 # In ipython, we use its custom exception handler mechanism
144 def_colors = ip.colors
144 def_colors = ip.colors
145 ip.set_custom_exc((bdb.BdbQuit,), BdbQuit_IPython_excepthook)
145 ip.set_custom_exc((bdb.BdbQuit,), BdbQuit_IPython_excepthook)
146
146
147 if colors is None:
147 if colors is None:
148 colors = def_colors
148 colors = def_colors
149
149
150 # The stdlib debugger internally uses a modified repr from the `repr`
150 # The stdlib debugger internally uses a modified repr from the `repr`
151 # module, that limits the length of printed strings to a hardcoded
151 # module, that limits the length of printed strings to a hardcoded
152 # limit of 30 characters. That much trimming is too aggressive, let's
152 # limit of 30 characters. That much trimming is too aggressive, let's
153 # at least raise that limit to 80 chars, which should be enough for
153 # at least raise that limit to 80 chars, which should be enough for
154 # most interactive uses.
154 # most interactive uses.
155 try:
155 try:
156 from reprlib import aRepr
156 from reprlib import aRepr
157 aRepr.maxstring = 80
157 aRepr.maxstring = 80
158 except:
158 except:
159 # This is only a user-facing convenience, so any error we encounter
159 # This is only a user-facing convenience, so any error we encounter
160 # here can be warned about but can be otherwise ignored. These
160 # here can be warned about but can be otherwise ignored. These
161 # printouts will tell us about problems if this API changes
161 # printouts will tell us about problems if this API changes
162 import traceback
162 import traceback
163 traceback.print_exc()
163 traceback.print_exc()
164
164
165 self.debugger = Pdb(colors)
165 self.debugger = Pdb(colors)
166
166
167 def __call__(self):
167 def __call__(self):
168 """Starts an interactive debugger at the point where called.
168 """Starts an interactive debugger at the point where called.
169
169
170 This is similar to the pdb.set_trace() function from the std lib, but
170 This is similar to the pdb.set_trace() function from the std lib, but
171 using IPython's enhanced debugger."""
171 using IPython's enhanced debugger."""
172
172
173 self.debugger.set_trace(sys._getframe().f_back)
173 self.debugger.set_trace(sys._getframe().f_back)
174
174
175
175
176 RGX_EXTRA_INDENT = re.compile(r'(?<=\n)\s+')
176 RGX_EXTRA_INDENT = re.compile(r'(?<=\n)\s+')
177
177
178
178
179 def strip_indentation(multiline_string):
179 def strip_indentation(multiline_string):
180 return RGX_EXTRA_INDENT.sub('', multiline_string)
180 return RGX_EXTRA_INDENT.sub('', multiline_string)
181
181
182
182
183 def decorate_fn_with_doc(new_fn, old_fn, additional_text=""):
183 def decorate_fn_with_doc(new_fn, old_fn, additional_text=""):
184 """Make new_fn have old_fn's doc string. This is particularly useful
184 """Make new_fn have old_fn's doc string. This is particularly useful
185 for the ``do_...`` commands that hook into the help system.
185 for the ``do_...`` commands that hook into the help system.
186 Adapted from from a comp.lang.python posting
186 Adapted from from a comp.lang.python posting
187 by Duncan Booth."""
187 by Duncan Booth."""
188 def wrapper(*args, **kw):
188 def wrapper(*args, **kw):
189 return new_fn(*args, **kw)
189 return new_fn(*args, **kw)
190 if old_fn.__doc__:
190 if old_fn.__doc__:
191 wrapper.__doc__ = strip_indentation(old_fn.__doc__) + additional_text
191 wrapper.__doc__ = strip_indentation(old_fn.__doc__) + additional_text
192 return wrapper
192 return wrapper
193
193
194
194
195 class Pdb(OldPdb):
195 class Pdb(OldPdb):
196 """Modified Pdb class, does not load readline.
196 """Modified Pdb class, does not load readline.
197
197
198 for a standalone version that uses prompt_toolkit, see
198 for a standalone version that uses prompt_toolkit, see
199 `IPython.terminal.debugger.TerminalPdb` and
199 `IPython.terminal.debugger.TerminalPdb` and
200 `IPython.terminal.debugger.set_trace()`
200 `IPython.terminal.debugger.set_trace()`
201 """
201 """
202
202
203 def __init__(self, color_scheme=None, completekey=None,
203 def __init__(self, color_scheme=None, completekey=None,
204 stdin=None, stdout=None, context=5, **kwargs):
204 stdin=None, stdout=None, context=5, **kwargs):
205 """Create a new IPython debugger.
205 """Create a new IPython debugger.
206
206
207 :param color_scheme: Deprecated, do not use.
207 :param color_scheme: Deprecated, do not use.
208 :param completekey: Passed to pdb.Pdb.
208 :param completekey: Passed to pdb.Pdb.
209 :param stdin: Passed to pdb.Pdb.
209 :param stdin: Passed to pdb.Pdb.
210 :param stdout: Passed to pdb.Pdb.
210 :param stdout: Passed to pdb.Pdb.
211 :param context: Number of lines of source code context to show when
211 :param context: Number of lines of source code context to show when
212 displaying stacktrace information.
212 displaying stacktrace information.
213 :param kwargs: Passed to pdb.Pdb.
213 :param kwargs: Passed to pdb.Pdb.
214 The possibilities are python version dependent, see the python
214 The possibilities are python version dependent, see the python
215 docs for more info.
215 docs for more info.
216 """
216 """
217
217
218 # Parent constructor:
218 # Parent constructor:
219 try:
219 try:
220 self.context = int(context)
220 self.context = int(context)
221 if self.context <= 0:
221 if self.context <= 0:
222 raise ValueError("Context must be a positive integer")
222 raise ValueError("Context must be a positive integer")
223 except (TypeError, ValueError):
223 except (TypeError, ValueError):
224 raise ValueError("Context must be a positive integer")
224 raise ValueError("Context must be a positive integer")
225
225
226 # `kwargs` ensures full compatibility with stdlib's `pdb.Pdb`.
226 # `kwargs` ensures full compatibility with stdlib's `pdb.Pdb`.
227 OldPdb.__init__(self, completekey, stdin, stdout, **kwargs)
227 OldPdb.__init__(self, completekey, stdin, stdout, **kwargs)
228
228
229 # IPython changes...
229 # IPython changes...
230 self.shell = get_ipython()
230 self.shell = get_ipython()
231
231
232 if self.shell is None:
232 if self.shell is None:
233 save_main = sys.modules['__main__']
233 save_main = sys.modules['__main__']
234 # No IPython instance running, we must create one
234 # No IPython instance running, we must create one
235 from IPython.terminal.interactiveshell import \
235 from IPython.terminal.interactiveshell import \
236 TerminalInteractiveShell
236 TerminalInteractiveShell
237 self.shell = TerminalInteractiveShell.instance()
237 self.shell = TerminalInteractiveShell.instance()
238 # needed by any code which calls __import__("__main__") after
238 # needed by any code which calls __import__("__main__") after
239 # the debugger was entered. See also #9941.
239 # the debugger was entered. See also #9941.
240 sys.modules['__main__'] = save_main
240 sys.modules['__main__'] = save_main
241
241
242 if color_scheme is not None:
242 if color_scheme is not None:
243 warnings.warn(
243 warnings.warn(
244 "The `color_scheme` argument is deprecated since version 5.1",
244 "The `color_scheme` argument is deprecated since version 5.1",
245 DeprecationWarning, stacklevel=2)
245 DeprecationWarning, stacklevel=2)
246 else:
246 else:
247 color_scheme = self.shell.colors
247 color_scheme = self.shell.colors
248
248
249 self.aliases = {}
249 self.aliases = {}
250
250
251 # Create color table: we copy the default one from the traceback
251 # Create color table: we copy the default one from the traceback
252 # module and add a few attributes needed for debugging
252 # module and add a few attributes needed for debugging
253 self.color_scheme_table = exception_colors()
253 self.color_scheme_table = exception_colors()
254
254
255 # shorthands
255 # shorthands
256 C = coloransi.TermColors
256 C = coloransi.TermColors
257 cst = self.color_scheme_table
257 cst = self.color_scheme_table
258
258
259 cst['NoColor'].colors.prompt = C.NoColor
259 cst['NoColor'].colors.prompt = C.NoColor
260 cst['NoColor'].colors.breakpoint_enabled = C.NoColor
260 cst['NoColor'].colors.breakpoint_enabled = C.NoColor
261 cst['NoColor'].colors.breakpoint_disabled = C.NoColor
261 cst['NoColor'].colors.breakpoint_disabled = C.NoColor
262
262
263 cst['Linux'].colors.prompt = C.Green
263 cst['Linux'].colors.prompt = C.Green
264 cst['Linux'].colors.breakpoint_enabled = C.LightRed
264 cst['Linux'].colors.breakpoint_enabled = C.LightRed
265 cst['Linux'].colors.breakpoint_disabled = C.Red
265 cst['Linux'].colors.breakpoint_disabled = C.Red
266
266
267 cst['LightBG'].colors.prompt = C.Blue
267 cst['LightBG'].colors.prompt = C.Blue
268 cst['LightBG'].colors.breakpoint_enabled = C.LightRed
268 cst['LightBG'].colors.breakpoint_enabled = C.LightRed
269 cst['LightBG'].colors.breakpoint_disabled = C.Red
269 cst['LightBG'].colors.breakpoint_disabled = C.Red
270
270
271 cst['Neutral'].colors.prompt = C.Blue
271 cst['Neutral'].colors.prompt = C.Blue
272 cst['Neutral'].colors.breakpoint_enabled = C.LightRed
272 cst['Neutral'].colors.breakpoint_enabled = C.LightRed
273 cst['Neutral'].colors.breakpoint_disabled = C.Red
273 cst['Neutral'].colors.breakpoint_disabled = C.Red
274
274
275
275
276 # Add a python parser so we can syntax highlight source while
276 # Add a python parser so we can syntax highlight source while
277 # debugging.
277 # debugging.
278 self.parser = PyColorize.Parser(style=color_scheme)
278 self.parser = PyColorize.Parser(style=color_scheme)
279 self.set_colors(color_scheme)
279 self.set_colors(color_scheme)
280
280
281 # Set the prompt - the default prompt is '(Pdb)'
281 # Set the prompt - the default prompt is '(Pdb)'
282 self.prompt = prompt
282 self.prompt = prompt
283 self.skip_hidden = True
283 self.skip_hidden = True
284
284
285 def set_colors(self, scheme):
285 def set_colors(self, scheme):
286 """Shorthand access to the color table scheme selector method."""
286 """Shorthand access to the color table scheme selector method."""
287 self.color_scheme_table.set_active_scheme(scheme)
287 self.color_scheme_table.set_active_scheme(scheme)
288 self.parser.style = scheme
288 self.parser.style = scheme
289
289
290
290
291 def hidden_frames(self, stack):
291 def hidden_frames(self, stack):
292 """
292 """
293 Given an index in the stack return wether it should be skipped.
293 Given an index in the stack return wether it should be skipped.
294
294
295 This is used in up/down and where to skip frames.
295 This is used in up/down and where to skip frames.
296 """
296 """
297 ip_hide = [s[0].f_locals.get("__tracebackhide__", False) for s in stack]
297 # The f_locals dictionary is updated from the actual frame
298 # locals whenever the .f_locals accessor is called, so we
299 # avoid calling it here to preserve self.curframe_locals.
300 # Futhermore, there is no good reason to hide the current frame.
301 ip_hide = [
302 False if s[0] is self.curframe else s[0].f_locals.get(
303 "__tracebackhide__", False)
304 for s in stack]
298 ip_start = [i for i, s in enumerate(ip_hide) if s == "__ipython_bottom__"]
305 ip_start = [i for i, s in enumerate(ip_hide) if s == "__ipython_bottom__"]
299 if ip_start:
306 if ip_start:
300 ip_hide = [h if i > ip_start[0] else True for (i, h) in enumerate(ip_hide)]
307 ip_hide = [h if i > ip_start[0] else True for (i, h) in enumerate(ip_hide)]
301 return ip_hide
308 return ip_hide
302
309
303 def interaction(self, frame, traceback):
310 def interaction(self, frame, traceback):
304 try:
311 try:
305 OldPdb.interaction(self, frame, traceback)
312 OldPdb.interaction(self, frame, traceback)
306 except KeyboardInterrupt:
313 except KeyboardInterrupt:
307 self.stdout.write("\n" + self.shell.get_exception_only())
314 self.stdout.write("\n" + self.shell.get_exception_only())
308
315
309 def new_do_frame(self, arg):
316 def new_do_frame(self, arg):
310 OldPdb.do_frame(self, arg)
317 OldPdb.do_frame(self, arg)
311
318
312 def new_do_quit(self, arg):
319 def new_do_quit(self, arg):
313
320
314 if hasattr(self, 'old_all_completions'):
321 if hasattr(self, 'old_all_completions'):
315 self.shell.Completer.all_completions=self.old_all_completions
322 self.shell.Completer.all_completions=self.old_all_completions
316
323
317 return OldPdb.do_quit(self, arg)
324 return OldPdb.do_quit(self, arg)
318
325
319 do_q = do_quit = decorate_fn_with_doc(new_do_quit, OldPdb.do_quit)
326 do_q = do_quit = decorate_fn_with_doc(new_do_quit, OldPdb.do_quit)
320
327
321 def new_do_restart(self, arg):
328 def new_do_restart(self, arg):
322 """Restart command. In the context of ipython this is exactly the same
329 """Restart command. In the context of ipython this is exactly the same
323 thing as 'quit'."""
330 thing as 'quit'."""
324 self.msg("Restart doesn't make sense here. Using 'quit' instead.")
331 self.msg("Restart doesn't make sense here. Using 'quit' instead.")
325 return self.do_quit(arg)
332 return self.do_quit(arg)
326
333
327 def print_stack_trace(self, context=None):
334 def print_stack_trace(self, context=None):
328 Colors = self.color_scheme_table.active_colors
335 Colors = self.color_scheme_table.active_colors
329 ColorsNormal = Colors.Normal
336 ColorsNormal = Colors.Normal
330 if context is None:
337 if context is None:
331 context = self.context
338 context = self.context
332 try:
339 try:
333 context=int(context)
340 context=int(context)
334 if context <= 0:
341 if context <= 0:
335 raise ValueError("Context must be a positive integer")
342 raise ValueError("Context must be a positive integer")
336 except (TypeError, ValueError):
343 except (TypeError, ValueError):
337 raise ValueError("Context must be a positive integer")
344 raise ValueError("Context must be a positive integer")
338 try:
345 try:
339 skipped = 0
346 skipped = 0
340 for hidden, frame_lineno in zip(self.hidden_frames(self.stack), self.stack):
347 for hidden, frame_lineno in zip(self.hidden_frames(self.stack), self.stack):
341 if hidden and self.skip_hidden:
348 if hidden and self.skip_hidden:
342 skipped += 1
349 skipped += 1
343 continue
350 continue
344 if skipped:
351 if skipped:
345 print(
352 print(
346 f"{Colors.excName} [... skipping {skipped} hidden frame(s)]{ColorsNormal}\n"
353 f"{Colors.excName} [... skipping {skipped} hidden frame(s)]{ColorsNormal}\n"
347 )
354 )
348 skipped = 0
355 skipped = 0
349 self.print_stack_entry(frame_lineno, context=context)
356 self.print_stack_entry(frame_lineno, context=context)
350 if skipped:
357 if skipped:
351 print(
358 print(
352 f"{Colors.excName} [... skipping {skipped} hidden frame(s)]{ColorsNormal}\n"
359 f"{Colors.excName} [... skipping {skipped} hidden frame(s)]{ColorsNormal}\n"
353 )
360 )
354 except KeyboardInterrupt:
361 except KeyboardInterrupt:
355 pass
362 pass
356
363
357 def print_stack_entry(self, frame_lineno, prompt_prefix='\n-> ',
364 def print_stack_entry(self, frame_lineno, prompt_prefix='\n-> ',
358 context=None):
365 context=None):
359 if context is None:
366 if context is None:
360 context = self.context
367 context = self.context
361 try:
368 try:
362 context=int(context)
369 context=int(context)
363 if context <= 0:
370 if context <= 0:
364 raise ValueError("Context must be a positive integer")
371 raise ValueError("Context must be a positive integer")
365 except (TypeError, ValueError):
372 except (TypeError, ValueError):
366 raise ValueError("Context must be a positive integer")
373 raise ValueError("Context must be a positive integer")
367 print(self.format_stack_entry(frame_lineno, '', context), file=self.stdout)
374 print(self.format_stack_entry(frame_lineno, '', context), file=self.stdout)
368
375
369 # vds: >>
376 # vds: >>
370 frame, lineno = frame_lineno
377 frame, lineno = frame_lineno
371 filename = frame.f_code.co_filename
378 filename = frame.f_code.co_filename
372 self.shell.hooks.synchronize_with_editor(filename, lineno, 0)
379 self.shell.hooks.synchronize_with_editor(filename, lineno, 0)
373 # vds: <<
380 # vds: <<
374
381
375 def format_stack_entry(self, frame_lineno, lprefix=': ', context=None):
382 def format_stack_entry(self, frame_lineno, lprefix=': ', context=None):
376 if context is None:
383 if context is None:
377 context = self.context
384 context = self.context
378 try:
385 try:
379 context=int(context)
386 context=int(context)
380 if context <= 0:
387 if context <= 0:
381 print("Context must be a positive integer", file=self.stdout)
388 print("Context must be a positive integer", file=self.stdout)
382 except (TypeError, ValueError):
389 except (TypeError, ValueError):
383 print("Context must be a positive integer", file=self.stdout)
390 print("Context must be a positive integer", file=self.stdout)
384 try:
391 try:
385 import reprlib # Py 3
392 import reprlib # Py 3
386 except ImportError:
393 except ImportError:
387 import repr as reprlib # Py 2
394 import repr as reprlib # Py 2
388
395
389 ret = []
396 ret = []
390
397
391 Colors = self.color_scheme_table.active_colors
398 Colors = self.color_scheme_table.active_colors
392 ColorsNormal = Colors.Normal
399 ColorsNormal = Colors.Normal
393 tpl_link = u'%s%%s%s' % (Colors.filenameEm, ColorsNormal)
400 tpl_link = u'%s%%s%s' % (Colors.filenameEm, ColorsNormal)
394 tpl_call = u'%s%%s%s%%s%s' % (Colors.vName, Colors.valEm, ColorsNormal)
401 tpl_call = u'%s%%s%s%%s%s' % (Colors.vName, Colors.valEm, ColorsNormal)
395 tpl_line = u'%%s%s%%s %s%%s' % (Colors.lineno, ColorsNormal)
402 tpl_line = u'%%s%s%%s %s%%s' % (Colors.lineno, ColorsNormal)
396 tpl_line_em = u'%%s%s%%s %s%%s%s' % (Colors.linenoEm, Colors.line,
403 tpl_line_em = u'%%s%s%%s %s%%s%s' % (Colors.linenoEm, Colors.line,
397 ColorsNormal)
404 ColorsNormal)
398
405
399 frame, lineno = frame_lineno
406 frame, lineno = frame_lineno
400
407
401 return_value = ''
408 return_value = ''
402 if '__return__' in frame.f_locals:
409 if '__return__' in frame.f_locals:
403 rv = frame.f_locals['__return__']
410 rv = frame.f_locals['__return__']
404 #return_value += '->'
411 #return_value += '->'
405 return_value += reprlib.repr(rv) + '\n'
412 return_value += reprlib.repr(rv) + '\n'
406 ret.append(return_value)
413 ret.append(return_value)
407
414
408 #s = filename + '(' + `lineno` + ')'
415 #s = filename + '(' + `lineno` + ')'
409 filename = self.canonic(frame.f_code.co_filename)
416 filename = self.canonic(frame.f_code.co_filename)
410 link = tpl_link % py3compat.cast_unicode(filename)
417 link = tpl_link % py3compat.cast_unicode(filename)
411
418
412 if frame.f_code.co_name:
419 if frame.f_code.co_name:
413 func = frame.f_code.co_name
420 func = frame.f_code.co_name
414 else:
421 else:
415 func = "<lambda>"
422 func = "<lambda>"
416
423
417 call = ''
424 call = ''
418 if func != '?':
425 if func != '?':
419 if '__args__' in frame.f_locals:
426 if '__args__' in frame.f_locals:
420 args = reprlib.repr(frame.f_locals['__args__'])
427 args = reprlib.repr(frame.f_locals['__args__'])
421 else:
428 else:
422 args = '()'
429 args = '()'
423 call = tpl_call % (func, args)
430 call = tpl_call % (func, args)
424
431
425 # The level info should be generated in the same format pdb uses, to
432 # The level info should be generated in the same format pdb uses, to
426 # avoid breaking the pdbtrack functionality of python-mode in *emacs.
433 # avoid breaking the pdbtrack functionality of python-mode in *emacs.
427 if frame is self.curframe:
434 if frame is self.curframe:
428 ret.append('> ')
435 ret.append('> ')
429 else:
436 else:
430 ret.append(' ')
437 ret.append(' ')
431 ret.append(u'%s(%s)%s\n' % (link,lineno,call))
438 ret.append(u'%s(%s)%s\n' % (link,lineno,call))
432
439
433 start = lineno - 1 - context//2
440 start = lineno - 1 - context//2
434 lines = linecache.getlines(filename)
441 lines = linecache.getlines(filename)
435 start = min(start, len(lines) - context)
442 start = min(start, len(lines) - context)
436 start = max(start, 0)
443 start = max(start, 0)
437 lines = lines[start : start + context]
444 lines = lines[start : start + context]
438
445
439 for i,line in enumerate(lines):
446 for i,line in enumerate(lines):
440 show_arrow = (start + 1 + i == lineno)
447 show_arrow = (start + 1 + i == lineno)
441 linetpl = (frame is self.curframe or show_arrow) \
448 linetpl = (frame is self.curframe or show_arrow) \
442 and tpl_line_em \
449 and tpl_line_em \
443 or tpl_line
450 or tpl_line
444 ret.append(self.__format_line(linetpl, filename,
451 ret.append(self.__format_line(linetpl, filename,
445 start + 1 + i, line,
452 start + 1 + i, line,
446 arrow = show_arrow) )
453 arrow = show_arrow) )
447 return ''.join(ret)
454 return ''.join(ret)
448
455
449 def __format_line(self, tpl_line, filename, lineno, line, arrow = False):
456 def __format_line(self, tpl_line, filename, lineno, line, arrow = False):
450 bp_mark = ""
457 bp_mark = ""
451 bp_mark_color = ""
458 bp_mark_color = ""
452
459
453 new_line, err = self.parser.format2(line, 'str')
460 new_line, err = self.parser.format2(line, 'str')
454 if not err:
461 if not err:
455 line = new_line
462 line = new_line
456
463
457 bp = None
464 bp = None
458 if lineno in self.get_file_breaks(filename):
465 if lineno in self.get_file_breaks(filename):
459 bps = self.get_breaks(filename, lineno)
466 bps = self.get_breaks(filename, lineno)
460 bp = bps[-1]
467 bp = bps[-1]
461
468
462 if bp:
469 if bp:
463 Colors = self.color_scheme_table.active_colors
470 Colors = self.color_scheme_table.active_colors
464 bp_mark = str(bp.number)
471 bp_mark = str(bp.number)
465 bp_mark_color = Colors.breakpoint_enabled
472 bp_mark_color = Colors.breakpoint_enabled
466 if not bp.enabled:
473 if not bp.enabled:
467 bp_mark_color = Colors.breakpoint_disabled
474 bp_mark_color = Colors.breakpoint_disabled
468
475
469 numbers_width = 7
476 numbers_width = 7
470 if arrow:
477 if arrow:
471 # This is the line with the error
478 # This is the line with the error
472 pad = numbers_width - len(str(lineno)) - len(bp_mark)
479 pad = numbers_width - len(str(lineno)) - len(bp_mark)
473 num = '%s%s' % (make_arrow(pad), str(lineno))
480 num = '%s%s' % (make_arrow(pad), str(lineno))
474 else:
481 else:
475 num = '%*s' % (numbers_width - len(bp_mark), str(lineno))
482 num = '%*s' % (numbers_width - len(bp_mark), str(lineno))
476
483
477 return tpl_line % (bp_mark_color + bp_mark, num, line)
484 return tpl_line % (bp_mark_color + bp_mark, num, line)
478
485
479
486
480 def print_list_lines(self, filename, first, last):
487 def print_list_lines(self, filename, first, last):
481 """The printing (as opposed to the parsing part of a 'list'
488 """The printing (as opposed to the parsing part of a 'list'
482 command."""
489 command."""
483 try:
490 try:
484 Colors = self.color_scheme_table.active_colors
491 Colors = self.color_scheme_table.active_colors
485 ColorsNormal = Colors.Normal
492 ColorsNormal = Colors.Normal
486 tpl_line = '%%s%s%%s %s%%s' % (Colors.lineno, ColorsNormal)
493 tpl_line = '%%s%s%%s %s%%s' % (Colors.lineno, ColorsNormal)
487 tpl_line_em = '%%s%s%%s %s%%s%s' % (Colors.linenoEm, Colors.line, ColorsNormal)
494 tpl_line_em = '%%s%s%%s %s%%s%s' % (Colors.linenoEm, Colors.line, ColorsNormal)
488 src = []
495 src = []
489 if filename == "<string>" and hasattr(self, "_exec_filename"):
496 if filename == "<string>" and hasattr(self, "_exec_filename"):
490 filename = self._exec_filename
497 filename = self._exec_filename
491
498
492 for lineno in range(first, last+1):
499 for lineno in range(first, last+1):
493 line = linecache.getline(filename, lineno)
500 line = linecache.getline(filename, lineno)
494 if not line:
501 if not line:
495 break
502 break
496
503
497 if lineno == self.curframe.f_lineno:
504 if lineno == self.curframe.f_lineno:
498 line = self.__format_line(tpl_line_em, filename, lineno, line, arrow = True)
505 line = self.__format_line(tpl_line_em, filename, lineno, line, arrow = True)
499 else:
506 else:
500 line = self.__format_line(tpl_line, filename, lineno, line, arrow = False)
507 line = self.__format_line(tpl_line, filename, lineno, line, arrow = False)
501
508
502 src.append(line)
509 src.append(line)
503 self.lineno = lineno
510 self.lineno = lineno
504
511
505 print(''.join(src), file=self.stdout)
512 print(''.join(src), file=self.stdout)
506
513
507 except KeyboardInterrupt:
514 except KeyboardInterrupt:
508 pass
515 pass
509
516
510 def do_skip_hidden(self, arg):
517 def do_skip_hidden(self, arg):
511 """
518 """
512 Change whether or not we should skip frames with the
519 Change whether or not we should skip frames with the
513 __tracebackhide__ attribute.
520 __tracebackhide__ attribute.
514 """
521 """
515 if arg.strip().lower() in ("true", "yes"):
522 if arg.strip().lower() in ("true", "yes"):
516 self.skip_hidden = True
523 self.skip_hidden = True
517 elif arg.strip().lower() in ("false", "no"):
524 elif arg.strip().lower() in ("false", "no"):
518 self.skip_hidden = False
525 self.skip_hidden = False
519
526
520 def do_list(self, arg):
527 def do_list(self, arg):
521 """Print lines of code from the current stack frame
528 """Print lines of code from the current stack frame
522 """
529 """
523 self.lastcmd = 'list'
530 self.lastcmd = 'list'
524 last = None
531 last = None
525 if arg:
532 if arg:
526 try:
533 try:
527 x = eval(arg, {}, {})
534 x = eval(arg, {}, {})
528 if type(x) == type(()):
535 if type(x) == type(()):
529 first, last = x
536 first, last = x
530 first = int(first)
537 first = int(first)
531 last = int(last)
538 last = int(last)
532 if last < first:
539 if last < first:
533 # Assume it's a count
540 # Assume it's a count
534 last = first + last
541 last = first + last
535 else:
542 else:
536 first = max(1, int(x) - 5)
543 first = max(1, int(x) - 5)
537 except:
544 except:
538 print('*** Error in argument:', repr(arg), file=self.stdout)
545 print('*** Error in argument:', repr(arg), file=self.stdout)
539 return
546 return
540 elif self.lineno is None:
547 elif self.lineno is None:
541 first = max(1, self.curframe.f_lineno - 5)
548 first = max(1, self.curframe.f_lineno - 5)
542 else:
549 else:
543 first = self.lineno + 1
550 first = self.lineno + 1
544 if last is None:
551 if last is None:
545 last = first + 10
552 last = first + 10
546 self.print_list_lines(self.curframe.f_code.co_filename, first, last)
553 self.print_list_lines(self.curframe.f_code.co_filename, first, last)
547
554
548 # vds: >>
555 # vds: >>
549 lineno = first
556 lineno = first
550 filename = self.curframe.f_code.co_filename
557 filename = self.curframe.f_code.co_filename
551 self.shell.hooks.synchronize_with_editor(filename, lineno, 0)
558 self.shell.hooks.synchronize_with_editor(filename, lineno, 0)
552 # vds: <<
559 # vds: <<
553
560
554 do_l = do_list
561 do_l = do_list
555
562
556 def getsourcelines(self, obj):
563 def getsourcelines(self, obj):
557 lines, lineno = inspect.findsource(obj)
564 lines, lineno = inspect.findsource(obj)
558 if inspect.isframe(obj) and obj.f_globals is obj.f_locals:
565 if inspect.isframe(obj) and obj.f_globals is obj.f_locals:
559 # must be a module frame: do not try to cut a block out of it
566 # must be a module frame: do not try to cut a block out of it
560 return lines, 1
567 return lines, 1
561 elif inspect.ismodule(obj):
568 elif inspect.ismodule(obj):
562 return lines, 1
569 return lines, 1
563 return inspect.getblock(lines[lineno:]), lineno+1
570 return inspect.getblock(lines[lineno:]), lineno+1
564
571
565 def do_longlist(self, arg):
572 def do_longlist(self, arg):
566 """Print lines of code from the current stack frame.
573 """Print lines of code from the current stack frame.
567
574
568 Shows more lines than 'list' does.
575 Shows more lines than 'list' does.
569 """
576 """
570 self.lastcmd = 'longlist'
577 self.lastcmd = 'longlist'
571 try:
578 try:
572 lines, lineno = self.getsourcelines(self.curframe)
579 lines, lineno = self.getsourcelines(self.curframe)
573 except OSError as err:
580 except OSError as err:
574 self.error(err)
581 self.error(err)
575 return
582 return
576 last = lineno + len(lines)
583 last = lineno + len(lines)
577 self.print_list_lines(self.curframe.f_code.co_filename, lineno, last)
584 self.print_list_lines(self.curframe.f_code.co_filename, lineno, last)
578 do_ll = do_longlist
585 do_ll = do_longlist
579
586
580 def do_debug(self, arg):
587 def do_debug(self, arg):
581 """debug code
588 """debug code
582 Enter a recursive debugger that steps through the code
589 Enter a recursive debugger that steps through the code
583 argument (which is an arbitrary expression or statement to be
590 argument (which is an arbitrary expression or statement to be
584 executed in the current environment).
591 executed in the current environment).
585 """
592 """
586 sys.settrace(None)
593 sys.settrace(None)
587 globals = self.curframe.f_globals
594 globals = self.curframe.f_globals
588 locals = self.curframe_locals
595 locals = self.curframe_locals
589 p = self.__class__(completekey=self.completekey,
596 p = self.__class__(completekey=self.completekey,
590 stdin=self.stdin, stdout=self.stdout)
597 stdin=self.stdin, stdout=self.stdout)
591 p.use_rawinput = self.use_rawinput
598 p.use_rawinput = self.use_rawinput
592 p.prompt = "(%s) " % self.prompt.strip()
599 p.prompt = "(%s) " % self.prompt.strip()
593 self.message("ENTERING RECURSIVE DEBUGGER")
600 self.message("ENTERING RECURSIVE DEBUGGER")
594 sys.call_tracing(p.run, (arg, globals, locals))
601 sys.call_tracing(p.run, (arg, globals, locals))
595 self.message("LEAVING RECURSIVE DEBUGGER")
602 self.message("LEAVING RECURSIVE DEBUGGER")
596 sys.settrace(self.trace_dispatch)
603 sys.settrace(self.trace_dispatch)
597 self.lastcmd = p.lastcmd
604 self.lastcmd = p.lastcmd
598
605
599 def do_pdef(self, arg):
606 def do_pdef(self, arg):
600 """Print the call signature for any callable object.
607 """Print the call signature for any callable object.
601
608
602 The debugger interface to %pdef"""
609 The debugger interface to %pdef"""
603 namespaces = [('Locals', self.curframe.f_locals),
610 namespaces = [('Locals', self.curframe.f_locals),
604 ('Globals', self.curframe.f_globals)]
611 ('Globals', self.curframe.f_globals)]
605 self.shell.find_line_magic('pdef')(arg, namespaces=namespaces)
612 self.shell.find_line_magic('pdef')(arg, namespaces=namespaces)
606
613
607 def do_pdoc(self, arg):
614 def do_pdoc(self, arg):
608 """Print the docstring for an object.
615 """Print the docstring for an object.
609
616
610 The debugger interface to %pdoc."""
617 The debugger interface to %pdoc."""
611 namespaces = [('Locals', self.curframe.f_locals),
618 namespaces = [('Locals', self.curframe.f_locals),
612 ('Globals', self.curframe.f_globals)]
619 ('Globals', self.curframe.f_globals)]
613 self.shell.find_line_magic('pdoc')(arg, namespaces=namespaces)
620 self.shell.find_line_magic('pdoc')(arg, namespaces=namespaces)
614
621
615 def do_pfile(self, arg):
622 def do_pfile(self, arg):
616 """Print (or run through pager) the file where an object is defined.
623 """Print (or run through pager) the file where an object is defined.
617
624
618 The debugger interface to %pfile.
625 The debugger interface to %pfile.
619 """
626 """
620 namespaces = [('Locals', self.curframe.f_locals),
627 namespaces = [('Locals', self.curframe.f_locals),
621 ('Globals', self.curframe.f_globals)]
628 ('Globals', self.curframe.f_globals)]
622 self.shell.find_line_magic('pfile')(arg, namespaces=namespaces)
629 self.shell.find_line_magic('pfile')(arg, namespaces=namespaces)
623
630
624 def do_pinfo(self, arg):
631 def do_pinfo(self, arg):
625 """Provide detailed information about an object.
632 """Provide detailed information about an object.
626
633
627 The debugger interface to %pinfo, i.e., obj?."""
634 The debugger interface to %pinfo, i.e., obj?."""
628 namespaces = [('Locals', self.curframe.f_locals),
635 namespaces = [('Locals', self.curframe.f_locals),
629 ('Globals', self.curframe.f_globals)]
636 ('Globals', self.curframe.f_globals)]
630 self.shell.find_line_magic('pinfo')(arg, namespaces=namespaces)
637 self.shell.find_line_magic('pinfo')(arg, namespaces=namespaces)
631
638
632 def do_pinfo2(self, arg):
639 def do_pinfo2(self, arg):
633 """Provide extra detailed information about an object.
640 """Provide extra detailed information about an object.
634
641
635 The debugger interface to %pinfo2, i.e., obj??."""
642 The debugger interface to %pinfo2, i.e., obj??."""
636 namespaces = [('Locals', self.curframe.f_locals),
643 namespaces = [('Locals', self.curframe.f_locals),
637 ('Globals', self.curframe.f_globals)]
644 ('Globals', self.curframe.f_globals)]
638 self.shell.find_line_magic('pinfo2')(arg, namespaces=namespaces)
645 self.shell.find_line_magic('pinfo2')(arg, namespaces=namespaces)
639
646
640 def do_psource(self, arg):
647 def do_psource(self, arg):
641 """Print (or run through pager) the source code for an object."""
648 """Print (or run through pager) the source code for an object."""
642 namespaces = [('Locals', self.curframe.f_locals),
649 namespaces = [('Locals', self.curframe.f_locals),
643 ('Globals', self.curframe.f_globals)]
650 ('Globals', self.curframe.f_globals)]
644 self.shell.find_line_magic('psource')(arg, namespaces=namespaces)
651 self.shell.find_line_magic('psource')(arg, namespaces=namespaces)
645
652
646 def do_where(self, arg):
653 def do_where(self, arg):
647 """w(here)
654 """w(here)
648 Print a stack trace, with the most recent frame at the bottom.
655 Print a stack trace, with the most recent frame at the bottom.
649 An arrow indicates the "current frame", which determines the
656 An arrow indicates the "current frame", which determines the
650 context of most commands. 'bt' is an alias for this command.
657 context of most commands. 'bt' is an alias for this command.
651
658
652 Take a number as argument as an (optional) number of context line to
659 Take a number as argument as an (optional) number of context line to
653 print"""
660 print"""
654 if arg:
661 if arg:
655 try:
662 try:
656 context = int(arg)
663 context = int(arg)
657 except ValueError as err:
664 except ValueError as err:
658 self.error(err)
665 self.error(err)
659 return
666 return
660 self.print_stack_trace(context)
667 self.print_stack_trace(context)
661 else:
668 else:
662 self.print_stack_trace()
669 self.print_stack_trace()
663
670
664 do_w = do_where
671 do_w = do_where
665
672
666 def stop_here(self, frame):
673 def stop_here(self, frame):
667 hidden = False
674 hidden = False
668 if self.skip_hidden:
675 if self.skip_hidden:
669 hidden = frame.f_locals.get("__tracebackhide__", False)
676 hidden = frame.f_locals.get("__tracebackhide__", False)
670 if hidden:
677 if hidden:
671 Colors = self.color_scheme_table.active_colors
678 Colors = self.color_scheme_table.active_colors
672 ColorsNormal = Colors.Normal
679 ColorsNormal = Colors.Normal
673 print(f"{Colors.excName} [... skipped 1 hidden frame]{ColorsNormal}\n")
680 print(f"{Colors.excName} [... skipped 1 hidden frame]{ColorsNormal}\n")
674
681
675 return super().stop_here(frame)
682 return super().stop_here(frame)
676
683
677 def do_up(self, arg):
684 def do_up(self, arg):
678 """u(p) [count]
685 """u(p) [count]
679 Move the current frame count (default one) levels up in the
686 Move the current frame count (default one) levels up in the
680 stack trace (to an older frame).
687 stack trace (to an older frame).
681
688
682 Will skip hidden frames.
689 Will skip hidden frames.
683 """
690 """
684 ## modified version of upstream that skips
691 ## modified version of upstream that skips
685 # frames with __tracebackide__
692 # frames with __tracebackide__
686 if self.curindex == 0:
693 if self.curindex == 0:
687 self.error("Oldest frame")
694 self.error("Oldest frame")
688 return
695 return
689 try:
696 try:
690 count = int(arg or 1)
697 count = int(arg or 1)
691 except ValueError:
698 except ValueError:
692 self.error("Invalid frame count (%s)" % arg)
699 self.error("Invalid frame count (%s)" % arg)
693 return
700 return
694 skipped = 0
701 skipped = 0
695 if count < 0:
702 if count < 0:
696 _newframe = 0
703 _newframe = 0
697 else:
704 else:
698 _newindex = self.curindex
705 _newindex = self.curindex
699 counter = 0
706 counter = 0
700 hidden_frames = self.hidden_frames(self.stack)
707 hidden_frames = self.hidden_frames(self.stack)
701 for i in range(self.curindex - 1, -1, -1):
708 for i in range(self.curindex - 1, -1, -1):
702 frame = self.stack[i][0]
709 frame = self.stack[i][0]
703 if hidden_frames[i] and self.skip_hidden:
710 if hidden_frames[i] and self.skip_hidden:
704 skipped += 1
711 skipped += 1
705 continue
712 continue
706 counter += 1
713 counter += 1
707 if counter >= count:
714 if counter >= count:
708 break
715 break
709 else:
716 else:
710 # if no break occured.
717 # if no break occured.
711 self.error("all frames above hidden")
718 self.error("all frames above hidden")
712 return
719 return
713
720
714 Colors = self.color_scheme_table.active_colors
721 Colors = self.color_scheme_table.active_colors
715 ColorsNormal = Colors.Normal
722 ColorsNormal = Colors.Normal
716 _newframe = i
723 _newframe = i
717 self._select_frame(_newframe)
724 self._select_frame(_newframe)
718 if skipped:
725 if skipped:
719 print(
726 print(
720 f"{Colors.excName} [... skipped {skipped} hidden frame(s)]{ColorsNormal}\n"
727 f"{Colors.excName} [... skipped {skipped} hidden frame(s)]{ColorsNormal}\n"
721 )
728 )
722
729
723 def do_down(self, arg):
730 def do_down(self, arg):
724 """d(own) [count]
731 """d(own) [count]
725 Move the current frame count (default one) levels down in the
732 Move the current frame count (default one) levels down in the
726 stack trace (to a newer frame).
733 stack trace (to a newer frame).
727
734
728 Will skip hidden frames.
735 Will skip hidden frames.
729 """
736 """
730 if self.curindex + 1 == len(self.stack):
737 if self.curindex + 1 == len(self.stack):
731 self.error("Newest frame")
738 self.error("Newest frame")
732 return
739 return
733 try:
740 try:
734 count = int(arg or 1)
741 count = int(arg or 1)
735 except ValueError:
742 except ValueError:
736 self.error("Invalid frame count (%s)" % arg)
743 self.error("Invalid frame count (%s)" % arg)
737 return
744 return
738 if count < 0:
745 if count < 0:
739 _newframe = len(self.stack) - 1
746 _newframe = len(self.stack) - 1
740 else:
747 else:
741 _newindex = self.curindex
748 _newindex = self.curindex
742 counter = 0
749 counter = 0
743 skipped = 0
750 skipped = 0
744 hidden_frames = self.hidden_frames(self.stack)
751 hidden_frames = self.hidden_frames(self.stack)
745 for i in range(self.curindex + 1, len(self.stack)):
752 for i in range(self.curindex + 1, len(self.stack)):
746 frame = self.stack[i][0]
753 frame = self.stack[i][0]
747 if hidden_frames[i] and self.skip_hidden:
754 if hidden_frames[i] and self.skip_hidden:
748 skipped += 1
755 skipped += 1
749 continue
756 continue
750 counter += 1
757 counter += 1
751 if counter >= count:
758 if counter >= count:
752 break
759 break
753 else:
760 else:
754 self.error("all frames bellow hidden")
761 self.error("all frames bellow hidden")
755 return
762 return
756
763
757 Colors = self.color_scheme_table.active_colors
764 Colors = self.color_scheme_table.active_colors
758 ColorsNormal = Colors.Normal
765 ColorsNormal = Colors.Normal
759 if skipped:
766 if skipped:
760 print(
767 print(
761 f"{Colors.excName} [... skipped {skipped} hidden frame(s)]{ColorsNormal}\n"
768 f"{Colors.excName} [... skipped {skipped} hidden frame(s)]{ColorsNormal}\n"
762 )
769 )
763 _newframe = i
770 _newframe = i
764
771
765 self._select_frame(_newframe)
772 self._select_frame(_newframe)
766
773
767 do_d = do_down
774 do_d = do_down
768 do_u = do_up
775 do_u = do_up
769
776
770 class InterruptiblePdb(Pdb):
777 class InterruptiblePdb(Pdb):
771 """Version of debugger where KeyboardInterrupt exits the debugger altogether."""
778 """Version of debugger where KeyboardInterrupt exits the debugger altogether."""
772
779
773 def cmdloop(self):
780 def cmdloop(self):
774 """Wrap cmdloop() such that KeyboardInterrupt stops the debugger."""
781 """Wrap cmdloop() such that KeyboardInterrupt stops the debugger."""
775 try:
782 try:
776 return OldPdb.cmdloop(self)
783 return OldPdb.cmdloop(self)
777 except KeyboardInterrupt:
784 except KeyboardInterrupt:
778 self.stop_here = lambda frame: False
785 self.stop_here = lambda frame: False
779 self.do_quit("")
786 self.do_quit("")
780 sys.settrace(None)
787 sys.settrace(None)
781 self.quitting = False
788 self.quitting = False
782 raise
789 raise
783
790
784 def _cmdloop(self):
791 def _cmdloop(self):
785 while True:
792 while True:
786 try:
793 try:
787 # keyboard interrupts allow for an easy way to cancel
794 # keyboard interrupts allow for an easy way to cancel
788 # the current command, so allow them during interactive input
795 # the current command, so allow them during interactive input
789 self.allow_kbdint = True
796 self.allow_kbdint = True
790 self.cmdloop()
797 self.cmdloop()
791 self.allow_kbdint = False
798 self.allow_kbdint = False
792 break
799 break
793 except KeyboardInterrupt:
800 except KeyboardInterrupt:
794 self.message('--KeyboardInterrupt--')
801 self.message('--KeyboardInterrupt--')
795 raise
802 raise
796
803
797
804
798 def set_trace(frame=None):
805 def set_trace(frame=None):
799 """
806 """
800 Start debugging from `frame`.
807 Start debugging from `frame`.
801
808
802 If frame is not specified, debugging starts from caller's frame.
809 If frame is not specified, debugging starts from caller's frame.
803 """
810 """
804 Pdb().set_trace(frame or sys._getframe().f_back)
811 Pdb().set_trace(frame or sys._getframe().f_back)
General Comments 0
You need to be logged in to leave comments. Login now