mirror of
				https://github.com/python/cpython.git
				synced 2025-10-31 05:31:20 +00:00 
			
		
		
		
	
		
			
				
	
	
		
			921 lines
		
	
	
	
		
			24 KiB
		
	
	
	
		
			Python
		
	
	
		
			Executable file
		
	
	
	
	
			
		
		
	
	
			921 lines
		
	
	
	
		
			24 KiB
		
	
	
	
		
			Python
		
	
	
		
			Executable file
		
	
	
	
	
| #! /usr/bin/env python
 | |
| 
 | |
| # pdb.py -- finally, a Python debugger!
 | |
| 
 | |
| # (See pdb.doc for documentation.)
 | |
| 
 | |
| import string
 | |
| import sys
 | |
| import linecache
 | |
| import cmd
 | |
| import bdb
 | |
| import repr
 | |
| import os
 | |
| 
 | |
| 
 | |
| # 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):
 | |
| 		bdb.Bdb.__init__(self)
 | |
| 		cmd.Cmd.__init__(self)
 | |
| 		self.prompt = '(Pdb) '
 | |
| 		self.lineinfoCmd = 'egrep -n "def *%s *[(:]" %s /dev/null'
 | |
| 		self.aliases = {}
 | |
| 		# Try to load readline if it exists
 | |
| 		try:
 | |
| 			import readline
 | |
| 		except ImportError:
 | |
| 			pass
 | |
| 
 | |
| 		# Read $HOME/.pdbrc and ./.pdbrc
 | |
| 		self.rcLines = []
 | |
| 		if os.environ.has_key('HOME'):
 | |
| 			envHome = os.environ['HOME']
 | |
| 			try:
 | |
| 				rcFile = open (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()
 | |
| 	
 | |
| 	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]
 | |
| 		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 (except user_call, for now)
 | |
| 	
 | |
| 	def user_line(self, frame):
 | |
| 		# This function is called when we stop or break at this line
 | |
| 		self.interaction(frame, None)
 | |
| 	
 | |
| 	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--'
 | |
| 		self.interaction(frame, None)
 | |
| 	
 | |
| 	def user_exception(self, frame, (exc_type, exc_value, exc_traceback)):
 | |
| 		# This function is called if an exception occurs,
 | |
| 		# but only if we are to stop at or just below this level
 | |
| 		frame.f_locals['__exception__'] = exc_type, exc_value
 | |
| 		if type(exc_type) == type(''):
 | |
| 			exc_type_name = exc_type
 | |
| 		else: exc_type_name = exc_type.__name__
 | |
| 		print exc_type_name + ':', repr.repr(exc_value)
 | |
| 		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 default(self, line):
 | |
| 		if line[:1] == '!': line = line[1:]
 | |
| 		locals = self.curframe.f_locals
 | |
| 		globals = self.curframe.f_globals
 | |
| 		try:
 | |
| 			code = compile(line + '\n', '<stdin>', 'single')
 | |
| 			exec code in globals, 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 + ':', v
 | |
| 
 | |
| 	def precmd(self, line):
 | |
| 		# Handle alias expansion and ';;' separator
 | |
| 		if not line:
 | |
| 			return line
 | |
| 		args = string.split(line)
 | |
| 		while self.aliases.has_key(args[0]):
 | |
| 			line = self.aliases[args[0]]
 | |
| 			ii = 1
 | |
| 			for tmpArg in args[1:]:
 | |
| 				line = string.replace(line, "%" + str(ii),
 | |
| 						      tmpArg)
 | |
| 				ii = ii + 1
 | |
| 			line = string.replace(line, "%*",
 | |
| 					      string.join(args[1:], ' '))
 | |
| 			args = string.split(line)
 | |
| 		# split into ';;' separated commands
 | |
| 		# unless it's an alias command
 | |
| 		if args[0] != 'alias':
 | |
| 			marker = string.find(line, ';;')
 | |
| 			if marker >= 0:
 | |
| 				# queue up everything after marker
 | |
| 				next = string.lstrip(line[marker+2:])
 | |
| 				self.cmdqueue.append(next)
 | |
| 				line = string.rstrip(line[:marker])
 | |
| 		return line
 | |
| 
 | |
| 	# 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_EOF(self, arg):
 | |
| 		return 0	# Don't die on EOF
 | |
| 
 | |
| 	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"
 | |
| 				for bp in bdb.Breakpoint.bpbynumber:
 | |
| 					if bp:
 | |
| 						bp.bpprint()
 | |
| 			return
 | |
| 		# parse arguments; comma has lowest precendence
 | |
| 		# and cannot occur in filename
 | |
| 		filename = None
 | |
| 		lineno = None
 | |
| 		cond = None
 | |
| 		comma = string.find(arg, ',')
 | |
| 		if comma > 0:
 | |
| 			# parse stuff after comma: "condition"
 | |
| 			cond = string.lstrip(arg[comma+1:])
 | |
| 			arg = string.rstrip(arg[:comma])
 | |
| 		# parse stuff before comma: [filename:]lineno | function
 | |
| 		colon = string.rfind(arg, ':')
 | |
| 		if colon >= 0:
 | |
| 			filename = string.rstrip(arg[:colon])
 | |
| 			f = self.lookupmodule(filename)
 | |
| 			if not f:
 | |
| 				print '*** ', `filename`,
 | |
| 				print 'not found from sys.path'
 | |
| 				return
 | |
| 			else:
 | |
| 				filename = f
 | |
| 			arg = string.lstrip(arg[colon+1:])
 | |
| 			try:
 | |
| 				lineno = int(arg)
 | |
| 			except ValueError, msg:
 | |
| 				print '*** Bad lineno:', arg
 | |
| 				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.f_locals)
 | |
| 				except:
 | |
| 					func = arg
 | |
| 				try:
 | |
| 					if hasattr(func, 'im_func'):
 | |
| 						func = func.im_func
 | |
| 					code = func.func_code
 | |
| 					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',
 | |
| 					    print `arg`,
 | |
| 					    print 'is not a function'
 | |
| 					    print ('or was not found '
 | |
| 						   'along sys.path.')
 | |
| 					    return
 | |
| 					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)
 | |
| 			if err: print '***', err
 | |
| 			else:
 | |
| 				bp = self.get_breaks(filename, line)[-1]
 | |
| 				print "Breakpoint %d at %s:%d" % (bp.number,
 | |
| 								  bp.file,
 | |
| 								  bp.line)
 | |
| 
 | |
| 	# To be overridden in derived debuggers
 | |
| 	def defaultFile(self):
 | |
| 		# Produce a reasonable default
 | |
| 		filename = self.curframe.f_code.co_filename
 | |
| 		if filename == '<string>' and mainpyfile:
 | |
| 			filename = 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 = string.split(identifier, "'")
 | |
| 		if len(idstring) == 1:
 | |
| 			# not in single quotes
 | |
| 			id = string.strip(idstring[0])
 | |
| 		elif len(idstring) == 3:
 | |
| 			# quoted
 | |
| 			id = string.strip(idstring[1])
 | |
| 		else:
 | |
| 			return failed
 | |
| 		if id == '': return failed
 | |
| 		parts = string.split(id, '.')
 | |
| 		# 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]
 | |
| 		grepstring = self.lineinfoCmd % (item, fname)
 | |
| 		answer = os.popen(grepstring, 'r').readline()
 | |
| 		if answer:
 | |
| 			f, line, junk = string.split(answer, ':', 2)
 | |
| 			return(item, f,line)
 | |
| 		else:
 | |
| 			return failed
 | |
| 		
 | |
| 	def checkline(self, filename, lineno):
 | |
| 		"""Return line number of first line at or after input
 | |
| 		argument such that if the input points to a 'def', the
 | |
| 		returned line number is the first
 | |
| 		non-blank/non-comment line to follow.  If the input
 | |
| 		points to a blank or comment line, return 0.  At end
 | |
| 		of file, also return 0."""
 | |
| 
 | |
| 		line = linecache.getline(filename, lineno)
 | |
| 		if not line:
 | |
| 			print 'End of file'
 | |
| 			return 0
 | |
| 		line = string.strip(line)
 | |
| 		# 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'
 | |
| 			return 0
 | |
| 		# When a file is read in and a breakpoint is at
 | |
| 		# the 'def' statement, the system stops there at
 | |
| 		# code parse time.  We don't want that, so all breakpoints
 | |
| 		# set at 'def' statements are moved one line onward
 | |
| 		if line[:3] == 'def':
 | |
| 			incomment = ''
 | |
| 			while 1:
 | |
| 				lineno = lineno+1
 | |
| 				line = linecache.getline(filename, lineno)
 | |
| 				if not line:
 | |
| 					print 'end of file'
 | |
| 					return 0
 | |
| 				line = string.strip(line)
 | |
| 				if incomment:
 | |
| 					if len(line) < 3: continue
 | |
| 					if (line[-3:] == incomment):
 | |
| 						incomment = ''
 | |
| 					continue
 | |
| 				if not line: continue	# Blank line
 | |
| 				if len(line) >= 3:
 | |
| 					if (line[:3] == '"""'
 | |
| 					    or line[:3] == "'''"):
 | |
| 						incomment = line[:3]
 | |
| 						continue
 | |
| 				if line[0] != '#': break
 | |
| 		return lineno
 | |
| 
 | |
| 	def do_enable(self, arg):
 | |
| 		args = string.split(arg)
 | |
| 		for i in args:
 | |
| 			bp = bdb.Breakpoint.bpbynumber[int(i)]
 | |
| 			if bp:
 | |
| 				bp.enable()
 | |
| 
 | |
| 	def do_disable(self, arg):
 | |
| 		args = string.split(arg)
 | |
| 		for i in args:
 | |
| 			bp = bdb.Breakpoint.bpbynumber[int(i)]
 | |
| 			if bp:
 | |
| 				bp.disable()
 | |
| 
 | |
| 	def do_condition(self, arg):
 | |
| 		# arg is breakpoint number and condition
 | |
| 		args = string.split(arg, ' ', 1)
 | |
| 		bpnum = int(string.strip(args[0]))
 | |
| 		try:
 | |
| 			cond = args[1]
 | |
| 		except:
 | |
| 			cond = None
 | |
| 		bp = bdb.Breakpoint.bpbynumber[bpnum]
 | |
| 		if bp:
 | |
| 			bp.cond = cond
 | |
| 			if not cond:
 | |
| 				print 'Breakpoint', bpnum,
 | |
| 				print 'is now unconditional.'
 | |
| 
 | |
| 	def do_ignore(self,arg):
 | |
| 		# arg is bp number followed by ignore count
 | |
| 		args = string.split(arg)
 | |
| 		bpnum = int(string.strip(args[0]))
 | |
| 		try:
 | |
| 			count = int(string.strip(args[1]))
 | |
| 		except:
 | |
| 			count = 0
 | |
| 		bp = bdb.Breakpoint.bpbynumber[bpnum]
 | |
| 		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
 | |
| 			else:
 | |
| 				print 'Will stop next time breakpoint',
 | |
| 				print bpnum, 'is reached.'
 | |
| 
 | |
| 	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 = raw_input('Clear all breaks? ')
 | |
| 			except EOFError:
 | |
| 				reply = 'no'
 | |
| 			reply = string.lower(string.strip(reply))
 | |
| 			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 = string.rfind(arg, ':')
 | |
| 			filename = arg[:i]
 | |
| 			arg = arg[i+1:]
 | |
| 			try:
 | |
| 				lineno = int(arg)
 | |
| 			except:
 | |
| 				err = "Invalid line number (%s)" % arg
 | |
| 			else:
 | |
| 				err = self.clear_break(filename, lineno)
 | |
| 			if err: print '***', err
 | |
| 			return
 | |
| 		numberlist = string.split(arg)
 | |
| 		for i in numberlist:
 | |
| 			err = self.clear_bpbynumber(i)
 | |
| 			if err:
 | |
| 				print '***', err
 | |
| 			else:
 | |
| 				print 'Deleted breakpoint %s ' % (i,)
 | |
| 	do_cl = do_clear # 'c' is already an abbreviation for 'continue'
 | |
| 	
 | |
| 	def do_where(self, arg):
 | |
| 		self.print_stack_trace()
 | |
| 	do_w = do_where
 | |
| 	
 | |
| 	def do_up(self, arg):
 | |
| 		if self.curindex == 0:
 | |
| 			print '*** Oldest frame'
 | |
| 		else:
 | |
| 			self.curindex = self.curindex - 1
 | |
| 			self.curframe = self.stack[self.curindex][0]
 | |
| 			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'
 | |
| 		else:
 | |
| 			self.curindex = self.curindex + 1
 | |
| 			self.curframe = self.stack[self.curindex][0]
 | |
| 			self.print_stack_entry(self.stack[self.curindex])
 | |
| 			self.lineno = None
 | |
| 	do_d = do_down
 | |
| 	
 | |
| 	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_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_quit(self, arg):
 | |
| 		self.set_quit()
 | |
| 		return 1
 | |
| 	do_q = do_quit
 | |
| 	
 | |
| 	def do_args(self, arg):
 | |
| 		f = self.curframe
 | |
| 		co = f.f_code
 | |
| 		dict = f.f_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, '=',
 | |
| 			if dict.has_key(name): print dict[name]
 | |
| 			else: print "*** undefined ***"
 | |
| 	do_a = do_args
 | |
| 	
 | |
| 	def do_retval(self, arg):
 | |
| 		if self.curframe.f_locals.has_key('__return__'):
 | |
| 			print self.curframe.f_locals['__return__']
 | |
| 		else:
 | |
| 			print '*** Not yet returned!'
 | |
| 	do_rv = do_retval
 | |
| 	
 | |
| 	def do_p(self, arg):
 | |
| 		try:
 | |
| 			value = eval(arg, self.curframe.f_globals,
 | |
| 					self.curframe.f_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 + ':', `v`
 | |
| 			return
 | |
| 
 | |
| 		print `value`
 | |
| 
 | |
| 	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:', `arg`
 | |
| 				return
 | |
| 		elif self.lineno is None:
 | |
| 			first = max(1, self.curframe.f_lineno - 5)
 | |
| 		else:
 | |
| 			first = self.lineno + 1
 | |
| 		if last == 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)
 | |
| 				if not line:
 | |
| 					print '[EOF]'
 | |
| 					break
 | |
| 				else:
 | |
| 					s = string.rjust(`lineno`, 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,
 | |
| 					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.f_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 + ':', `v`
 | |
| 			return
 | |
| 		code = None
 | |
| 		# Is it a function?
 | |
| 		try: code = value.func_code
 | |
| 		except: pass
 | |
| 		if code:
 | |
| 			print 'Function', code.co_name
 | |
| 			return
 | |
| 		# Is it an instance method?
 | |
| 		try: code = value.im_func.func_code
 | |
| 		except: pass
 | |
| 		if code:
 | |
| 			print 'Method', code.co_name
 | |
| 			return
 | |
| 		# None of the above...
 | |
| 		print type(value)
 | |
| 
 | |
| 	def do_alias(self, arg):
 | |
| 		args = string.split (arg)
 | |
| 		if len(args) == 0:
 | |
| 			keys = self.aliases.keys()
 | |
| 			keys.sort()
 | |
| 			for alias in keys:
 | |
| 				print "%s = %s" % (alias, self.aliases[alias])
 | |
| 			return
 | |
| 		if self.aliases.has_key(args[0]) and len (args) == 1:
 | |
| 			print "%s = %s" % (args[0], self.aliases[args[0]])
 | |
| 		else:
 | |
| 			self.aliases[args[0]] = string.join(args[1:], ' ')
 | |
| 
 | |
| 	def do_unalias(self, arg):
 | |
| 		args = string.split (arg)
 | |
| 		if len(args) == 0: return
 | |
| 		if self.aliases.has_key(args[0]):
 | |
| 			del self.aliases[args[0]]
 | |
| 
 | |
| 	# 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 '>',
 | |
| 		else:
 | |
| 			print ' ',
 | |
| 		print self.format_stack_entry(frame_lineno, prompt_prefix)
 | |
| 
 | |
| 
 | |
| 	# 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"""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	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 an older frame)."""
 | |
| 
 | |
| 	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 a newer frame)."""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	def help_clear(self):
 | |
| 		self.help_cl()
 | |
| 
 | |
| 	def help_cl(self):
 | |
| 		print "cl(ear) filename:lineno"
 | |
| 		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.
 | |
| 
 | |
| 	Note that the argument is different from previous versions of
 | |
| 	the debugger (in python distributions 1.5.1 and before) where
 | |
| 	a linenumber was used instead of either filename:lineno or
 | |
| 	breakpoint numbers."""
 | |
| 
 | |
| 	def help_tbreak(self):
 | |
| 		print """tbreak  same arguments as break, but breakpoint is
 | |
| 	removed when first hit."""
 | |
| 
 | |
| 	def help_enable(self):
 | |
| 		print """enable bpnumber [bpnumber ...]
 | |
| 	Enables the breakpoints given as a space separated list of
 | |
| 	bp numbers."""
 | |
| 
 | |
| 	def help_disable(self):
 | |
| 		print """disable bpnumber [bpnumber ...]
 | |
| 	Disables the breakpoints given as a space separated list of
 | |
| 	bp numbers."""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	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)."""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	def help_return(self):
 | |
| 		self.help_r()
 | |
| 
 | |
| 	def help_r(self):
 | |
| 		print """r(eturn)
 | |
| 	Continue execution until the current function returns."""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	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."""
 | |
| 
 | |
| 	def help_args(self):
 | |
| 		self.help_a()
 | |
| 
 | |
| 	def help_a(self):
 | |
| 		print """a(rgs)
 | |
| 	Print the arguments of the current function."""
 | |
| 
 | |
| 	def help_p(self):
 | |
| 		print """p expression
 | |
| 	Print the value of the expression."""
 | |
| 
 | |
| 	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)"""
 | |
| 
 | |
| 	def help_quit(self):
 | |
| 		self.help_q()
 | |
| 
 | |
| 	def help_q(self):
 | |
| 		print """q(uit)	Quit from the debugger.
 | |
| 	The program being executed is aborted."""
 | |
| 
 | |
| 	def help_whatis(self):
 | |
| 		print """whatis arg
 | |
| 	Prints the type of the argument."""
 | |
| 
 | |
| 	def help_EOF(self):
 | |
| 		print """EOF
 | |
| 	Handles the receipt of EOF as a command."""
 | |
| 
 | |
| 	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
 | |
| 	"""
 | |
| 
 | |
| 	def help_unalias(self):
 | |
| 		print """unalias name
 | |
| 	Deletes the specified alias."""
 | |
| 
 | |
| 	def help_pdb(self):
 | |
| 		help()
 | |
| 
 | |
| 	# Helper function for break/clear parsing -- may be overridden
 | |
| 
 | |
| 	def lookupmodule(self, filename):
 | |
| 		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
 | |
| 
 | |
| # 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):
 | |
| 	return apply(Pdb().runcall, args)
 | |
| 
 | |
| def set_trace():
 | |
| 	Pdb().set_trace()
 | |
| 
 | |
| # Post-Mortem interface
 | |
| 
 | |
| def post_mortem(t):
 | |
| 	p = Pdb()
 | |
| 	p.reset()
 | |
| 	while t.tb_next <> None: t = t.tb_next
 | |
| 	p.interaction(t.tb_frame, 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"',
 | |
| 		print 'along the Python search path'
 | |
| 
 | |
| mainmodule = ''
 | |
| mainpyfile = ''
 | |
| 
 | |
| # When invoked as main program, invoke the debugger on a script
 | |
| if __name__=='__main__':
 | |
| 	global mainmodule, mainpyfile
 | |
| 	if not sys.argv[1:]:
 | |
| 		print "usage: pdb.py scriptfile [arg] ..."
 | |
| 		sys.exit(2)
 | |
| 
 | |
| 	mainpyfile = filename = sys.argv[1]	# Get script filename
 | |
| 	if not os.path.exists(filename):
 | |
| 		print 'Error:', `filename`, 'does not exist'
 | |
| 		sys.exit(1)
 | |
| 	mainmodule = os.path.basename(filename)
 | |
| 	del sys.argv[0]		# Hide "pdb.py" from argument list
 | |
| 
 | |
| 	# Insert script directory in front of module search path
 | |
| 	sys.path.insert(0, os.path.dirname(filename))
 | |
| 
 | |
| 	run('execfile(' + `filename` + ')')
 | 
