blob: 57851aa729d86e08d2e20d120b9fe06e5c26ea6f [file] [log] [blame]
Guido van Rossum217a5fa1990-12-26 15:40:07 +00001# Print tracebacks, with a dump of local variables.
2# Also an interactive stack trace browser.
Guido van Rossuma62b1001995-08-10 19:43:04 +00003# Note -- this module is obsolete -- use pdb.pm() instead.
Guido van Rossum217a5fa1990-12-26 15:40:07 +00004
5import sys
Guido van Rossum9542c581992-01-12 23:27:56 +00006import os
Guido van Rossum217a5fa1990-12-26 15:40:07 +00007from stat import *
Guido van Rossum9542c581992-01-12 23:27:56 +00008import linecache
Guido van Rossum217a5fa1990-12-26 15:40:07 +00009
10def br(): browser(sys.last_traceback)
11
12def tb(): printtb(sys.last_traceback)
13
14def browser(tb):
15 if not tb:
16 print 'No traceback.'
17 return
18 tblist = []
19 while tb:
20 tblist.append(tb)
21 tb = tb.tb_next
22 ptr = len(tblist)-1
23 tb = tblist[ptr]
24 while 1:
Fred Drake132dce22000-12-12 23:11:42 +000025 if tb != tblist[ptr]:
Guido van Rossum217a5fa1990-12-26 15:40:07 +000026 tb = tblist[ptr]
27 print `ptr` + ':',
28 printtbheader(tb)
29 try:
30 line = raw_input('TB: ')
31 except KeyboardInterrupt:
32 print '\n[Interrupted]'
33 break
34 except EOFError:
35 print '\n[EOF]'
36 break
Eric S. Raymondfc170b12001-02-09 11:51:27 +000037 cmd = line.strip()
Guido van Rossum217a5fa1990-12-26 15:40:07 +000038 if cmd:
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000039 if cmd == 'quit':
Guido van Rossum217a5fa1990-12-26 15:40:07 +000040 break
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000041 elif cmd == 'list':
Guido van Rossum217a5fa1990-12-26 15:40:07 +000042 browserlist(tb)
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000043 elif cmd == 'up':
Guido van Rossum217a5fa1990-12-26 15:40:07 +000044 if ptr-1 >= 0: ptr = ptr-1
45 else: print 'Bottom of stack.'
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000046 elif cmd == 'down':
Guido van Rossum217a5fa1990-12-26 15:40:07 +000047 if ptr+1 < len(tblist): ptr = ptr+1
48 else: print 'Top of stack.'
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000049 elif cmd == 'locals':
Guido van Rossum217a5fa1990-12-26 15:40:07 +000050 printsymbols(tb.tb_frame.f_locals)
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000051 elif cmd == 'globals':
Guido van Rossum217a5fa1990-12-26 15:40:07 +000052 printsymbols(tb.tb_frame.f_globals)
53 elif cmd in ('?', 'help'):
54 browserhelp()
55 else:
56 browserexec(tb, cmd)
57
58def browserlist(tb):
59 filename = tb.tb_frame.f_code.co_filename
60 lineno = tb.tb_lineno
61 last = lineno
62 first = max(1, last-10)
63 for i in range(first, last+1):
Eric S. Raymondfc170b12001-02-09 11:51:27 +000064 if i == lineno: prefix = '***' + `i`.rjust(4) + ':'
65 else: prefix = `i`.rjust(7) + ':'
Guido van Rossum9542c581992-01-12 23:27:56 +000066 line = linecache.getline(filename, i)
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +000067 if line[-1:] == '\n': line = line[:-1]
Guido van Rossum217a5fa1990-12-26 15:40:07 +000068 print prefix + line
69
70def browserexec(tb, cmd):
71 locals = tb.tb_frame.f_locals
72 globals = tb.tb_frame.f_globals
73 try:
Guido van Rossuma62b1001995-08-10 19:43:04 +000074 exec cmd+'\n' in globals, locals
Guido van Rossum217a5fa1990-12-26 15:40:07 +000075 except:
Guido van Rossumf15d1591997-09-29 23:22:12 +000076 t, v = sys.exc_info()[:2]
Guido van Rossum217a5fa1990-12-26 15:40:07 +000077 print '*** Exception:',
Fred Drake132dce22000-12-12 23:11:42 +000078 if type(t) is type(''):
Guido van Rossumf15d1591997-09-29 23:22:12 +000079 print t,
Guido van Rossumc7acf2a1995-02-27 13:15:45 +000080 else:
Guido van Rossumf15d1591997-09-29 23:22:12 +000081 print t.__name__,
Fred Drake132dce22000-12-12 23:11:42 +000082 if v is not None:
Guido van Rossumf15d1591997-09-29 23:22:12 +000083 print ':', v,
Guido van Rossum217a5fa1990-12-26 15:40:07 +000084 print
85 print 'Type help to get help.'
86
87def browserhelp():
88 print
89 print ' This is the traceback browser. Commands are:'
90 print ' up : move one level up in the call stack'
91 print ' down : move one level down in the call stack'
92 print ' locals : print all local variables at this level'
93 print ' globals : print all global variables at this level'
94 print ' list : list source code around the failure'
95 print ' help : print help (what you are reading now)'
96 print ' quit : back to command interpreter'
97 print ' Typing any other 1-line statement will execute it'
98 print ' using the current level\'s symbol tables'
99 print
100
101def printtb(tb):
102 while tb:
103 print1tb(tb)
104 tb = tb.tb_next
105
106def print1tb(tb):
107 printtbheader(tb)
108 if tb.tb_frame.f_locals is not tb.tb_frame.f_globals:
109 printsymbols(tb.tb_frame.f_locals)
110
111def printtbheader(tb):
112 filename = tb.tb_frame.f_code.co_filename
113 lineno = tb.tb_lineno
114 info = '"' + filename + '"(' + `lineno` + ')'
Guido van Rossum9542c581992-01-12 23:27:56 +0000115 line = linecache.getline(filename, lineno)
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000116 if line:
Eric S. Raymondfc170b12001-02-09 11:51:27 +0000117 info = info + ': ' + line.strip()
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000118 print info
119
120def printsymbols(d):
121 keys = d.keys()
122 keys.sort()
123 for name in keys:
Eric S. Raymondfc170b12001-02-09 11:51:27 +0000124 print ' ' + name.ljust(12) + ':',
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000125 printobject(d[name], 4)
126 print
127
128def printobject(v, maxlevel):
Fred Drake132dce22000-12-12 23:11:42 +0000129 if v is None:
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000130 print 'None',
131 elif type(v) in (type(0), type(0.0)):
132 print v,
Fred Drake132dce22000-12-12 23:11:42 +0000133 elif type(v) is type(''):
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000134 if len(v) > 20:
135 print `v[:17] + '...'`,
136 else:
137 print `v`,
Fred Drake132dce22000-12-12 23:11:42 +0000138 elif type(v) is type(()):
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000139 print '(',
140 printlist(v, maxlevel)
141 print ')',
Fred Drake132dce22000-12-12 23:11:42 +0000142 elif type(v) is type([]):
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000143 print '[',
144 printlist(v, maxlevel)
145 print ']',
Fred Drake132dce22000-12-12 23:11:42 +0000146 elif type(v) is type({}):
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000147 print '{',
148 printdict(v, maxlevel)
149 print '}',
150 else:
151 print v,
152
153def printlist(v, maxlevel):
154 n = len(v)
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +0000155 if n == 0: return
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000156 if maxlevel <= 0:
157 print '...',
158 return
159 for i in range(min(6, n)):
160 printobject(v[i], maxlevel-1)
161 if i+1 < n: print ',',
162 if n > 6: print '...',
163
164def printdict(v, maxlevel):
165 keys = v.keys()
166 n = len(keys)
Guido van Rossumbdfcfcc1992-01-01 19:35:13 +0000167 if n == 0: return
Guido van Rossum217a5fa1990-12-26 15:40:07 +0000168 if maxlevel <= 0:
169 print '...',
170 return
171 keys.sort()
172 for i in range(min(6, n)):
173 key = keys[i]
174 print `key` + ':',
175 printobject(v[key], maxlevel-1)
176 if i+1 < n: print ',',
177 if n > 6: print '...',