| #! /usr/bin/env python |
| |
| """A Python debugger.""" |
| |
| # (See pdb.doc for documentation.) |
| |
| import sys |
| import linecache |
| import cmd |
| import bdb |
| from reprlib import Repr |
| import os |
| import re |
| import pprint |
| import traceback |
| |
| |
| class Restart(Exception): |
| """Causes a debugger to be restarted for the debugged python program.""" |
| pass |
| |
| # Create a custom safe Repr instance and increase its maxstring. |
| # The default of 30 truncates error messages too easily. |
| _repr = Repr() |
| _repr.maxstring = 200 |
| _saferepr = _repr.repr |
| |
| __all__ = ["run", "pm", "Pdb", "runeval", "runctx", "runcall", "set_trace", |
| "post_mortem", "help"] |
| |
| def find_function(funcname, filename): |
| cre = re.compile(r'def\s+%s\s*[(]' % re.escape(funcname)) |
| try: |
| fp = open(filename) |
| except IOError: |
| return None |
| # consumer of this info expects the first line to be 1 |
| lineno = 1 |
| answer = None |
| while 1: |
| line = fp.readline() |
| if line == '': |
| break |
| if cre.match(line): |
| answer = funcname, filename, lineno |
| break |
| lineno = lineno + 1 |
| fp.close() |
| return answer |
| |
| |
| # Interaction prompt line will separate file and call info from code |
| # text using value of line_prefix string. A newline and arrow may |
| # be to your liking. You can set it once pdb is imported using the |
| # command "pdb.line_prefix = '\n% '". |
| # line_prefix = ': ' # Use this to get the old situation back |
| line_prefix = '\n-> ' # Probably a better default |
| |
| class Pdb(bdb.Bdb, cmd.Cmd): |
| |
| def __init__(self, completekey='tab', stdin=None, stdout=None, skip=None): |
| bdb.Bdb.__init__(self, skip=skip) |
| cmd.Cmd.__init__(self, completekey, stdin, stdout) |
| if stdout: |
| self.use_rawinput = 0 |
| self.prompt = '(Pdb) ' |
| self.aliases = {} |
| self.mainpyfile = '' |
| self._wait_for_mainpyfile = 0 |
| # Try to load readline if it exists |
| try: |
| import readline |
| except ImportError: |
| pass |
| |
| # Read $HOME/.pdbrc and ./.pdbrc |
| self.rcLines = [] |
| if 'HOME' in os.environ: |
| envHome = os.environ['HOME'] |
| try: |
| rcFile = open(os.path.join(envHome, ".pdbrc")) |
| except IOError: |
| pass |
| else: |
| for line in rcFile.readlines(): |
| self.rcLines.append(line) |
| rcFile.close() |
| try: |
| rcFile = open(".pdbrc") |
| except IOError: |
| pass |
| else: |
| for line in rcFile.readlines(): |
| self.rcLines.append(line) |
| rcFile.close() |
| |
| self.commands = {} # associates a command list to breakpoint numbers |
| self.commands_doprompt = {} # for each bp num, tells if the prompt |
| # must be disp. after execing the cmd list |
| self.commands_silent = {} # for each bp num, tells if the stack trace |
| # must be disp. after execing the cmd list |
| self.commands_defining = False # True while in the process of defining |
| # a command list |
| self.commands_bnum = None # The breakpoint number for which we are |
| # defining a list |
| |
| def reset(self): |
| bdb.Bdb.reset(self) |
| self.forget() |
| |
| def forget(self): |
| self.lineno = None |
| self.stack = [] |
| self.curindex = 0 |
| self.curframe = None |
| |
| def setup(self, f, t): |
| self.forget() |
| self.stack, self.curindex = self.get_stack(f, t) |
| self.curframe = self.stack[self.curindex][0] |
| # The f_locals dictionary is updated from the actual frame |
| # locals whenever the .f_locals accessor is called, so we |
| # cache it here to ensure that modifications are not overwritten. |
| self.curframe_locals = self.curframe.f_locals |
| self.execRcLines() |
| |
| # Can be executed earlier than 'setup' if desired |
| def execRcLines(self): |
| if self.rcLines: |
| # Make local copy because of recursion |
| rcLines = self.rcLines |
| # executed only once |
| self.rcLines = [] |
| for line in rcLines: |
| line = line[:-1] |
| if len(line) > 0 and line[0] != '#': |
| self.onecmd(line) |
| |
| # Override Bdb methods |
| |
| def user_call(self, frame, argument_list): |
| """This method is called when there is the remote possibility |
| that we ever need to stop in this function.""" |
| if self._wait_for_mainpyfile: |
| return |
| if self.stop_here(frame): |
| print('--Call--', file=self.stdout) |
| self.interaction(frame, None) |
| |
| def user_line(self, frame): |
| """This function is called when we stop or break at this line.""" |
| if self._wait_for_mainpyfile: |
| if (self.mainpyfile != self.canonic(frame.f_code.co_filename) |
| or frame.f_lineno<= 0): |
| return |
| self._wait_for_mainpyfile = 0 |
| if self.bp_commands(frame): |
| self.interaction(frame, None) |
| |
| def bp_commands(self,frame): |
| """Call every command that was set for the current active breakpoint |
| (if there is one). |
| |
| Returns True if the normal interaction function must be called, |
| False otherwise.""" |
| # self.currentbp is set in bdb in Bdb.break_here if a breakpoint was hit |
| if getattr(self, "currentbp", False) and \ |
| self.currentbp in self.commands: |
| currentbp = self.currentbp |
| self.currentbp = 0 |
| lastcmd_back = self.lastcmd |
| self.setup(frame, None) |
| for line in self.commands[currentbp]: |
| self.onecmd(line) |
| self.lastcmd = lastcmd_back |
| if not self.commands_silent[currentbp]: |
| self.print_stack_entry(self.stack[self.curindex]) |
| if self.commands_doprompt[currentbp]: |
| self.cmdloop() |
| self.forget() |
| return |
| return 1 |
| |
| def user_return(self, frame, return_value): |
| """This function is called when a return trap is set here.""" |
| frame.f_locals['__return__'] = return_value |
| print('--Return--', file=self.stdout) |
| self.interaction(frame, None) |
| |
| def user_exception(self, frame, exc_info): |
| """This function is called if an exception occurs, |
| but only if we are to stop at or just below this level.""" |
| exc_type, exc_value, exc_traceback = exc_info |
| frame.f_locals['__exception__'] = exc_type, exc_value |
| exc_type_name = exc_type.__name__ |
| print(exc_type_name + ':', _saferepr(exc_value), file=self.stdout) |
| self.interaction(frame, exc_traceback) |
| |
| # General interaction function |
| |
| def interaction(self, frame, traceback): |
| self.setup(frame, traceback) |
| self.print_stack_entry(self.stack[self.curindex]) |
| self.cmdloop() |
| self.forget() |
| |
| def displayhook(self, obj): |
| """Custom displayhook for the exec in default(), which prevents |
| assignment of the _ variable in the builtins. |
| """ |
| # reproduce the behavior of the standard displayhook, not printing None |
| if obj is not None: |
| print(repr(obj)) |
| |
| def default(self, line): |
| if line[:1] == '!': line = line[1:] |
| locals = self.curframe_locals |
| globals = self.curframe.f_globals |
| try: |
| code = compile(line + '\n', '<stdin>', 'single') |
| save_stdout = sys.stdout |
| save_stdin = sys.stdin |
| save_displayhook = sys.displayhook |
| try: |
| sys.stdin = self.stdin |
| sys.stdout = self.stdout |
| sys.displayhook = self.displayhook |
| exec(code, globals, locals) |
| finally: |
| sys.stdout = save_stdout |
| sys.stdin = save_stdin |
| sys.displayhook = save_displayhook |
| except: |
| t, v = sys.exc_info()[:2] |
| if type(t) == type(''): |
| exc_type_name = t |
| else: exc_type_name = t.__name__ |
| print('***', exc_type_name + ':', v, file=self.stdout) |
| |
| def precmd(self, line): |
| """Handle alias expansion and ';;' separator.""" |
| if not line.strip(): |
| return line |
| args = line.split() |
| while args[0] in self.aliases: |
| line = self.aliases[args[0]] |
| ii = 1 |
| for tmpArg in args[1:]: |
| line = line.replace("%" + str(ii), |
| tmpArg) |
| ii = ii + 1 |
| line = line.replace("%*", ' '.join(args[1:])) |
| args = line.split() |
| # split into ';;' separated commands |
| # unless it's an alias command |
| if args[0] != 'alias': |
| marker = line.find(';;') |
| if marker >= 0: |
| # queue up everything after marker |
| next = line[marker+2:].lstrip() |
| self.cmdqueue.append(next) |
| line = line[:marker].rstrip() |
| return line |
| |
| def onecmd(self, line): |
| """Interpret the argument as though it had been typed in response |
| to the prompt. |
| |
| Checks whether this line is typed at the normal prompt or in |
| a breakpoint command list definition. |
| """ |
| if not self.commands_defining: |
| return cmd.Cmd.onecmd(self, line) |
| else: |
| return self.handle_command_def(line) |
| |
| def handle_command_def(self,line): |
| """ Handles one command line during command list definition. """ |
| cmd, arg, line = self.parseline(line) |
| if cmd == 'silent': |
| self.commands_silent[self.commands_bnum] = True |
| return # continue to handle other cmd def in the cmd list |
| elif cmd == 'end': |
| self.cmdqueue = [] |
| return 1 # end of cmd list |
| cmdlist = self.commands[self.commands_bnum] |
| if (arg): |
| cmdlist.append(cmd+' '+arg) |
| else: |
| cmdlist.append(cmd) |
| # Determine if we must stop |
| try: |
| func = getattr(self, 'do_' + cmd) |
| except AttributeError: |
| func = self.default |
| # one of the resuming commands |
| if func.__name__ in self.commands_resuming: |
| self.commands_doprompt[self.commands_bnum] = False |
| self.cmdqueue = [] |
| return 1 |
| return |
| |
| # Command definitions, called by cmdloop() |
| # The argument is the remaining string on the command line |
| # Return true to exit from the command loop |
| |
| do_h = cmd.Cmd.do_help |
| |
| def do_commands(self, arg): |
| """Defines a list of commands associated to a breakpoint. |
| |
| Those commands will be executed whenever the breakpoint causes |
| the program to stop execution.""" |
| if not arg: |
| bnum = len(bdb.Breakpoint.bpbynumber)-1 |
| else: |
| try: |
| bnum = int(arg) |
| except: |
| print("Usage : commands [bnum]\n ...\n end", |
| file=self.stdout) |
| return |
| self.commands_bnum = bnum |
| self.commands[bnum] = [] |
| self.commands_doprompt[bnum] = True |
| self.commands_silent[bnum] = False |
| prompt_back = self.prompt |
| self.prompt = '(com) ' |
| self.commands_defining = True |
| self.cmdloop() |
| self.commands_defining = False |
| self.prompt = prompt_back |
| |
| def do_break(self, arg, temporary = 0): |
| # break [ ([filename:]lineno | function) [, "condition"] ] |
| if not arg: |
| if self.breaks: # There's at least one |
| print("Num Type Disp Enb Where", file=self.stdout) |
| for bp in bdb.Breakpoint.bpbynumber: |
| if bp: |
| bp.bpprint(self.stdout) |
| return |
| # parse arguments; comma has lowest precedence |
| # and cannot occur in filename |
| filename = None |
| lineno = None |
| cond = None |
| comma = arg.find(',') |
| if comma > 0: |
| # parse stuff after comma: "condition" |
| cond = arg[comma+1:].lstrip() |
| arg = arg[:comma].rstrip() |
| # parse stuff before comma: [filename:]lineno | function |
| colon = arg.rfind(':') |
| funcname = None |
| if colon >= 0: |
| filename = arg[:colon].rstrip() |
| f = self.lookupmodule(filename) |
| if not f: |
| print('*** ', repr(filename), end=' ', file=self.stdout) |
| print('not found from sys.path', file=self.stdout) |
| return |
| else: |
| filename = f |
| arg = arg[colon+1:].lstrip() |
| try: |
| lineno = int(arg) |
| except ValueError as msg: |
| print('*** Bad lineno:', arg, file=self.stdout) |
| return |
| else: |
| # no colon; can be lineno or function |
| try: |
| lineno = int(arg) |
| except ValueError: |
| try: |
| func = eval(arg, |
| self.curframe.f_globals, |
| self.curframe_locals) |
| except: |
| func = arg |
| try: |
| if hasattr(func, '__func__'): |
| func = func.__func__ |
| code = func.__code__ |
| #use co_name to identify the bkpt (function names |
| #could be aliased, but co_name is invariant) |
| funcname = code.co_name |
| lineno = code.co_firstlineno |
| filename = code.co_filename |
| except: |
| # last thing to try |
| (ok, filename, ln) = self.lineinfo(arg) |
| if not ok: |
| print('*** The specified object', end=' ', file=self.stdout) |
| print(repr(arg), end=' ', file=self.stdout) |
| print('is not a function', file=self.stdout) |
| print('or was not found along sys.path.', file=self.stdout) |
| return |
| funcname = ok # ok contains a function name |
| lineno = int(ln) |
| if not filename: |
| filename = self.defaultFile() |
| # Check for reasonable breakpoint |
| line = self.checkline(filename, lineno) |
| if line: |
| # now set the break point |
| err = self.set_break(filename, line, temporary, cond, funcname) |
| if err: print('***', err, file=self.stdout) |
| else: |
| bp = self.get_breaks(filename, line)[-1] |
| print("Breakpoint %d at %s:%d" % (bp.number, |
| bp.file, |
| bp.line), file=self.stdout) |
| |
| # To be overridden in derived debuggers |
| def defaultFile(self): |
| """Produce a reasonable default.""" |
| filename = self.curframe.f_code.co_filename |
| if filename == '<string>' and self.mainpyfile: |
| filename = self.mainpyfile |
| return filename |
| |
| do_b = do_break |
| |
| def do_tbreak(self, arg): |
| self.do_break(arg, 1) |
| |
| def lineinfo(self, identifier): |
| failed = (None, None, None) |
| # Input is identifier, may be in single quotes |
| idstring = identifier.split("'") |
| if len(idstring) == 1: |
| # not in single quotes |
| id = idstring[0].strip() |
| elif len(idstring) == 3: |
| # quoted |
| id = idstring[1].strip() |
| else: |
| return failed |
| if id == '': return failed |
| parts = id.split('.') |
| # Protection for derived debuggers |
| if parts[0] == 'self': |
| del parts[0] |
| if len(parts) == 0: |
| return failed |
| # Best first guess at file to look at |
| fname = self.defaultFile() |
| if len(parts) == 1: |
| item = parts[0] |
| else: |
| # More than one part. |
| # First is module, second is method/class |
| f = self.lookupmodule(parts[0]) |
| if f: |
| fname = f |
| item = parts[1] |
| answer = find_function(item, fname) |
| return answer or failed |
| |
| def checkline(self, filename, lineno): |
| """Check whether specified line seems to be executable. |
| |
| Return `lineno` if it is, 0 if not (e.g. a docstring, comment, blank |
| line or EOF). Warning: testing is not comprehensive. |
| """ |
| line = linecache.getline(filename, lineno, self.curframe.f_globals) |
| if not line: |
| print('End of file', file=self.stdout) |
| return 0 |
| line = line.strip() |
| # Don't allow setting breakpoint at a blank line |
| if (not line or (line[0] == '#') or |
| (line[:3] == '"""') or line[:3] == "'''"): |
| print('*** Blank or comment', file=self.stdout) |
| return 0 |
| return lineno |
| |
| def do_enable(self, arg): |
| args = arg.split() |
| for i in args: |
| try: |
| i = int(i) |
| except ValueError: |
| print('Breakpoint index %r is not a number' % i, file=self.stdout) |
| continue |
| |
| if not (0 <= i < len(bdb.Breakpoint.bpbynumber)): |
| print('No breakpoint numbered', i, file=self.stdout) |
| continue |
| |
| bp = bdb.Breakpoint.bpbynumber[i] |
| if bp: |
| bp.enable() |
| |
| def do_disable(self, arg): |
| args = arg.split() |
| for i in args: |
| try: |
| i = int(i) |
| except ValueError: |
| print('Breakpoint index %r is not a number' % i, file=self.stdout) |
| continue |
| |
| if not (0 <= i < len(bdb.Breakpoint.bpbynumber)): |
| print('No breakpoint numbered', i, file=self.stdout) |
| continue |
| |
| bp = bdb.Breakpoint.bpbynumber[i] |
| if bp: |
| bp.disable() |
| |
| def do_condition(self, arg): |
| # arg is breakpoint number and condition |
| args = arg.split(' ', 1) |
| try: |
| bpnum = int(args[0].strip()) |
| except ValueError: |
| # something went wrong |
| print('Breakpoint index %r is not a number' % args[0], file=self.stdout) |
| return |
| try: |
| cond = args[1] |
| except: |
| cond = None |
| try: |
| bp = bdb.Breakpoint.bpbynumber[bpnum] |
| except IndexError: |
| print('Breakpoint index %r is not valid' % args[0], |
| file=self.stdout) |
| return |
| if bp: |
| bp.cond = cond |
| if not cond: |
| print('Breakpoint', bpnum, end=' ', file=self.stdout) |
| print('is now unconditional.', file=self.stdout) |
| |
| def do_ignore(self,arg): |
| """arg is bp number followed by ignore count.""" |
| args = arg.split() |
| try: |
| bpnum = int(args[0].strip()) |
| except ValueError: |
| # something went wrong |
| print('Breakpoint index %r is not a number' % args[0], file=self.stdout) |
| return |
| try: |
| count = int(args[1].strip()) |
| except: |
| count = 0 |
| try: |
| bp = bdb.Breakpoint.bpbynumber[bpnum] |
| except IndexError: |
| print('Breakpoint index %r is not valid' % args[0], |
| file=self.stdout) |
| return |
| if bp: |
| bp.ignore = count |
| if count > 0: |
| reply = 'Will ignore next ' |
| if count > 1: |
| reply = reply + '%d crossings' % count |
| else: |
| reply = reply + '1 crossing' |
| print(reply + ' of breakpoint %d.' % bpnum, file=self.stdout) |
| else: |
| print('Will stop next time breakpoint', end=' ', file=self.stdout) |
| print(bpnum, 'is reached.', file=self.stdout) |
| |
| def do_clear(self, arg): |
| """Three possibilities, tried in this order: |
| clear -> clear all breaks, ask for confirmation |
| clear file:lineno -> clear all breaks at file:lineno |
| clear bpno bpno ... -> clear breakpoints by number""" |
| if not arg: |
| try: |
| reply = input('Clear all breaks? ') |
| except EOFError: |
| reply = 'no' |
| reply = reply.strip().lower() |
| if reply in ('y', 'yes'): |
| self.clear_all_breaks() |
| return |
| if ':' in arg: |
| # Make sure it works for "clear C:\foo\bar.py:12" |
| i = arg.rfind(':') |
| filename = arg[:i] |
| arg = arg[i+1:] |
| try: |
| lineno = int(arg) |
| except ValueError: |
| err = "Invalid line number (%s)" % arg |
| else: |
| err = self.clear_break(filename, lineno) |
| if err: print('***', err, file=self.stdout) |
| return |
| numberlist = arg.split() |
| for i in numberlist: |
| try: |
| i = int(i) |
| except ValueError: |
| print('Breakpoint index %r is not a number' % i, file=self.stdout) |
| continue |
| |
| if not (0 <= i < len(bdb.Breakpoint.bpbynumber)): |
| print('No breakpoint numbered', i, file=self.stdout) |
| continue |
| err = self.clear_bpbynumber(i) |
| if err: |
| print('***', err, file=self.stdout) |
| else: |
| print('Deleted breakpoint', i, file=self.stdout) |
| do_cl = do_clear # 'c' is already an abbreviation for 'continue' |
| |
| def do_where(self, arg): |
| self.print_stack_trace() |
| do_w = do_where |
| do_bt = do_where |
| |
| def do_up(self, arg): |
| if self.curindex == 0: |
| print('*** Oldest frame', file=self.stdout) |
| else: |
| self.curindex = self.curindex - 1 |
| self.curframe = self.stack[self.curindex][0] |
| self.curframe_locals = self.curframe.f_locals |
| self.print_stack_entry(self.stack[self.curindex]) |
| self.lineno = None |
| do_u = do_up |
| |
| def do_down(self, arg): |
| if self.curindex + 1 == len(self.stack): |
| print('*** Newest frame', file=self.stdout) |
| else: |
| self.curindex = self.curindex + 1 |
| self.curframe = self.stack[self.curindex][0] |
| self.curframe_locals = self.curframe.f_locals |
| self.print_stack_entry(self.stack[self.curindex]) |
| self.lineno = None |
| do_d = do_down |
| |
| def do_until(self, arg): |
| self.set_until(self.curframe) |
| return 1 |
| do_unt = do_until |
| |
| def do_step(self, arg): |
| self.set_step() |
| return 1 |
| do_s = do_step |
| |
| def do_next(self, arg): |
| self.set_next(self.curframe) |
| return 1 |
| do_n = do_next |
| |
| def do_run(self, arg): |
| """Restart program by raising an exception to be caught in the main |
| debugger loop. If arguments were given, set them in sys.argv.""" |
| if arg: |
| import shlex |
| argv0 = sys.argv[0:1] |
| sys.argv = shlex.split(arg) |
| sys.argv[:0] = argv0 |
| raise Restart |
| |
| do_restart = do_run |
| |
| def do_return(self, arg): |
| self.set_return(self.curframe) |
| return 1 |
| do_r = do_return |
| |
| def do_continue(self, arg): |
| self.set_continue() |
| return 1 |
| do_c = do_cont = do_continue |
| |
| def do_jump(self, arg): |
| if self.curindex + 1 != len(self.stack): |
| print("*** You can only jump within the bottom frame", file=self.stdout) |
| return |
| try: |
| arg = int(arg) |
| except ValueError: |
| print("*** The 'jump' command requires a line number.", file=self.stdout) |
| else: |
| try: |
| # Do the jump, fix up our copy of the stack, and display the |
| # new position |
| self.curframe.f_lineno = arg |
| self.stack[self.curindex] = self.stack[self.curindex][0], arg |
| self.print_stack_entry(self.stack[self.curindex]) |
| except ValueError as e: |
| print('*** Jump failed:', e, file=self.stdout) |
| do_j = do_jump |
| |
| def do_debug(self, arg): |
| sys.settrace(None) |
| globals = self.curframe.f_globals |
| locals = self.curframe_locals |
| p = Pdb(self.completekey, self.stdin, self.stdout) |
| p.prompt = "(%s) " % self.prompt.strip() |
| print("ENTERING RECURSIVE DEBUGGER", file=self.stdout) |
| sys.call_tracing(p.run, (arg, globals, locals)) |
| print("LEAVING RECURSIVE DEBUGGER", file=self.stdout) |
| sys.settrace(self.trace_dispatch) |
| self.lastcmd = p.lastcmd |
| |
| def do_quit(self, arg): |
| self._user_requested_quit = 1 |
| self.set_quit() |
| return 1 |
| |
| do_q = do_quit |
| do_exit = do_quit |
| |
| def do_EOF(self, arg): |
| print(file=self.stdout) |
| self._user_requested_quit = 1 |
| self.set_quit() |
| return 1 |
| |
| def do_args(self, arg): |
| co = self.curframe.f_code |
| dict = self.curframe_locals |
| n = co.co_argcount |
| if co.co_flags & 4: n = n+1 |
| if co.co_flags & 8: n = n+1 |
| for i in range(n): |
| name = co.co_varnames[i] |
| print(name, '=', end=' ', file=self.stdout) |
| if name in dict: print(dict[name], file=self.stdout) |
| else: print("*** undefined ***", file=self.stdout) |
| do_a = do_args |
| |
| def do_retval(self, arg): |
| if '__return__' in self.curframe_locals: |
| print(self.curframe_locals['__return__'], file=self.stdout) |
| else: |
| print('*** Not yet returned!', file=self.stdout) |
| do_rv = do_retval |
| |
| def _getval(self, arg): |
| try: |
| return eval(arg, self.curframe.f_globals, self.curframe_locals) |
| except: |
| t, v = sys.exc_info()[:2] |
| if isinstance(t, str): |
| exc_type_name = t |
| else: exc_type_name = t.__name__ |
| print('***', exc_type_name + ':', repr(v), file=self.stdout) |
| raise |
| |
| def do_p(self, arg): |
| try: |
| print(repr(self._getval(arg)), file=self.stdout) |
| except: |
| pass |
| # make "print" an alias of "p" since print isn't a Python statement anymore |
| do_print = do_p |
| |
| def do_pp(self, arg): |
| try: |
| pprint.pprint(self._getval(arg), self.stdout) |
| except: |
| pass |
| |
| def do_list(self, arg): |
| self.lastcmd = 'list' |
| last = None |
| if arg: |
| try: |
| x = eval(arg, {}, {}) |
| if type(x) == type(()): |
| first, last = x |
| first = int(first) |
| last = int(last) |
| if last < first: |
| # Assume it's a count |
| last = first + last |
| else: |
| first = max(1, int(x) - 5) |
| except: |
| print('*** Error in argument:', repr(arg), file=self.stdout) |
| return |
| elif self.lineno is None: |
| first = max(1, self.curframe.f_lineno - 5) |
| else: |
| first = self.lineno + 1 |
| if last is None: |
| last = first + 10 |
| filename = self.curframe.f_code.co_filename |
| breaklist = self.get_file_breaks(filename) |
| try: |
| for lineno in range(first, last+1): |
| line = linecache.getline(filename, lineno, |
| self.curframe.f_globals) |
| if not line: |
| print('[EOF]', file=self.stdout) |
| break |
| else: |
| s = repr(lineno).rjust(3) |
| if len(s) < 4: s = s + ' ' |
| if lineno in breaklist: s = s + 'B' |
| else: s = s + ' ' |
| if lineno == self.curframe.f_lineno: |
| s = s + '->' |
| print(s + '\t' + line, end='', file=self.stdout) |
| self.lineno = lineno |
| except KeyboardInterrupt: |
| pass |
| do_l = do_list |
| |
| def do_whatis(self, arg): |
| try: |
| value = eval(arg, self.curframe.f_globals, |
| self.curframe_locals) |
| except: |
| t, v = sys.exc_info()[:2] |
| if type(t) == type(''): |
| exc_type_name = t |
| else: exc_type_name = t.__name__ |
| print('***', exc_type_name + ':', repr(v), file=self.stdout) |
| return |
| code = None |
| # Is it a function? |
| try: code = value.__code__ |
| except: pass |
| if code: |
| print('Function', code.co_name, file=self.stdout) |
| return |
| # Is it an instance method? |
| try: code = value.__func__.__code__ |
| except: pass |
| if code: |
| print('Method', code.co_name, file=self.stdout) |
| return |
| # None of the above... |
| print(type(value), file=self.stdout) |
| |
| def do_alias(self, arg): |
| args = arg.split() |
| if len(args) == 0: |
| keys = sorted(self.aliases.keys()) |
| for alias in keys: |
| print("%s = %s" % (alias, self.aliases[alias]), file=self.stdout) |
| return |
| if args[0] in self.aliases and len(args) == 1: |
| print("%s = %s" % (args[0], self.aliases[args[0]]), file=self.stdout) |
| else: |
| self.aliases[args[0]] = ' '.join(args[1:]) |
| |
| def do_unalias(self, arg): |
| args = arg.split() |
| if len(args) == 0: return |
| if args[0] in self.aliases: |
| del self.aliases[args[0]] |
| |
| #list of all the commands making the program resume execution. |
| commands_resuming = ['do_continue', 'do_step', 'do_next', 'do_return', |
| 'do_quit', 'do_jump'] |
| |
| # Print a traceback starting at the top stack frame. |
| # The most recently entered frame is printed last; |
| # this is different from dbx and gdb, but consistent with |
| # the Python interpreter's stack trace. |
| # It is also consistent with the up/down commands (which are |
| # compatible with dbx and gdb: up moves towards 'main()' |
| # and down moves towards the most recent stack frame). |
| |
| def print_stack_trace(self): |
| try: |
| for frame_lineno in self.stack: |
| self.print_stack_entry(frame_lineno) |
| except KeyboardInterrupt: |
| pass |
| |
| def print_stack_entry(self, frame_lineno, prompt_prefix=line_prefix): |
| frame, lineno = frame_lineno |
| if frame is self.curframe: |
| print('>', end=' ', file=self.stdout) |
| else: |
| print(' ', end=' ', file=self.stdout) |
| print(self.format_stack_entry(frame_lineno, |
| prompt_prefix), file=self.stdout) |
| |
| |
| # Help methods (derived from pdb.doc) |
| |
| def help_help(self): |
| self.help_h() |
| |
| def help_h(self): |
| print("""h(elp) |
| Without argument, print the list of available commands. |
| With a command name as argument, print help about that command |
| "help pdb" pipes the full documentation file to the $PAGER |
| "help exec" gives help on the ! command""", file=self.stdout) |
| |
| def help_where(self): |
| self.help_w() |
| |
| def help_w(self): |
| print("""w(here) |
| Print a stack trace, with the most recent frame at the bottom. |
| An arrow indicates the "current frame", which determines the |
| context of most commands. 'bt' is an alias for this command.""", file=self.stdout) |
| |
| help_bt = help_w |
| |
| def help_down(self): |
| self.help_d() |
| |
| def help_d(self): |
| print("""d(own) |
| Move the current frame one level down in the stack trace |
| (to a newer frame).""", file=self.stdout) |
| |
| def help_up(self): |
| self.help_u() |
| |
| def help_u(self): |
| print("""u(p) |
| Move the current frame one level up in the stack trace |
| (to an older frame).""", file=self.stdout) |
| |
| def help_break(self): |
| self.help_b() |
| |
| def help_b(self): |
| print("""b(reak) ([file:]lineno | function) [, condition] |
| With a line number argument, set a break there in the current |
| file. With a function name, set a break at first executable line |
| of that function. Without argument, list all breaks. If a second |
| argument is present, it is a string specifying an expression |
| which must evaluate to true before the breakpoint is honored. |
| |
| The line number may be prefixed with a filename and a colon, |
| to specify a breakpoint in another file (probably one that |
| hasn't been loaded yet). The file is searched for on sys.path; |
| the .py suffix may be omitted.""", file=self.stdout) |
| |
| def help_clear(self): |
| self.help_cl() |
| |
| def help_cl(self): |
| print("cl(ear) filename:lineno", file=self.stdout) |
| print("""cl(ear) [bpnumber [bpnumber...]] |
| With a space separated list of breakpoint numbers, clear |
| those breakpoints. Without argument, clear all breaks (but |
| first ask confirmation). With a filename:lineno argument, |
| clear all breaks at that line in that file.""", file=self.stdout) |
| |
| def help_tbreak(self): |
| print("""tbreak same arguments as break, but breakpoint is |
| removed when first hit.""", file=self.stdout) |
| |
| def help_enable(self): |
| print("""enable bpnumber [bpnumber ...] |
| Enables the breakpoints given as a space separated list of |
| bp numbers.""", file=self.stdout) |
| |
| def help_disable(self): |
| print("""disable bpnumber [bpnumber ...] |
| Disables the breakpoints given as a space separated list of |
| bp numbers.""", file=self.stdout) |
| |
| def help_ignore(self): |
| print("""ignore bpnumber count |
| Sets the ignore count for the given breakpoint number. A breakpoint |
| becomes active when the ignore count is zero. When non-zero, the |
| count is decremented each time the breakpoint is reached and the |
| breakpoint is not disabled and any associated condition evaluates |
| to true.""", file=self.stdout) |
| |
| def help_condition(self): |
| print("""condition bpnumber str_condition |
| str_condition is a string specifying an expression which |
| must evaluate to true before the breakpoint is honored. |
| If str_condition is absent, any existing condition is removed; |
| i.e., the breakpoint is made unconditional.""", file=self.stdout) |
| |
| def help_step(self): |
| self.help_s() |
| |
| def help_s(self): |
| print("""s(tep) |
| Execute the current line, stop at the first possible occasion |
| (either in a function that is called or in the current function).""", file=self.stdout) |
| |
| def help_until(self): |
| self.help_unt() |
| |
| def help_unt(self): |
| print("""unt(il) |
| Continue execution until the line with a number greater than the current |
| one is reached or until the current frame returns""") |
| |
| def help_next(self): |
| self.help_n() |
| |
| def help_n(self): |
| print("""n(ext) |
| Continue execution until the next line in the current function |
| is reached or it returns.""", file=self.stdout) |
| |
| def help_return(self): |
| self.help_r() |
| |
| def help_r(self): |
| print("""r(eturn) |
| Continue execution until the current function returns.""", file=self.stdout) |
| |
| def help_continue(self): |
| self.help_c() |
| |
| def help_cont(self): |
| self.help_c() |
| |
| def help_c(self): |
| print("""c(ont(inue)) |
| Continue execution, only stop when a breakpoint is encountered.""", file=self.stdout) |
| |
| def help_jump(self): |
| self.help_j() |
| |
| def help_j(self): |
| print("""j(ump) lineno |
| Set the next line that will be executed.""", file=self.stdout) |
| |
| def help_debug(self): |
| print("""debug code |
| Enter a recursive debugger that steps through the code argument |
| (which is an arbitrary expression or statement to be executed |
| in the current environment).""", file=self.stdout) |
| |
| def help_list(self): |
| self.help_l() |
| |
| def help_l(self): |
| print("""l(ist) [first [,last]] |
| List source code for the current file. |
| Without arguments, list 11 lines around the current line |
| or continue the previous listing. |
| With one argument, list 11 lines starting at that line. |
| With two arguments, list the given range; |
| if the second argument is less than the first, it is a count.""", file=self.stdout) |
| |
| def help_args(self): |
| self.help_a() |
| |
| def help_a(self): |
| print("""a(rgs) |
| Print the arguments of the current function.""", file=self.stdout) |
| |
| def help_p(self): |
| print("""p(rint) expression |
| Print the value of the expression.""", file=self.stdout) |
| |
| def help_pp(self): |
| print("""pp expression |
| Pretty-print the value of the expression.""", file=self.stdout) |
| |
| def help_exec(self): |
| print("""(!) statement |
| Execute the (one-line) statement in the context of |
| the current stack frame. |
| The exclamation point can be omitted unless the first word |
| of the statement resembles a debugger command. |
| To assign to a global variable you must always prefix the |
| command with a 'global' command, e.g.: |
| (Pdb) global list_options; list_options = ['-l'] |
| (Pdb)""", file=self.stdout) |
| |
| def help_run(self): |
| print("""run [args...] |
| Restart the debugged python program. If a string is supplied, it is |
| splitted with "shlex" and the result is used as the new sys.argv. |
| History, breakpoints, actions and debugger options are preserved. |
| "restart" is an alias for "run".""") |
| |
| help_restart = help_run |
| |
| def help_quit(self): |
| self.help_q() |
| |
| def help_q(self): |
| print("""q(uit) or exit - Quit from the debugger. |
| The program being executed is aborted.""", file=self.stdout) |
| |
| help_exit = help_q |
| |
| def help_whatis(self): |
| print("""whatis arg |
| Prints the type of the argument.""", file=self.stdout) |
| |
| def help_EOF(self): |
| print("""EOF |
| Handles the receipt of EOF as a command.""", file=self.stdout) |
| |
| def help_alias(self): |
| print("""alias [name [command [parameter parameter ...] ]] |
| Creates an alias called 'name' the executes 'command'. The command |
| must *not* be enclosed in quotes. Replaceable parameters are |
| indicated by %1, %2, and so on, while %* is replaced by all the |
| parameters. If no command is given, the current alias for name |
| is shown. If no name is given, all aliases are listed. |
| |
| Aliases may be nested and can contain anything that can be |
| legally typed at the pdb prompt. Note! You *can* override |
| internal pdb commands with aliases! Those internal commands |
| are then hidden until the alias is removed. Aliasing is recursively |
| applied to the first word of the command line; all other words |
| in the line are left alone. |
| |
| Some useful aliases (especially when placed in the .pdbrc file) are: |
| |
| #Print instance variables (usage "pi classInst") |
| alias pi for k in %1.__dict__.keys(): print "%1.",k,"=",%1.__dict__[k] |
| |
| #Print instance variables in self |
| alias ps pi self |
| """, file=self.stdout) |
| |
| def help_unalias(self): |
| print("""unalias name |
| Deletes the specified alias.""", file=self.stdout) |
| |
| def help_commands(self): |
| print("""commands [bpnumber] |
| (com) ... |
| (com) end |
| (Pdb) |
| |
| Specify a list of commands for breakpoint number bpnumber. The |
| commands themselves appear on the following lines. Type a line |
| containing just 'end' to terminate the commands. |
| |
| To remove all commands from a breakpoint, type commands and |
| follow it immediately with end; that is, give no commands. |
| |
| With no bpnumber argument, commands refers to the last |
| breakpoint set. |
| |
| You can use breakpoint commands to start your program up again. |
| Simply use the continue command, or step, or any other |
| command that resumes execution. |
| |
| Specifying any command resuming execution (currently continue, |
| step, next, return, jump, quit and their abbreviations) terminates |
| the command list (as if that command was immediately followed by end). |
| This is because any time you resume execution |
| (even with a simple next or step), you may encounter |
| another breakpoint--which could have its own command list, leading to |
| ambiguities about which list to execute. |
| |
| If you use the 'silent' command in the command list, the |
| usual message about stopping at a breakpoint is not printed. This may |
| be desirable for breakpoints that are to print a specific message and |
| then continue. If none of the other commands print anything, you |
| see no sign that the breakpoint was reached. |
| """, file=self.stdout) |
| |
| def help_pdb(self): |
| help() |
| |
| def lookupmodule(self, filename): |
| """Helper function for break/clear parsing -- may be overridden. |
| |
| lookupmodule() translates (possibly incomplete) file or module name |
| into an absolute file name. |
| """ |
| if os.path.isabs(filename) and os.path.exists(filename): |
| return filename |
| f = os.path.join(sys.path[0], filename) |
| if os.path.exists(f) and self.canonic(f) == self.mainpyfile: |
| return f |
| root, ext = os.path.splitext(filename) |
| if ext == '': |
| filename = filename + '.py' |
| if os.path.isabs(filename): |
| return filename |
| for dirname in sys.path: |
| while os.path.islink(dirname): |
| dirname = os.readlink(dirname) |
| fullname = os.path.join(dirname, filename) |
| if os.path.exists(fullname): |
| return fullname |
| return None |
| |
| def _runscript(self, filename): |
| # The script has to run in __main__ namespace (or imports from |
| # __main__ will break). |
| # |
| # So we clear up the __main__ and set several special variables |
| # (this gets rid of pdb's globals and cleans old variables on restarts). |
| import __main__ |
| __main__.__dict__.clear() |
| __main__.__dict__.update({"__name__" : "__main__", |
| "__file__" : filename, |
| "__builtins__": __builtins__, |
| }) |
| |
| # When bdb sets tracing, a number of call and line events happens |
| # BEFORE debugger even reaches user's code (and the exact sequence of |
| # events depends on python version). So we take special measures to |
| # avoid stopping before we reach the main script (see user_line and |
| # user_call for details). |
| self._wait_for_mainpyfile = 1 |
| self.mainpyfile = self.canonic(filename) |
| self._user_requested_quit = 0 |
| with open(filename, "rb") as fp: |
| statement = "exec(compile(%r, %r, 'exec'))" % \ |
| (fp.read(), self.mainpyfile) |
| self.run(statement) |
| |
| # Simplified interface |
| |
| def run(statement, globals=None, locals=None): |
| Pdb().run(statement, globals, locals) |
| |
| def runeval(expression, globals=None, locals=None): |
| return Pdb().runeval(expression, globals, locals) |
| |
| def runctx(statement, globals, locals): |
| # B/W compatibility |
| run(statement, globals, locals) |
| |
| def runcall(*args, **kwds): |
| return Pdb().runcall(*args, **kwds) |
| |
| def set_trace(): |
| Pdb().set_trace(sys._getframe().f_back) |
| |
| # Post-Mortem interface |
| |
| def post_mortem(t=None): |
| # handling the default |
| if t is None: |
| # sys.exc_info() returns (type, value, traceback) if an exception is |
| # being handled, otherwise it returns None |
| t = sys.exc_info()[2] |
| if t is None: |
| raise ValueError("A valid traceback must be passed if no " |
| "exception is being handled") |
| |
| p = Pdb() |
| p.reset() |
| p.interaction(None, t) |
| |
| def pm(): |
| post_mortem(sys.last_traceback) |
| |
| |
| # Main program for testing |
| |
| TESTCMD = 'import x; x.main()' |
| |
| def test(): |
| run(TESTCMD) |
| |
| # print help |
| def help(): |
| for dirname in sys.path: |
| fullname = os.path.join(dirname, 'pdb.doc') |
| if os.path.exists(fullname): |
| sts = os.system('${PAGER-more} '+fullname) |
| if sts: print('*** Pager exit status:', sts) |
| break |
| else: |
| print('Sorry, can\'t find the help file "pdb.doc"', end=' ') |
| print('along the Python search path') |
| |
| def main(): |
| if not sys.argv[1:] or sys.argv[1] in ("--help", "-h"): |
| print("usage: pdb.py scriptfile [arg] ...") |
| sys.exit(2) |
| |
| mainpyfile = sys.argv[1] # Get script filename |
| if not os.path.exists(mainpyfile): |
| print('Error:', mainpyfile, 'does not exist') |
| sys.exit(1) |
| |
| del sys.argv[0] # Hide "pdb.py" from argument list |
| |
| # Replace pdb's dir with script's dir in front of module search path. |
| sys.path[0] = os.path.dirname(mainpyfile) |
| |
| # Note on saving/restoring sys.argv: it's a good idea when sys.argv was |
| # modified by the script being debugged. It's a bad idea when it was |
| # changed by the user from the command line. There is a "restart" command |
| # which allows explicit specification of command line arguments. |
| pdb = Pdb() |
| while 1: |
| try: |
| pdb._runscript(mainpyfile) |
| if pdb._user_requested_quit: |
| break |
| print("The program finished and will be restarted") |
| except Restart: |
| print("Restarting", mainpyfile, "with arguments:") |
| print("\t" + " ".join(sys.argv[1:])) |
| except SystemExit: |
| # In most cases SystemExit does not warrant a post-mortem session. |
| print("The program exited via sys.exit(). Exit status: ", end=' ') |
| print(sys.exc_info()[1]) |
| except: |
| traceback.print_exc() |
| print("Uncaught exception. Entering post mortem debugging") |
| print("Running 'cont' or 'step' will restart the program") |
| t = sys.exc_info()[2] |
| pdb.interaction(None, t) |
| print("Post mortem debugger finished. The " + mainpyfile + |
| " will be restarted") |
| |
| |
| # When invoked as main program, invoke the debugger on a script |
| if __name__ == '__main__': |
| import pdb |
| pdb.main() |