blob: 8e36ae266b94b1d66d1e4519bd6f2a1dd949d855 [file] [log] [blame]
Guido van Rossumd8faa362007-04-27 19:54:29 +00001# Minimal tests for dis module
2
Zachary Ware38c707e2015-04-13 15:00:43 -05003from test.support import captured_stdout
Joannah Nanjekye92777d52019-09-12 10:02:59 +01004from test.support.bytecode_helper import BytecodeTestCase
Guido van Rossumd8faa362007-04-27 19:54:29 +00005import unittest
Skip Montanaroadd0ccc2003-02-27 21:27:07 +00006import sys
7import dis
Guido van Rossum34d19282007-08-09 01:03:29 +00008import io
Zachary Waree80e8062013-12-26 09:53:49 -06009import re
Nick Coghlanb39fd0c2013-05-06 23:59:20 +100010import types
Nick Coghlan90b8e7d2013-11-06 22:08:36 +100011import contextlib
Skip Montanaroadd0ccc2003-02-27 21:27:07 +000012
Nick Coghlan50c48b82013-11-23 00:57:00 +100013def get_tb():
14 def _error():
15 try:
16 1 / 0
17 except Exception as e:
18 tb = e.__traceback__
19 return tb
20
21 tb = _error()
22 while tb.tb_next:
23 tb = tb.tb_next
24 return tb
25
26TRACEBACK_CODE = get_tb().tb_frame.f_code
27
Benjamin Petersond6afe722011-03-15 14:44:52 -050028class _C:
29 def __init__(self, x):
30 self.x = x == 1
31
Serhiy Storchaka585c93d2016-04-23 09:23:52 +030032 @staticmethod
33 def sm(x):
34 x = x == 1
35
36 @classmethod
37 def cm(cls, x):
38 cls.x = x == 1
39
Benjamin Petersond6afe722011-03-15 14:44:52 -050040dis_c_instance_method = """\
Serhiy Storchaka247763d2016-04-12 08:46:28 +030041%3d 0 LOAD_FAST 1 (x)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +030042 2 LOAD_CONST 1 (1)
43 4 COMPARE_OP 2 (==)
44 6 LOAD_FAST 0 (self)
45 8 STORE_ATTR 0 (x)
46 10 LOAD_CONST 0 (None)
47 12 RETURN_VALUE
Benjamin Petersond6afe722011-03-15 14:44:52 -050048""" % (_C.__init__.__code__.co_firstlineno + 1,)
49
50dis_c_instance_method_bytes = """\
Nick Coghlanb39fd0c2013-05-06 23:59:20 +100051 0 LOAD_FAST 1 (1)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +030052 2 LOAD_CONST 1 (1)
53 4 COMPARE_OP 2 (==)
54 6 LOAD_FAST 0 (0)
55 8 STORE_ATTR 0 (0)
56 10 LOAD_CONST 0 (0)
57 12 RETURN_VALUE
Benjamin Petersond6afe722011-03-15 14:44:52 -050058"""
Skip Montanaroadd0ccc2003-02-27 21:27:07 +000059
Serhiy Storchaka585c93d2016-04-23 09:23:52 +030060dis_c_class_method = """\
61%3d 0 LOAD_FAST 1 (x)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +030062 2 LOAD_CONST 1 (1)
63 4 COMPARE_OP 2 (==)
64 6 LOAD_FAST 0 (cls)
65 8 STORE_ATTR 0 (x)
66 10 LOAD_CONST 0 (None)
67 12 RETURN_VALUE
Serhiy Storchaka585c93d2016-04-23 09:23:52 +030068""" % (_C.cm.__code__.co_firstlineno + 2,)
69
70dis_c_static_method = """\
71%3d 0 LOAD_FAST 0 (x)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +030072 2 LOAD_CONST 1 (1)
73 4 COMPARE_OP 2 (==)
74 6 STORE_FAST 0 (x)
75 8 LOAD_CONST 0 (None)
76 10 RETURN_VALUE
Serhiy Storchaka585c93d2016-04-23 09:23:52 +030077""" % (_C.sm.__code__.co_firstlineno + 2,)
78
79# Class disassembling info has an extra newline at end.
80dis_c = """\
81Disassembly of %s:
82%s
83Disassembly of %s:
84%s
85Disassembly of %s:
86%s
87""" % (_C.__init__.__name__, dis_c_instance_method,
88 _C.cm.__name__, dis_c_class_method,
89 _C.sm.__name__, dis_c_static_method)
90
Skip Montanaroadd0ccc2003-02-27 21:27:07 +000091def _f(a):
Guido van Rossumbe19ed72007-02-09 05:37:30 +000092 print(a)
Tim Peterseabafeb2003-03-07 15:55:36 +000093 return 1
Skip Montanaroadd0ccc2003-02-27 21:27:07 +000094
95dis_f = """\
Serhiy Storchaka247763d2016-04-12 08:46:28 +030096%3d 0 LOAD_GLOBAL 0 (print)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +030097 2 LOAD_FAST 0 (a)
Victor Stinnerf9b760f2016-09-09 10:17:08 -070098 4 CALL_FUNCTION 1
Serhiy Storchakab0f80b02016-05-24 09:15:14 +030099 6 POP_TOP
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000100
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300101%3d 8 LOAD_CONST 1 (1)
102 10 RETURN_VALUE
Georg Brandlebbf63b2010-10-14 07:23:01 +0000103""" % (_f.__code__.co_firstlineno + 1,
104 _f.__code__.co_firstlineno + 2)
Michael W. Hudson26848a32003-04-29 17:07:36 +0000105
106
Benjamin Petersond6afe722011-03-15 14:44:52 -0500107dis_f_co_code = """\
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000108 0 LOAD_GLOBAL 0 (0)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300109 2 LOAD_FAST 0 (0)
Victor Stinnerf9b760f2016-09-09 10:17:08 -0700110 4 CALL_FUNCTION 1
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300111 6 POP_TOP
112 8 LOAD_CONST 1 (1)
113 10 RETURN_VALUE
Benjamin Petersond6afe722011-03-15 14:44:52 -0500114"""
115
116
Michael W. Hudson26848a32003-04-29 17:07:36 +0000117def bug708901():
118 for res in range(1,
119 10):
120 pass
121
122dis_bug708901 = """\
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200123%3d 0 LOAD_GLOBAL 0 (range)
124 2 LOAD_CONST 1 (1)
Michael W. Hudson26848a32003-04-29 17:07:36 +0000125
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200126%3d 4 LOAD_CONST 2 (10)
Serhiy Storchakada8d72c2018-09-17 15:17:29 +0300127
128%3d 6 CALL_FUNCTION 2
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200129 8 GET_ITER
Mark Shannonfcb55c02021-04-01 16:00:31 +0100130 >> 10 FOR_ITER 2 (to 16)
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200131 12 STORE_FAST 0 (res)
Michael W. Hudson26848a32003-04-29 17:07:36 +0000132
Mark Shannonfcb55c02021-04-01 16:00:31 +0100133%3d 14 JUMP_ABSOLUTE 5 (to 10)
Mark Shannon5977a792020-12-02 13:31:40 +0000134
135%3d >> 16 LOAD_CONST 0 (None)
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200136 18 RETURN_VALUE
Georg Brandlebbf63b2010-10-14 07:23:01 +0000137""" % (bug708901.__code__.co_firstlineno + 1,
138 bug708901.__code__.co_firstlineno + 2,
Serhiy Storchakada8d72c2018-09-17 15:17:29 +0300139 bug708901.__code__.co_firstlineno + 1,
Mark Shannon5977a792020-12-02 13:31:40 +0000140 bug708901.__code__.co_firstlineno + 3,
141 bug708901.__code__.co_firstlineno + 1)
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000142
Neal Norwitz51abbc72005-12-18 07:06:23 +0000143
144def bug1333982(x=[]):
145 assert 0, ([s for s in x] +
146 1)
147 pass
148
149dis_bug1333982 = """\
Mark Shannon266b4622020-11-17 19:30:14 +0000150%3d 0 LOAD_ASSERTION_ERROR
151 2 LOAD_CONST 2 (<code object <listcomp> at 0x..., file "%s", line %d>)
152 4 LOAD_CONST 3 ('bug1333982.<locals>.<listcomp>')
153 6 MAKE_FUNCTION 0
154 8 LOAD_FAST 0 (x)
155 10 GET_ITER
156 12 CALL_FUNCTION 1
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300157
Mark Shannon266b4622020-11-17 19:30:14 +0000158%3d 14 LOAD_CONST 4 (1)
Serhiy Storchakada8d72c2018-09-17 15:17:29 +0300159
Mark Shannon266b4622020-11-17 19:30:14 +0000160%3d 16 BINARY_ADD
161 18 CALL_FUNCTION 1
162 20 RAISE_VARARGS 1
Georg Brandlebbf63b2010-10-14 07:23:01 +0000163""" % (bug1333982.__code__.co_firstlineno + 1,
Zachary Waree80e8062013-12-26 09:53:49 -0600164 __file__,
165 bug1333982.__code__.co_firstlineno + 1,
Georg Brandlebbf63b2010-10-14 07:23:01 +0000166 bug1333982.__code__.co_firstlineno + 2,
Mark Shannon266b4622020-11-17 19:30:14 +0000167 bug1333982.__code__.co_firstlineno + 1)
Neal Norwitz51abbc72005-12-18 07:06:23 +0000168
Yurii Karabasf24b8102020-12-04 17:20:53 +0200169
170def bug42562():
171 pass
172
173
174# Set line number for 'pass' to None
175bug42562.__code__ = bug42562.__code__.replace(co_linetable=b'\x04\x80\xff\x80')
176
177
178dis_bug42562 = """\
179 0 LOAD_CONST 0 (None)
180 2 RETURN_VALUE
181"""
182
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000183_BIG_LINENO_FORMAT = """\
184%3d 0 LOAD_GLOBAL 0 (spam)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300185 2 POP_TOP
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000186 4 LOAD_CONST 0 (None)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300187 6 RETURN_VALUE
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000188"""
189
Serhiy Storchakad90045f2017-04-19 20:36:31 +0300190_BIG_LINENO_FORMAT2 = """\
191%4d 0 LOAD_GLOBAL 0 (spam)
192 2 POP_TOP
193 4 LOAD_CONST 0 (None)
194 6 RETURN_VALUE
195"""
196
Guido van Rossume7ba4952007-06-06 23:52:48 +0000197dis_module_expected_results = """\
198Disassembly of f:
199 4 0 LOAD_CONST 0 (None)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300200 2 RETURN_VALUE
Guido van Rossume7ba4952007-06-06 23:52:48 +0000201
202Disassembly of g:
203 5 0 LOAD_CONST 0 (None)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300204 2 RETURN_VALUE
Guido van Rossume7ba4952007-06-06 23:52:48 +0000205
206"""
207
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000208expr_str = "x + 1"
209
210dis_expr_str = """\
211 1 0 LOAD_NAME 0 (x)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300212 2 LOAD_CONST 0 (1)
213 4 BINARY_ADD
214 6 RETURN_VALUE
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000215"""
216
217simple_stmt_str = "x = x + 1"
218
219dis_simple_stmt_str = """\
220 1 0 LOAD_NAME 0 (x)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300221 2 LOAD_CONST 0 (1)
222 4 BINARY_ADD
223 6 STORE_NAME 0 (x)
224 8 LOAD_CONST 1 (None)
225 10 RETURN_VALUE
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000226"""
227
Yury Selivanovf8cb8a12016-09-08 20:50:03 -0700228annot_stmt_str = """\
229
230x: int = 1
231y: fun(1)
232lst[fun(0)]: int = 1
233"""
234# leading newline is for a reason (tests lineno)
235
236dis_annot_stmt_str = """\
237 2 0 SETUP_ANNOTATIONS
238 2 LOAD_CONST 0 (1)
239 4 STORE_NAME 0 (x)
Pablo Galindob0544ba2021-04-21 12:41:19 +0100240 6 LOAD_NAME 1 (int)
241 8 LOAD_NAME 2 (__annotations__)
242 10 LOAD_CONST 1 ('x')
Mark Shannon332cd5e2018-01-30 00:41:04 +0000243 12 STORE_SUBSCR
Yury Selivanovf8cb8a12016-09-08 20:50:03 -0700244
Pablo Galindob0544ba2021-04-21 12:41:19 +0100245 3 14 LOAD_NAME 3 (fun)
246 16 LOAD_CONST 0 (1)
247 18 CALL_FUNCTION 1
248 20 LOAD_NAME 2 (__annotations__)
249 22 LOAD_CONST 2 ('y')
250 24 STORE_SUBSCR
Yury Selivanovf8cb8a12016-09-08 20:50:03 -0700251
Pablo Galindob0544ba2021-04-21 12:41:19 +0100252 4 26 LOAD_CONST 0 (1)
253 28 LOAD_NAME 4 (lst)
254 30 LOAD_NAME 3 (fun)
255 32 LOAD_CONST 3 (0)
256 34 CALL_FUNCTION 1
257 36 STORE_SUBSCR
258 38 LOAD_NAME 1 (int)
259 40 POP_TOP
260 42 LOAD_CONST 4 (None)
261 44 RETURN_VALUE
Yury Selivanovf8cb8a12016-09-08 20:50:03 -0700262"""
263
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000264compound_stmt_str = """\
265x = 0
266while 1:
267 x += 1"""
268# Trailing newline has been deliberately omitted
269
270dis_compound_stmt_str = """\
271 1 0 LOAD_CONST 0 (0)
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300272 2 STORE_NAME 0 (x)
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000273
Mark Shannon8473cf82020-12-15 11:07:50 +0000274 2 4 NOP
275
276 3 >> 6 LOAD_NAME 0 (x)
277 8 LOAD_CONST 1 (1)
278 10 INPLACE_ADD
279 12 STORE_NAME 0 (x)
280
Mark Shannonfcb55c02021-04-01 16:00:31 +0100281 2 14 JUMP_ABSOLUTE 3 (to 6)
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000282"""
Guido van Rossume7ba4952007-06-06 23:52:48 +0000283
Nick Coghlan50c48b82013-11-23 00:57:00 +1000284dis_traceback = """\
Mark Shannonfcb55c02021-04-01 16:00:31 +0100285%3d 0 SETUP_FINALLY 7 (to 16)
Nick Coghlan50c48b82013-11-23 00:57:00 +1000286
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300287%3d 2 LOAD_CONST 1 (1)
288 4 LOAD_CONST 2 (0)
289 --> 6 BINARY_TRUE_DIVIDE
290 8 POP_TOP
291 10 POP_BLOCK
Nick Coghlan50c48b82013-11-23 00:57:00 +1000292
Mark Shannoncc75ab72020-11-12 19:49:33 +0000293%3d 12 LOAD_FAST 1 (tb)
294 14 RETURN_VALUE
Nick Coghlan50c48b82013-11-23 00:57:00 +1000295
Mark Shannoncc75ab72020-11-12 19:49:33 +0000296%3d >> 16 DUP_TOP
297 18 LOAD_GLOBAL 0 (Exception)
Mark Shannonfcb55c02021-04-01 16:00:31 +0100298 20 JUMP_IF_NOT_EXC_MATCH 29 (to 58)
Mark Shannoncc75ab72020-11-12 19:49:33 +0000299 22 POP_TOP
300 24 STORE_FAST 0 (e)
301 26 POP_TOP
Mark Shannonfcb55c02021-04-01 16:00:31 +0100302 28 SETUP_FINALLY 10 (to 50)
Nick Coghlan50c48b82013-11-23 00:57:00 +1000303
Mark Shannoncc75ab72020-11-12 19:49:33 +0000304%3d 30 LOAD_FAST 0 (e)
305 32 LOAD_ATTR 1 (__traceback__)
306 34 STORE_FAST 1 (tb)
307 36 POP_BLOCK
308 38 POP_EXCEPT
309 40 LOAD_CONST 0 (None)
310 42 STORE_FAST 0 (e)
311 44 DELETE_FAST 0 (e)
312
313%3d 46 LOAD_FAST 1 (tb)
314 48 RETURN_VALUE
315 >> 50 LOAD_CONST 0 (None)
316 52 STORE_FAST 0 (e)
317 54 DELETE_FAST 0 (e)
Mark Shannonbf353f32020-12-17 13:55:28 +0000318 56 RERAISE 1
Mark Shannon5977a792020-12-02 13:31:40 +0000319
Mark Shannonbf353f32020-12-17 13:55:28 +0000320%3d >> 58 RERAISE 0
Nick Coghlan50c48b82013-11-23 00:57:00 +1000321""" % (TRACEBACK_CODE.co_firstlineno + 1,
322 TRACEBACK_CODE.co_firstlineno + 2,
Mark Shannoncc75ab72020-11-12 19:49:33 +0000323 TRACEBACK_CODE.co_firstlineno + 5,
Nick Coghlan50c48b82013-11-23 00:57:00 +1000324 TRACEBACK_CODE.co_firstlineno + 3,
325 TRACEBACK_CODE.co_firstlineno + 4,
Mark Shannon5977a792020-12-02 13:31:40 +0000326 TRACEBACK_CODE.co_firstlineno + 5,
327 TRACEBACK_CODE.co_firstlineno + 3)
Nick Coghlan50c48b82013-11-23 00:57:00 +1000328
Serhiy Storchakadd102f72016-10-08 12:34:25 +0300329def _fstring(a, b, c, d):
330 return f'{a} {b:4} {c!r} {d!r:4}'
331
332dis_fstring = """\
333%3d 0 LOAD_FAST 0 (a)
334 2 FORMAT_VALUE 0
335 4 LOAD_CONST 1 (' ')
336 6 LOAD_FAST 1 (b)
337 8 LOAD_CONST 2 ('4')
338 10 FORMAT_VALUE 4 (with format)
339 12 LOAD_CONST 1 (' ')
340 14 LOAD_FAST 2 (c)
341 16 FORMAT_VALUE 2 (repr)
342 18 LOAD_CONST 1 (' ')
343 20 LOAD_FAST 3 (d)
344 22 LOAD_CONST 2 ('4')
345 24 FORMAT_VALUE 6 (repr, with format)
346 26 BUILD_STRING 7
347 28 RETURN_VALUE
348""" % (_fstring.__code__.co_firstlineno + 1,)
349
Mark Shannon88dce262019-12-30 09:53:36 +0000350def _tryfinally(a, b):
351 try:
352 return a
353 finally:
354 b()
355
356def _tryfinallyconst(b):
357 try:
358 return 1
359 finally:
360 b()
361
362dis_tryfinally = """\
Mark Shannonfcb55c02021-04-01 16:00:31 +0100363%3d 0 SETUP_FINALLY 6 (to 14)
Mark Shannon88dce262019-12-30 09:53:36 +0000364
365%3d 2 LOAD_FAST 0 (a)
366 4 POP_BLOCK
367
368%3d 6 LOAD_FAST 1 (b)
369 8 CALL_FUNCTION 0
370 10 POP_TOP
Mark Shannon5274b682020-12-16 13:07:01 +0000371 12 RETURN_VALUE
372 >> 14 LOAD_FAST 1 (b)
Mark Shannon88dce262019-12-30 09:53:36 +0000373 16 CALL_FUNCTION 0
374 18 POP_TOP
Mark Shannonbf353f32020-12-17 13:55:28 +0000375 20 RERAISE 0
Mark Shannon88dce262019-12-30 09:53:36 +0000376""" % (_tryfinally.__code__.co_firstlineno + 1,
377 _tryfinally.__code__.co_firstlineno + 2,
378 _tryfinally.__code__.co_firstlineno + 4,
Mark Shannon88dce262019-12-30 09:53:36 +0000379 )
380
381dis_tryfinallyconst = """\
Mark Shannonfcb55c02021-04-01 16:00:31 +0100382%3d 0 SETUP_FINALLY 6 (to 14)
Mark Shannon88dce262019-12-30 09:53:36 +0000383
384%3d 2 POP_BLOCK
385
386%3d 4 LOAD_FAST 0 (b)
387 6 CALL_FUNCTION 0
388 8 POP_TOP
Mark Shannon5274b682020-12-16 13:07:01 +0000389 10 LOAD_CONST 1 (1)
Mark Shannon88dce262019-12-30 09:53:36 +0000390 12 RETURN_VALUE
Mark Shannon5274b682020-12-16 13:07:01 +0000391 >> 14 LOAD_FAST 0 (b)
Mark Shannon88dce262019-12-30 09:53:36 +0000392 16 CALL_FUNCTION 0
393 18 POP_TOP
Mark Shannonbf353f32020-12-17 13:55:28 +0000394 20 RERAISE 0
Mark Shannon88dce262019-12-30 09:53:36 +0000395""" % (_tryfinallyconst.__code__.co_firstlineno + 1,
396 _tryfinallyconst.__code__.co_firstlineno + 2,
397 _tryfinallyconst.__code__.co_firstlineno + 4,
Mark Shannon88dce262019-12-30 09:53:36 +0000398 )
399
Nick Coghlanefd5df92014-07-25 23:02:56 +1000400def _g(x):
401 yield x
402
syncosmicfe2b56a2017-08-17 19:29:21 -0700403async def _ag(x):
404 yield x
405
406async def _co(x):
407 async for item in _ag(x):
408 pass
409
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300410def _h(y):
411 def foo(x):
412 '''funcdoc'''
413 return [x + z for z in y]
414 return foo
415
416dis_nested_0 = """\
417%3d 0 LOAD_CLOSURE 0 (y)
418 2 BUILD_TUPLE 1
419 4 LOAD_CONST 1 (<code object foo at 0x..., file "%s", line %d>)
420 6 LOAD_CONST 2 ('_h.<locals>.foo')
Serhiy Storchakae2732d32018-03-11 11:07:06 +0200421 8 MAKE_FUNCTION 8 (closure)
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300422 10 STORE_FAST 1 (foo)
423
424%3d 12 LOAD_FAST 1 (foo)
425 14 RETURN_VALUE
426""" % (_h.__code__.co_firstlineno + 1,
427 __file__,
428 _h.__code__.co_firstlineno + 1,
429 _h.__code__.co_firstlineno + 4,
430)
431
432dis_nested_1 = """%s
433Disassembly of <code object foo at 0x..., file "%s", line %d>:
434%3d 0 LOAD_CLOSURE 0 (x)
435 2 BUILD_TUPLE 1
436 4 LOAD_CONST 1 (<code object <listcomp> at 0x..., file "%s", line %d>)
437 6 LOAD_CONST 2 ('_h.<locals>.foo.<locals>.<listcomp>')
Serhiy Storchakae2732d32018-03-11 11:07:06 +0200438 8 MAKE_FUNCTION 8 (closure)
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300439 10 LOAD_DEREF 1 (y)
440 12 GET_ITER
441 14 CALL_FUNCTION 1
442 16 RETURN_VALUE
443""" % (dis_nested_0,
444 __file__,
445 _h.__code__.co_firstlineno + 1,
446 _h.__code__.co_firstlineno + 3,
447 __file__,
448 _h.__code__.co_firstlineno + 3,
449)
450
451dis_nested_2 = """%s
452Disassembly of <code object <listcomp> at 0x..., file "%s", line %d>:
453%3d 0 BUILD_LIST 0
454 2 LOAD_FAST 0 (.0)
Mark Shannonfcb55c02021-04-01 16:00:31 +0100455 >> 4 FOR_ITER 6 (to 18)
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300456 6 STORE_FAST 1 (z)
457 8 LOAD_DEREF 0 (x)
458 10 LOAD_FAST 1 (z)
459 12 BINARY_ADD
460 14 LIST_APPEND 2
Mark Shannonfcb55c02021-04-01 16:00:31 +0100461 16 JUMP_ABSOLUTE 2 (to 4)
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300462 >> 18 RETURN_VALUE
463""" % (dis_nested_1,
464 __file__,
465 _h.__code__.co_firstlineno + 3,
466 _h.__code__.co_firstlineno + 3,
467)
468
syncosmicfe2b56a2017-08-17 19:29:21 -0700469
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000470class DisTests(unittest.TestCase):
Benjamin Petersond6afe722011-03-15 14:44:52 -0500471
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300472 maxDiff = None
473
474 def get_disassembly(self, func, lasti=-1, wrapper=True, **kwargs):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000475 # We want to test the default printing behaviour, not the file arg
476 output = io.StringIO()
477 with contextlib.redirect_stdout(output):
Benjamin Petersond6afe722011-03-15 14:44:52 -0500478 if wrapper:
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300479 dis.dis(func, **kwargs)
Benjamin Petersond6afe722011-03-15 14:44:52 -0500480 else:
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300481 dis.disassemble(func, lasti, **kwargs)
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000482 return output.getvalue()
Benjamin Petersond6afe722011-03-15 14:44:52 -0500483
484 def get_disassemble_as_string(self, func, lasti=-1):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000485 return self.get_disassembly(func, lasti, False)
Benjamin Petersond6afe722011-03-15 14:44:52 -0500486
Zachary Warebb4b7c12013-12-26 09:55:24 -0600487 def strip_addresses(self, text):
488 return re.sub(r'\b0x[0-9A-Fa-f]+\b', '0x...', text)
Benjamin Petersond6afe722011-03-15 14:44:52 -0500489
490 def do_disassembly_test(self, func, expected):
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300491 got = self.get_disassembly(func, depth=0)
Zachary Warebb4b7c12013-12-26 09:55:24 -0600492 if got != expected:
493 got = self.strip_addresses(got)
494 self.assertEqual(got, expected)
Michael W. Hudson26848a32003-04-29 17:07:36 +0000495
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000496 def test_opmap(self):
Benjamin Peterson76f7f4d2011-07-17 22:49:50 -0500497 self.assertEqual(dis.opmap["NOP"], 9)
Ezio Melottib58e0bd2010-01-23 15:40:09 +0000498 self.assertIn(dis.opmap["LOAD_CONST"], dis.hasconst)
499 self.assertIn(dis.opmap["STORE_NAME"], dis.hasname)
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000500
501 def test_opname(self):
502 self.assertEqual(dis.opname[dis.opmap["LOAD_FAST"]], "LOAD_FAST")
503
504 def test_boundaries(self):
505 self.assertEqual(dis.opmap["EXTENDED_ARG"], dis.EXTENDED_ARG)
506 self.assertEqual(dis.opmap["STORE_NAME"], dis.HAVE_ARGUMENT)
507
Serhiy Storchakad90045f2017-04-19 20:36:31 +0300508 def test_widths(self):
509 for opcode, opname in enumerate(dis.opname):
510 if opname in ('BUILD_MAP_UNPACK_WITH_CALL',
Mark Shannon9af0e472020-01-14 10:12:45 +0000511 'BUILD_TUPLE_UNPACK_WITH_CALL',
512 'JUMP_IF_NOT_EXC_MATCH'):
Serhiy Storchakad90045f2017-04-19 20:36:31 +0300513 continue
514 with self.subTest(opname=opname):
515 width = dis._OPNAME_WIDTH
516 if opcode < dis.HAVE_ARGUMENT:
517 width += 1 + dis._OPARG_WIDTH
518 self.assertLessEqual(len(opname), width)
519
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000520 def test_dis(self):
Michael W. Hudson26848a32003-04-29 17:07:36 +0000521 self.do_disassembly_test(_f, dis_f)
522
523 def test_bug_708901(self):
524 self.do_disassembly_test(bug708901, dis_bug708901)
Skip Montanaroadd0ccc2003-02-27 21:27:07 +0000525
Neal Norwitz51abbc72005-12-18 07:06:23 +0000526 def test_bug_1333982(self):
Tim Peters83a8c392005-12-25 22:52:32 +0000527 # This one is checking bytecodes generated for an `assert` statement,
528 # so fails if the tests are run with -O. Skip this test then.
Zachary Waree80e8062013-12-26 09:53:49 -0600529 if not __debug__:
530 self.skipTest('need asserts, run without -O')
Zachary Ware9fe6d862013-12-08 00:20:35 -0600531
Zachary Waree80e8062013-12-26 09:53:49 -0600532 self.do_disassembly_test(bug1333982, dis_bug1333982)
Neal Norwitz51abbc72005-12-18 07:06:23 +0000533
Yurii Karabasf24b8102020-12-04 17:20:53 +0200534 def test_bug_42562(self):
535 self.do_disassembly_test(bug42562, dis_bug42562)
536
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000537 def test_big_linenos(self):
538 def func(count):
539 namespace = {}
540 func = "def foo():\n " + "".join(["\n "] * count + ["spam\n"])
Georg Brandl7cae87c2006-09-06 06:51:57 +0000541 exec(func, namespace)
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000542 return namespace['foo']
543
544 # Test all small ranges
Guido van Rossum805365e2007-05-07 22:24:25 +0000545 for i in range(1, 300):
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000546 expected = _BIG_LINENO_FORMAT % (i + 2)
547 self.do_disassembly_test(func(i), expected)
548
549 # Test some larger ranges too
Serhiy Storchakad90045f2017-04-19 20:36:31 +0300550 for i in range(300, 1000, 10):
Thomas Wouters0e3f5912006-08-11 14:57:12 +0000551 expected = _BIG_LINENO_FORMAT % (i + 2)
552 self.do_disassembly_test(func(i), expected)
553
Serhiy Storchakad90045f2017-04-19 20:36:31 +0300554 for i in range(1000, 5000, 10):
555 expected = _BIG_LINENO_FORMAT2 % (i + 2)
556 self.do_disassembly_test(func(i), expected)
557
Guido van Rossume7ba4952007-06-06 23:52:48 +0000558 from test import dis_module
559 self.do_disassembly_test(dis_module, dis_module_expected_results)
560
Serhiy Storchakad90045f2017-04-19 20:36:31 +0300561 def test_big_offsets(self):
562 def func(count):
563 namespace = {}
564 func = "def foo(x):\n " + ";".join(["x = x + 1"] * count) + "\n return x"
565 exec(func, namespace)
566 return namespace['foo']
567
568 def expected(count, w):
569 s = ['''\
570 %*d LOAD_FAST 0 (x)
571 %*d LOAD_CONST 1 (1)
572 %*d BINARY_ADD
573 %*d STORE_FAST 0 (x)
574''' % (w, 8*i, w, 8*i + 2, w, 8*i + 4, w, 8*i + 6)
575 for i in range(count)]
576 s += ['''\
577
578 3 %*d LOAD_FAST 0 (x)
579 %*d RETURN_VALUE
580''' % (w, 8*count, w, 8*count + 2)]
581 s[0] = ' 2' + s[0][3:]
582 return ''.join(s)
583
584 for i in range(1, 5):
585 self.do_disassembly_test(func(i), expected(i, 4))
586 self.do_disassembly_test(func(1249), expected(1249, 4))
587 self.do_disassembly_test(func(1250), expected(1250, 5))
588
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000589 def test_disassemble_str(self):
590 self.do_disassembly_test(expr_str, dis_expr_str)
591 self.do_disassembly_test(simple_stmt_str, dis_simple_stmt_str)
Yury Selivanovf8cb8a12016-09-08 20:50:03 -0700592 self.do_disassembly_test(annot_stmt_str, dis_annot_stmt_str)
Nick Coghlan5c8b54e2010-07-03 07:36:51 +0000593 self.do_disassembly_test(compound_stmt_str, dis_compound_stmt_str)
594
Benjamin Petersond6afe722011-03-15 14:44:52 -0500595 def test_disassemble_bytes(self):
596 self.do_disassembly_test(_f.__code__.co_code, dis_f_co_code)
597
Serhiy Storchaka585c93d2016-04-23 09:23:52 +0300598 def test_disassemble_class(self):
599 self.do_disassembly_test(_C, dis_c)
600
601 def test_disassemble_instance_method(self):
Benjamin Petersond6afe722011-03-15 14:44:52 -0500602 self.do_disassembly_test(_C(1).__init__, dis_c_instance_method)
603
Serhiy Storchaka585c93d2016-04-23 09:23:52 +0300604 def test_disassemble_instance_method_bytes(self):
Benjamin Petersond6afe722011-03-15 14:44:52 -0500605 method_bytecode = _C(1).__init__.__code__.co_code
606 self.do_disassembly_test(method_bytecode, dis_c_instance_method_bytes)
607
Serhiy Storchaka585c93d2016-04-23 09:23:52 +0300608 def test_disassemble_static_method(self):
609 self.do_disassembly_test(_C.sm, dis_c_static_method)
610
611 def test_disassemble_class_method(self):
612 self.do_disassembly_test(_C.cm, dis_c_class_method)
613
Nick Coghlanefd5df92014-07-25 23:02:56 +1000614 def test_disassemble_generator(self):
syncosmicfe2b56a2017-08-17 19:29:21 -0700615 gen_func_disas = self.get_disassembly(_g) # Generator function
616 gen_disas = self.get_disassembly(_g(1)) # Generator iterator
Nick Coghlanefd5df92014-07-25 23:02:56 +1000617 self.assertEqual(gen_disas, gen_func_disas)
618
syncosmicfe2b56a2017-08-17 19:29:21 -0700619 def test_disassemble_async_generator(self):
620 agen_func_disas = self.get_disassembly(_ag) # Async generator function
621 agen_disas = self.get_disassembly(_ag(1)) # Async generator iterator
622 self.assertEqual(agen_disas, agen_func_disas)
623
624 def test_disassemble_coroutine(self):
625 coro_func_disas = self.get_disassembly(_co) # Coroutine function
626 coro = _co(1) # Coroutine object
627 coro.close() # Avoid a RuntimeWarning (never awaited)
628 coro_disas = self.get_disassembly(coro)
629 self.assertEqual(coro_disas, coro_func_disas)
630
Serhiy Storchakadd102f72016-10-08 12:34:25 +0300631 def test_disassemble_fstring(self):
632 self.do_disassembly_test(_fstring, dis_fstring)
633
Mark Shannon88dce262019-12-30 09:53:36 +0000634 def test_disassemble_try_finally(self):
635 self.do_disassembly_test(_tryfinally, dis_tryfinally)
636 self.do_disassembly_test(_tryfinallyconst, dis_tryfinallyconst)
637
Benjamin Petersond6afe722011-03-15 14:44:52 -0500638 def test_dis_none(self):
Benjamin Peterson47afc2a2011-03-15 15:54:50 -0500639 try:
640 del sys.last_traceback
641 except AttributeError:
642 pass
Benjamin Petersond6afe722011-03-15 14:44:52 -0500643 self.assertRaises(RuntimeError, dis.dis, None)
644
Benjamin Petersond6afe722011-03-15 14:44:52 -0500645 def test_dis_traceback(self):
Benjamin Peterson47afc2a2011-03-15 15:54:50 -0500646 try:
647 del sys.last_traceback
648 except AttributeError:
649 pass
Benjamin Petersond6afe722011-03-15 14:44:52 -0500650
651 try:
652 1/0
653 except Exception as e:
654 tb = e.__traceback__
655 sys.last_traceback = tb
Benjamin Petersond6afe722011-03-15 14:44:52 -0500656
657 tb_dis = self.get_disassemble_as_string(tb.tb_frame.f_code, tb.tb_lasti)
658 self.do_disassembly_test(None, tb_dis)
659
660 def test_dis_object(self):
661 self.assertRaises(TypeError, dis.dis, object())
662
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300663 def test_disassemble_recursive(self):
664 def check(expected, **kwargs):
665 dis = self.get_disassembly(_h, **kwargs)
666 dis = self.strip_addresses(dis)
667 self.assertEqual(dis, expected)
668
669 check(dis_nested_0, depth=0)
670 check(dis_nested_1, depth=1)
671 check(dis_nested_2, depth=2)
672 check(dis_nested_2, depth=3)
673 check(dis_nested_2, depth=None)
674 check(dis_nested_2)
675
676
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000677class DisWithFileTests(DisTests):
678
679 # Run the tests again, using the file arg instead of print
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300680 def get_disassembly(self, func, lasti=-1, wrapper=True, **kwargs):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000681 output = io.StringIO()
682 if wrapper:
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300683 dis.dis(func, file=output, **kwargs)
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000684 else:
Serhiy Storchaka1efbf922017-06-11 14:09:39 +0300685 dis.disassemble(func, lasti, file=output, **kwargs)
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000686 return output.getvalue()
687
688
Mark Shannon266b4622020-11-17 19:30:14 +0000689if sys.flags.optimize:
690 code_info_consts = "0: None"
691else:
692 code_info_consts = (
693 """0: 'Formatted details of methods, functions, or code.'
694 1: None"""
695)
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000696
Mark Shannon266b4622020-11-17 19:30:14 +0000697code_info_code_info = f"""\
Nick Coghlaneae2da12010-08-17 08:03:36 +0000698Name: code_info
Nick Coghlan46e63802010-08-17 11:28:07 +0000699Filename: (.*)
Nick Coghlaneae2da12010-08-17 08:03:36 +0000700Argument count: 1
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100701Positional-only arguments: 0
Nick Coghlaneae2da12010-08-17 08:03:36 +0000702Kw-only arguments: 0
703Number of locals: 1
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000704Stack size: 3
Nick Coghlaneae2da12010-08-17 08:03:36 +0000705Flags: OPTIMIZED, NEWLOCALS, NOFREE
706Constants:
Mark Shannon266b4622020-11-17 19:30:14 +0000707 {code_info_consts}
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000708Names:
709 0: _format_code_info
710 1: _get_code_object
Nick Coghlaneae2da12010-08-17 08:03:36 +0000711Variable names:
Mark Shannon266b4622020-11-17 19:30:14 +0000712 0: x"""
713
Nick Coghlaneae2da12010-08-17 08:03:36 +0000714
715@staticmethod
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100716def tricky(a, b, /, x, y, z=True, *args, c, d, e=[], **kwds):
Nick Coghlaneae2da12010-08-17 08:03:36 +0000717 def f(c=c):
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100718 print(a, b, x, y, z, c, d, e, f)
719 yield a, b, x, y, z, c, d, e, f
Nick Coghlaneae2da12010-08-17 08:03:36 +0000720
Nick Coghlaneae2da12010-08-17 08:03:36 +0000721code_info_tricky = """\
722Name: tricky
Nick Coghlan46e63802010-08-17 11:28:07 +0000723Filename: (.*)
Pablo Galindocd74e662019-06-01 18:08:04 +0100724Argument count: 5
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100725Positional-only arguments: 2
Nick Coghlaneae2da12010-08-17 08:03:36 +0000726Kw-only arguments: 3
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100727Number of locals: 10
728Stack size: 9
Nick Coghlaneae2da12010-08-17 08:03:36 +0000729Flags: OPTIMIZED, NEWLOCALS, VARARGS, VARKEYWORDS, GENERATOR
730Constants:
731 0: None
Nick Coghlan46e63802010-08-17 11:28:07 +0000732 1: <code object f at (.*), file "(.*)", line (.*)>
Antoine Pitrou86a36b52011-11-25 18:56:07 +0100733 2: 'tricky.<locals>.f'
Nick Coghlaneae2da12010-08-17 08:03:36 +0000734Variable names:
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100735 0: a
736 1: b
737 2: x
738 3: y
739 4: z
740 5: c
741 6: d
742 7: e
743 8: args
744 9: kwds
Nick Coghlaneae2da12010-08-17 08:03:36 +0000745Cell variables:
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100746 0: [abedfxyz]
747 1: [abedfxyz]
748 2: [abedfxyz]
749 3: [abedfxyz]
750 4: [abedfxyz]
751 5: [abedfxyz]"""
Georg Brandla1082272012-02-20 21:41:03 +0100752# NOTE: the order of the cell variables above depends on dictionary order!
Nick Coghlan46e63802010-08-17 11:28:07 +0000753
754co_tricky_nested_f = tricky.__func__.__code__.co_consts[1]
Nick Coghlaneae2da12010-08-17 08:03:36 +0000755
756code_info_tricky_nested_f = """\
Nick Coghlan46e63802010-08-17 11:28:07 +0000757Filename: (.*)
Nick Coghlaneae2da12010-08-17 08:03:36 +0000758Argument count: 1
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100759Positional-only arguments: 0
Nick Coghlaneae2da12010-08-17 08:03:36 +0000760Kw-only arguments: 0
761Number of locals: 1
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100762Stack size: 10
Nick Coghlaneae2da12010-08-17 08:03:36 +0000763Flags: OPTIMIZED, NEWLOCALS, NESTED
764Constants:
765 0: None
766Names:
767 0: print
768Variable names:
769 0: c
770Free variables:
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100771 0: [abedfxyz]
772 1: [abedfxyz]
773 2: [abedfxyz]
774 3: [abedfxyz]
775 4: [abedfxyz]
776 5: [abedfxyz]"""
Nick Coghlaneae2da12010-08-17 08:03:36 +0000777
778code_info_expr_str = """\
779Name: <module>
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000780Filename: <disassembly>
Nick Coghlaneae2da12010-08-17 08:03:36 +0000781Argument count: 0
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100782Positional-only arguments: 0
Nick Coghlaneae2da12010-08-17 08:03:36 +0000783Kw-only arguments: 0
784Number of locals: 0
785Stack size: 2
786Flags: NOFREE
787Constants:
788 0: 1
789Names:
790 0: x"""
791
792code_info_simple_stmt_str = """\
793Name: <module>
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000794Filename: <disassembly>
Nick Coghlaneae2da12010-08-17 08:03:36 +0000795Argument count: 0
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100796Positional-only arguments: 0
Nick Coghlaneae2da12010-08-17 08:03:36 +0000797Kw-only arguments: 0
798Number of locals: 0
799Stack size: 2
800Flags: NOFREE
801Constants:
802 0: 1
803 1: None
804Names:
805 0: x"""
806
807code_info_compound_stmt_str = """\
808Name: <module>
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000809Filename: <disassembly>
Nick Coghlaneae2da12010-08-17 08:03:36 +0000810Argument count: 0
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100811Positional-only arguments: 0
Nick Coghlaneae2da12010-08-17 08:03:36 +0000812Kw-only arguments: 0
813Number of locals: 0
814Stack size: 2
815Flags: NOFREE
816Constants:
817 0: 0
818 1: 1
819 2: None
820Names:
821 0: x"""
822
Yury Selivanov75445082015-05-11 22:57:16 -0400823
824async def async_def():
825 await 1
826 async for a in b: pass
827 async with c as d: pass
828
829code_info_async_def = """\
830Name: async_def
831Filename: (.*)
832Argument count: 0
Pablo Galindo8c77b8c2019-04-29 13:36:57 +0100833Positional-only arguments: 0
Yury Selivanov75445082015-05-11 22:57:16 -0400834Kw-only arguments: 0
835Number of locals: 2
Mark Shannonfee55262019-11-21 09:11:43 +0000836Stack size: 9
Yury Selivanoveb636452016-09-08 22:01:51 -0700837Flags: OPTIMIZED, NEWLOCALS, NOFREE, COROUTINE
Yury Selivanov75445082015-05-11 22:57:16 -0400838Constants:
839 0: None
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200840 1: 1
841Names:
842 0: b
Serhiy Storchaka702f8f32018-03-23 14:34:35 +0200843 1: c
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +0200844Variable names:
845 0: a
846 1: d"""
Yury Selivanov75445082015-05-11 22:57:16 -0400847
Nick Coghlaneae2da12010-08-17 08:03:36 +0000848class CodeInfoTests(unittest.TestCase):
849 test_pairs = [
850 (dis.code_info, code_info_code_info),
851 (tricky, code_info_tricky),
852 (co_tricky_nested_f, code_info_tricky_nested_f),
853 (expr_str, code_info_expr_str),
854 (simple_stmt_str, code_info_simple_stmt_str),
855 (compound_stmt_str, code_info_compound_stmt_str),
Yury Selivanov75445082015-05-11 22:57:16 -0400856 (async_def, code_info_async_def)
Nick Coghlaneae2da12010-08-17 08:03:36 +0000857 ]
858
859 def test_code_info(self):
860 self.maxDiff = 1000
861 for x, expected in self.test_pairs:
Ezio Melottied3a7d22010-12-01 02:32:32 +0000862 self.assertRegex(dis.code_info(x), expected)
Nick Coghlaneae2da12010-08-17 08:03:36 +0000863
864 def test_show_code(self):
865 self.maxDiff = 1000
866 for x, expected in self.test_pairs:
867 with captured_stdout() as output:
868 dis.show_code(x)
Ezio Melottied3a7d22010-12-01 02:32:32 +0000869 self.assertRegex(output.getvalue(), expected+"\n")
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000870 output = io.StringIO()
871 dis.show_code(x, file=output)
872 self.assertRegex(output.getvalue(), expected)
Nick Coghlaneae2da12010-08-17 08:03:36 +0000873
Benjamin Petersond6afe722011-03-15 14:44:52 -0500874 def test_code_info_object(self):
875 self.assertRaises(TypeError, dis.code_info, object())
876
877 def test_pretty_flags_no_flags(self):
878 self.assertEqual(dis.pretty_flags(0), '0x0')
879
880
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000881# Fodder for instruction introspection tests
882# Editing any of these may require recalculating the expected output
883def outer(a=1, b=2):
884 def f(c=3, d=4):
885 def inner(e=5, f=6):
886 print(a, b, c, d, e, f)
887 print(a, b, c, d)
888 return inner
889 print(a, b, '', 1, [], {}, "Hello world!")
890 return f
891
892def jumpy():
893 # This won't actually run (but that's OK, we only disassemble it)
894 for i in range(10):
895 print(i)
896 if i < 4:
897 continue
898 if i > 6:
899 break
900 else:
901 print("I can haz else clause?")
902 while i:
903 print(i)
904 i -= 1
905 if i > 6:
906 continue
907 if i < 4:
908 break
909 else:
910 print("Who let lolcatz into this test suite?")
911 try:
912 1 / 0
913 except ZeroDivisionError:
914 print("Here we go, here we go, here we go...")
915 else:
916 with i as dodgy:
917 print("Never reach this")
918 finally:
919 print("OK, now we're done")
920
921# End fodder for opinfo generation tests
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000922expected_outer_line = 1
923_line_offset = outer.__code__.co_firstlineno - 1
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000924code_object_f = outer.__code__.co_consts[3]
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000925expected_f_line = code_object_f.co_firstlineno - _line_offset
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000926code_object_inner = code_object_f.co_consts[3]
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000927expected_inner_line = code_object_inner.co_firstlineno - _line_offset
928expected_jumpy_line = 1
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000929
930# The following lines are useful to regenerate the expected results after
931# either the fodder is modified or the bytecode generation changes
932# After regeneration, update the references to code_object_f and
933# code_object_inner before rerunning the tests
934
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000935#_instructions = dis.get_instructions(outer, first_line=expected_outer_line)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000936#print('expected_opinfo_outer = [\n ',
937 #',\n '.join(map(str, _instructions)), ',\n]', sep='')
Antoine Pitroue7811fc2014-09-18 03:06:50 +0200938#_instructions = dis.get_instructions(outer(), first_line=expected_f_line)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000939#print('expected_opinfo_f = [\n ',
940 #',\n '.join(map(str, _instructions)), ',\n]', sep='')
Antoine Pitroue7811fc2014-09-18 03:06:50 +0200941#_instructions = dis.get_instructions(outer()(), first_line=expected_inner_line)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000942#print('expected_opinfo_inner = [\n ',
943 #',\n '.join(map(str, _instructions)), ',\n]', sep='')
Nick Coghlan90b8e7d2013-11-06 22:08:36 +1000944#_instructions = dis.get_instructions(jumpy, first_line=expected_jumpy_line)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000945#print('expected_opinfo_jumpy = [\n ',
946 #',\n '.join(map(str, _instructions)), ',\n]', sep='')
947
948
949Instruction = dis.Instruction
950expected_opinfo_outer = [
Serhiy Storchaka64204de2016-06-12 17:36:24 +0300951 Instruction(opname='LOAD_CONST', opcode=100, arg=8, argval=(3, 4), argrepr='(3, 4)', offset=0, starts_line=2, is_jump_target=False),
952 Instruction(opname='LOAD_CLOSURE', opcode=135, arg=0, argval='a', argrepr='a', offset=2, starts_line=None, is_jump_target=False),
953 Instruction(opname='LOAD_CLOSURE', opcode=135, arg=1, argval='b', argrepr='b', offset=4, starts_line=None, is_jump_target=False),
954 Instruction(opname='BUILD_TUPLE', opcode=102, arg=2, argval=2, argrepr='', offset=6, starts_line=None, is_jump_target=False),
955 Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=code_object_f, argrepr=repr(code_object_f), offset=8, starts_line=None, is_jump_target=False),
956 Instruction(opname='LOAD_CONST', opcode=100, arg=4, argval='outer.<locals>.f', argrepr="'outer.<locals>.f'", offset=10, starts_line=None, is_jump_target=False),
Serhiy Storchakae2732d32018-03-11 11:07:06 +0200957 Instruction(opname='MAKE_FUNCTION', opcode=132, arg=9, argval=9, argrepr='defaults, closure', offset=12, starts_line=None, is_jump_target=False),
Serhiy Storchaka64204de2016-06-12 17:36:24 +0300958 Instruction(opname='STORE_FAST', opcode=125, arg=2, argval='f', argrepr='f', offset=14, starts_line=None, is_jump_target=False),
959 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=0, argval='print', argrepr='print', offset=16, starts_line=7, is_jump_target=False),
960 Instruction(opname='LOAD_DEREF', opcode=136, arg=0, argval='a', argrepr='a', offset=18, starts_line=None, is_jump_target=False),
961 Instruction(opname='LOAD_DEREF', opcode=136, arg=1, argval='b', argrepr='b', offset=20, starts_line=None, is_jump_target=False),
962 Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval='', argrepr="''", offset=22, starts_line=None, is_jump_target=False),
963 Instruction(opname='LOAD_CONST', opcode=100, arg=6, argval=1, argrepr='1', offset=24, starts_line=None, is_jump_target=False),
964 Instruction(opname='BUILD_LIST', opcode=103, arg=0, argval=0, argrepr='', offset=26, starts_line=None, is_jump_target=False),
965 Instruction(opname='BUILD_MAP', opcode=105, arg=0, argval=0, argrepr='', offset=28, starts_line=None, is_jump_target=False),
966 Instruction(opname='LOAD_CONST', opcode=100, arg=7, argval='Hello world!', argrepr="'Hello world!'", offset=30, starts_line=None, is_jump_target=False),
Victor Stinnerf9b760f2016-09-09 10:17:08 -0700967 Instruction(opname='CALL_FUNCTION', opcode=131, arg=7, argval=7, argrepr='', offset=32, starts_line=None, is_jump_target=False),
Serhiy Storchaka64204de2016-06-12 17:36:24 +0300968 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=34, starts_line=None, is_jump_target=False),
969 Instruction(opname='LOAD_FAST', opcode=124, arg=2, argval='f', argrepr='f', offset=36, starts_line=8, is_jump_target=False),
970 Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=38, starts_line=None, is_jump_target=False),
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000971]
972
973expected_opinfo_f = [
Serhiy Storchaka64204de2016-06-12 17:36:24 +0300974 Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval=(5, 6), argrepr='(5, 6)', offset=0, starts_line=3, is_jump_target=False),
975 Instruction(opname='LOAD_CLOSURE', opcode=135, arg=2, argval='a', argrepr='a', offset=2, starts_line=None, is_jump_target=False),
976 Instruction(opname='LOAD_CLOSURE', opcode=135, arg=3, argval='b', argrepr='b', offset=4, starts_line=None, is_jump_target=False),
977 Instruction(opname='LOAD_CLOSURE', opcode=135, arg=0, argval='c', argrepr='c', offset=6, starts_line=None, is_jump_target=False),
978 Instruction(opname='LOAD_CLOSURE', opcode=135, arg=1, argval='d', argrepr='d', offset=8, starts_line=None, is_jump_target=False),
979 Instruction(opname='BUILD_TUPLE', opcode=102, arg=4, argval=4, argrepr='', offset=10, starts_line=None, is_jump_target=False),
980 Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=code_object_inner, argrepr=repr(code_object_inner), offset=12, starts_line=None, is_jump_target=False),
981 Instruction(opname='LOAD_CONST', opcode=100, arg=4, argval='outer.<locals>.f.<locals>.inner', argrepr="'outer.<locals>.f.<locals>.inner'", offset=14, starts_line=None, is_jump_target=False),
Serhiy Storchakae2732d32018-03-11 11:07:06 +0200982 Instruction(opname='MAKE_FUNCTION', opcode=132, arg=9, argval=9, argrepr='defaults, closure', offset=16, starts_line=None, is_jump_target=False),
Serhiy Storchaka64204de2016-06-12 17:36:24 +0300983 Instruction(opname='STORE_FAST', opcode=125, arg=2, argval='inner', argrepr='inner', offset=18, starts_line=None, is_jump_target=False),
984 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=0, argval='print', argrepr='print', offset=20, starts_line=5, is_jump_target=False),
985 Instruction(opname='LOAD_DEREF', opcode=136, arg=2, argval='a', argrepr='a', offset=22, starts_line=None, is_jump_target=False),
986 Instruction(opname='LOAD_DEREF', opcode=136, arg=3, argval='b', argrepr='b', offset=24, starts_line=None, is_jump_target=False),
987 Instruction(opname='LOAD_DEREF', opcode=136, arg=0, argval='c', argrepr='c', offset=26, starts_line=None, is_jump_target=False),
988 Instruction(opname='LOAD_DEREF', opcode=136, arg=1, argval='d', argrepr='d', offset=28, starts_line=None, is_jump_target=False),
Victor Stinnerf9b760f2016-09-09 10:17:08 -0700989 Instruction(opname='CALL_FUNCTION', opcode=131, arg=4, argval=4, argrepr='', offset=30, starts_line=None, is_jump_target=False),
Serhiy Storchaka64204de2016-06-12 17:36:24 +0300990 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=32, starts_line=None, is_jump_target=False),
991 Instruction(opname='LOAD_FAST', opcode=124, arg=2, argval='inner', argrepr='inner', offset=34, starts_line=6, is_jump_target=False),
992 Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=36, starts_line=None, is_jump_target=False),
Nick Coghlanb39fd0c2013-05-06 23:59:20 +1000993]
994
995expected_opinfo_inner = [
996 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=0, argval='print', argrepr='print', offset=0, starts_line=4, is_jump_target=False),
Serhiy Storchakab0f80b02016-05-24 09:15:14 +0300997 Instruction(opname='LOAD_DEREF', opcode=136, arg=0, argval='a', argrepr='a', offset=2, starts_line=None, is_jump_target=False),
998 Instruction(opname='LOAD_DEREF', opcode=136, arg=1, argval='b', argrepr='b', offset=4, starts_line=None, is_jump_target=False),
999 Instruction(opname='LOAD_DEREF', opcode=136, arg=2, argval='c', argrepr='c', offset=6, starts_line=None, is_jump_target=False),
1000 Instruction(opname='LOAD_DEREF', opcode=136, arg=3, argval='d', argrepr='d', offset=8, starts_line=None, is_jump_target=False),
1001 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='e', argrepr='e', offset=10, starts_line=None, is_jump_target=False),
1002 Instruction(opname='LOAD_FAST', opcode=124, arg=1, argval='f', argrepr='f', offset=12, starts_line=None, is_jump_target=False),
Victor Stinnerf9b760f2016-09-09 10:17:08 -07001003 Instruction(opname='CALL_FUNCTION', opcode=131, arg=6, argval=6, argrepr='', offset=14, starts_line=None, is_jump_target=False),
Serhiy Storchakab0f80b02016-05-24 09:15:14 +03001004 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=16, starts_line=None, is_jump_target=False),
1005 Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=18, starts_line=None, is_jump_target=False),
1006 Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=20, starts_line=None, is_jump_target=False),
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001007]
1008
1009expected_opinfo_jumpy = [
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +02001010 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=0, argval='range', argrepr='range', offset=0, starts_line=3, is_jump_target=False),
1011 Instruction(opname='LOAD_CONST', opcode=100, arg=1, argval=10, argrepr='10', offset=2, starts_line=None, is_jump_target=False),
1012 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=4, starts_line=None, is_jump_target=False),
1013 Instruction(opname='GET_ITER', opcode=68, arg=None, argval=None, argrepr='', offset=6, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001014 Instruction(opname='FOR_ITER', opcode=93, arg=17, argval=44, argrepr='to 44', offset=8, starts_line=None, is_jump_target=True),
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +02001015 Instruction(opname='STORE_FAST', opcode=125, arg=0, argval='i', argrepr='i', offset=10, starts_line=None, is_jump_target=False),
1016 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=12, starts_line=4, is_jump_target=False),
1017 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=14, starts_line=None, is_jump_target=False),
1018 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=16, starts_line=None, is_jump_target=False),
1019 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=18, starts_line=None, is_jump_target=False),
1020 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=20, starts_line=5, is_jump_target=False),
1021 Instruction(opname='LOAD_CONST', opcode=100, arg=2, argval=4, argrepr='4', offset=22, starts_line=None, is_jump_target=False),
1022 Instruction(opname='COMPARE_OP', opcode=107, arg=0, argval='<', argrepr='<', offset=24, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001023 Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=15, argval=30, argrepr='to 30', offset=26, starts_line=None, is_jump_target=False),
1024 Instruction(opname='JUMP_ABSOLUTE', opcode=113, arg=4, argval=8, argrepr='to 8', offset=28, starts_line=6, is_jump_target=False),
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +02001025 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=30, starts_line=7, is_jump_target=True),
1026 Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=6, argrepr='6', offset=32, starts_line=None, is_jump_target=False),
1027 Instruction(opname='COMPARE_OP', opcode=107, arg=4, argval='>', argrepr='>', offset=34, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001028 Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=21, argval=42, argrepr='to 42', offset=36, starts_line=None, is_jump_target=False),
Serhiy Storchaka520b7ae2018-02-22 23:33:30 +02001029 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=38, starts_line=8, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001030 Instruction(opname='JUMP_ABSOLUTE', opcode=113, arg=26, argval=52, argrepr='to 52', offset=40, starts_line=None, is_jump_target=False),
1031 Instruction(opname='JUMP_ABSOLUTE', opcode=113, arg=4, argval=8, argrepr='to 8', offset=42, starts_line=7, is_jump_target=True),
Mark Shannon28b75c82020-12-23 11:43:10 +00001032 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=44, starts_line=10, is_jump_target=True),
1033 Instruction(opname='LOAD_CONST', opcode=100, arg=4, argval='I can haz else clause?', argrepr="'I can haz else clause?'", offset=46, starts_line=None, is_jump_target=False),
1034 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=48, starts_line=None, is_jump_target=False),
1035 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=50, starts_line=None, is_jump_target=False),
1036 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=52, starts_line=11, is_jump_target=True),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001037 Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=48, argval=96, argrepr='to 96', offset=54, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001038 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=56, starts_line=12, is_jump_target=True),
1039 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=58, starts_line=None, is_jump_target=False),
1040 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=60, starts_line=None, is_jump_target=False),
1041 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=62, starts_line=None, is_jump_target=False),
1042 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=64, starts_line=13, is_jump_target=False),
1043 Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval=1, argrepr='1', offset=66, starts_line=None, is_jump_target=False),
1044 Instruction(opname='INPLACE_SUBTRACT', opcode=56, arg=None, argval=None, argrepr='', offset=68, starts_line=None, is_jump_target=False),
1045 Instruction(opname='STORE_FAST', opcode=125, arg=0, argval='i', argrepr='i', offset=70, starts_line=None, is_jump_target=False),
1046 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=72, starts_line=14, is_jump_target=False),
1047 Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=6, argrepr='6', offset=74, starts_line=None, is_jump_target=False),
1048 Instruction(opname='COMPARE_OP', opcode=107, arg=4, argval='>', argrepr='>', offset=76, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001049 Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=41, argval=82, argrepr='to 82', offset=78, starts_line=None, is_jump_target=False),
1050 Instruction(opname='JUMP_ABSOLUTE', opcode=113, arg=26, argval=52, argrepr='to 52', offset=80, starts_line=15, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001051 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=82, starts_line=16, is_jump_target=True),
1052 Instruction(opname='LOAD_CONST', opcode=100, arg=2, argval=4, argrepr='4', offset=84, starts_line=None, is_jump_target=False),
1053 Instruction(opname='COMPARE_OP', opcode=107, arg=0, argval='<', argrepr='<', offset=86, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001054 Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=46, argval=92, argrepr='to 92', offset=88, starts_line=None, is_jump_target=False),
1055 Instruction(opname='JUMP_ABSOLUTE', opcode=113, arg=52, argval=104, argrepr='to 104', offset=90, starts_line=17, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001056 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=92, starts_line=11, is_jump_target=True),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001057 Instruction(opname='POP_JUMP_IF_TRUE', opcode=115, arg=28, argval=56, argrepr='to 56', offset=94, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001058 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=96, starts_line=19, is_jump_target=True),
1059 Instruction(opname='LOAD_CONST', opcode=100, arg=6, argval='Who let lolcatz into this test suite?', argrepr="'Who let lolcatz into this test suite?'", offset=98, starts_line=None, is_jump_target=False),
1060 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=100, starts_line=None, is_jump_target=False),
1061 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=102, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001062 Instruction(opname='SETUP_FINALLY', opcode=122, arg=48, argval=202, argrepr='to 202', offset=104, starts_line=20, is_jump_target=True),
1063 Instruction(opname='SETUP_FINALLY', opcode=122, arg=6, argval=120, argrepr='to 120', offset=106, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001064 Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval=1, argrepr='1', offset=108, starts_line=21, is_jump_target=False),
1065 Instruction(opname='LOAD_CONST', opcode=100, arg=7, argval=0, argrepr='0', offset=110, starts_line=None, is_jump_target=False),
1066 Instruction(opname='BINARY_TRUE_DIVIDE', opcode=27, arg=None, argval=None, argrepr='', offset=112, starts_line=None, is_jump_target=False),
1067 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=114, starts_line=None, is_jump_target=False),
1068 Instruction(opname='POP_BLOCK', opcode=87, arg=None, argval=None, argrepr='', offset=116, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001069 Instruction(opname='JUMP_FORWARD', opcode=110, arg=12, argval=144, argrepr='to 144', offset=118, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001070 Instruction(opname='DUP_TOP', opcode=4, arg=None, argval=None, argrepr='', offset=120, starts_line=22, is_jump_target=True),
1071 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=2, argval='ZeroDivisionError', argrepr='ZeroDivisionError', offset=122, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001072 Instruction(opname='JUMP_IF_NOT_EXC_MATCH', opcode=121, arg=106, argval=212, argrepr='to 212', offset=124, starts_line=None, is_jump_target=False),
Mark Shannon8473cf82020-12-15 11:07:50 +00001073 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=126, starts_line=None, is_jump_target=False),
1074 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=128, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001075 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=130, starts_line=None, is_jump_target=False),
1076 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=132, starts_line=23, is_jump_target=False),
1077 Instruction(opname='LOAD_CONST', opcode=100, arg=8, argval='Here we go, here we go, here we go...', argrepr="'Here we go, here we go, here we go...'", offset=134, starts_line=None, is_jump_target=False),
1078 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=136, starts_line=None, is_jump_target=False),
1079 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=138, starts_line=None, is_jump_target=False),
1080 Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=140, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001081 Instruction(opname='JUMP_FORWARD', opcode=110, arg=22, argval=188, argrepr='to 188', offset=142, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001082 Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=144, starts_line=25, is_jump_target=True),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001083 Instruction(opname='SETUP_WITH', opcode=143, arg=12, argval=172, argrepr='to 172', offset=146, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001084 Instruction(opname='STORE_FAST', opcode=125, arg=1, argval='dodgy', argrepr='dodgy', offset=148, starts_line=None, is_jump_target=False),
1085 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=150, starts_line=26, is_jump_target=False),
1086 Instruction(opname='LOAD_CONST', opcode=100, arg=9, argval='Never reach this', argrepr="'Never reach this'", offset=152, starts_line=None, is_jump_target=False),
1087 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=154, starts_line=None, is_jump_target=False),
1088 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=156, starts_line=None, is_jump_target=False),
1089 Instruction(opname='POP_BLOCK', opcode=87, arg=None, argval=None, argrepr='', offset=158, starts_line=None, is_jump_target=False),
1090 Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=160, starts_line=None, is_jump_target=False),
Mark Shannon8473cf82020-12-15 11:07:50 +00001091 Instruction(opname='DUP_TOP', opcode=4, arg=None, argval=None, argrepr='', offset=162, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001092 Instruction(opname='DUP_TOP', opcode=4, arg=None, argval=None, argrepr='', offset=164, starts_line=None, is_jump_target=False),
1093 Instruction(opname='CALL_FUNCTION', opcode=131, arg=3, argval=3, argrepr='', offset=166, starts_line=None, is_jump_target=False),
1094 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=168, starts_line=None, is_jump_target=False),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001095 Instruction(opname='JUMP_FORWARD', opcode=110, arg=8, argval=188, argrepr='to 188', offset=170, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001096 Instruction(opname='WITH_EXCEPT_START', opcode=49, arg=None, argval=None, argrepr='', offset=172, starts_line=None, is_jump_target=True),
Mark Shannonfcb55c02021-04-01 16:00:31 +01001097 Instruction(opname='POP_JUMP_IF_TRUE', opcode=115, arg=89, argval=178, argrepr='to 178', offset=174, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001098 Instruction(opname='RERAISE', opcode=119, arg=1, argval=1, argrepr='', offset=176, starts_line=None, is_jump_target=False),
1099 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=178, starts_line=None, is_jump_target=True),
Mark Shannon8473cf82020-12-15 11:07:50 +00001100 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=180, starts_line=None, is_jump_target=False),
Mark Shannon28b75c82020-12-23 11:43:10 +00001101 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=182, starts_line=None, is_jump_target=False),
1102 Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=184, starts_line=None, is_jump_target=False),
1103 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=186, starts_line=None, is_jump_target=False),
1104 Instruction(opname='POP_BLOCK', opcode=87, arg=None, argval=None, argrepr='', offset=188, starts_line=None, is_jump_target=True),
1105 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=190, starts_line=28, is_jump_target=False),
1106 Instruction(opname='LOAD_CONST', opcode=100, arg=10, argval="OK, now we're done", argrepr='"OK, now we\'re done"', offset=192, starts_line=None, is_jump_target=False),
1107 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=194, starts_line=None, is_jump_target=False),
1108 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=196, starts_line=None, is_jump_target=False),
1109 Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=198, starts_line=None, is_jump_target=False),
1110 Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=200, starts_line=None, is_jump_target=False),
1111 Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='print', offset=202, starts_line=None, is_jump_target=True),
1112 Instruction(opname='LOAD_CONST', opcode=100, arg=10, argval="OK, now we're done", argrepr='"OK, now we\'re done"', offset=204, starts_line=None, is_jump_target=False),
1113 Instruction(opname='CALL_FUNCTION', opcode=131, arg=1, argval=1, argrepr='', offset=206, starts_line=None, is_jump_target=False),
1114 Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=208, starts_line=None, is_jump_target=False),
1115 Instruction(opname='RERAISE', opcode=119, arg=0, argval=0, argrepr='', offset=210, starts_line=None, is_jump_target=False),
1116 Instruction(opname='RERAISE', opcode=119, arg=0, argval=0, argrepr='', offset=212, starts_line=22, is_jump_target=True),
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001117]
1118
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001119# One last piece of inspect fodder to check the default line number handling
1120def simple(): pass
1121expected_opinfo_simple = [
1122 Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=0, starts_line=simple.__code__.co_firstlineno, is_jump_target=False),
Serhiy Storchakab0f80b02016-05-24 09:15:14 +03001123 Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=2, starts_line=None, is_jump_target=False)
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001124]
1125
1126
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001127class InstructionTests(BytecodeTestCase):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001128
Mark Shannonfee55262019-11-21 09:11:43 +00001129 def __init__(self, *args):
1130 super().__init__(*args)
1131 self.maxDiff = None
1132
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001133 def test_default_first_line(self):
1134 actual = dis.get_instructions(simple)
1135 self.assertEqual(list(actual), expected_opinfo_simple)
1136
1137 def test_first_line_set_to_None(self):
1138 actual = dis.get_instructions(simple, first_line=None)
1139 self.assertEqual(list(actual), expected_opinfo_simple)
1140
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001141 def test_outer(self):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001142 actual = dis.get_instructions(outer, first_line=expected_outer_line)
1143 self.assertEqual(list(actual), expected_opinfo_outer)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001144
1145 def test_nested(self):
1146 with captured_stdout():
1147 f = outer()
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001148 actual = dis.get_instructions(f, first_line=expected_f_line)
1149 self.assertEqual(list(actual), expected_opinfo_f)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001150
1151 def test_doubly_nested(self):
1152 with captured_stdout():
1153 inner = outer()()
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001154 actual = dis.get_instructions(inner, first_line=expected_inner_line)
1155 self.assertEqual(list(actual), expected_opinfo_inner)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001156
1157 def test_jumpy(self):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001158 actual = dis.get_instructions(jumpy, first_line=expected_jumpy_line)
1159 self.assertEqual(list(actual), expected_opinfo_jumpy)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001160
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001161# get_instructions has its own tests above, so can rely on it to validate
1162# the object oriented API
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001163class BytecodeTests(unittest.TestCase):
Mark Shannonfee55262019-11-21 09:11:43 +00001164
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001165 def test_instantiation(self):
1166 # Test with function, method, code string and code object
1167 for obj in [_f, _C(1).__init__, "a=1", _f.__code__]:
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001168 with self.subTest(obj=obj):
1169 b = dis.Bytecode(obj)
1170 self.assertIsInstance(b.codeobj, types.CodeType)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001171
1172 self.assertRaises(TypeError, dis.Bytecode, object())
1173
1174 def test_iteration(self):
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001175 for obj in [_f, _C(1).__init__, "a=1", _f.__code__]:
1176 with self.subTest(obj=obj):
1177 via_object = list(dis.Bytecode(obj))
1178 via_generator = list(dis.get_instructions(obj))
1179 self.assertEqual(via_object, via_generator)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001180
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001181 def test_explicit_first_line(self):
1182 actual = dis.Bytecode(outer, first_line=expected_outer_line)
1183 self.assertEqual(list(actual), expected_opinfo_outer)
1184
1185 def test_source_line_in_disassembly(self):
1186 # Use the line in the source code
syncosmicfe2b56a2017-08-17 19:29:21 -07001187 actual = dis.Bytecode(simple).dis()
1188 actual = actual.strip().partition(" ")[0] # extract the line no
1189 expected = str(simple.__code__.co_firstlineno)
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001190 self.assertEqual(actual, expected)
1191 # Use an explicit first line number
syncosmicfe2b56a2017-08-17 19:29:21 -07001192 actual = dis.Bytecode(simple, first_line=350).dis()
1193 actual = actual.strip().partition(" ")[0] # extract the line no
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001194 self.assertEqual(actual, "350")
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001195
1196 def test_info(self):
1197 self.maxDiff = 1000
1198 for x, expected in CodeInfoTests.test_pairs:
1199 b = dis.Bytecode(x)
1200 self.assertRegex(b.info(), expected)
1201
Nick Coghlan90b8e7d2013-11-06 22:08:36 +10001202 def test_disassembled(self):
1203 actual = dis.Bytecode(_f).dis()
1204 self.assertEqual(actual, dis_f)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001205
Nick Coghlan50c48b82013-11-23 00:57:00 +10001206 def test_from_traceback(self):
1207 tb = get_tb()
1208 b = dis.Bytecode.from_traceback(tb)
1209 while tb.tb_next: tb = tb.tb_next
1210
1211 self.assertEqual(b.current_offset, tb.tb_lasti)
1212
1213 def test_from_traceback_dis(self):
1214 tb = get_tb()
1215 b = dis.Bytecode.from_traceback(tb)
1216 self.assertEqual(b.dis(), dis_traceback)
Nick Coghlanb39fd0c2013-05-06 23:59:20 +10001217
Max Bernstein6e799be2020-12-17 16:30:29 -08001218
1219class TestBytecodeTestCase(BytecodeTestCase):
1220 def test_assert_not_in_with_op_not_in_bytecode(self):
1221 code = compile("a = 1", "<string>", "exec")
1222 self.assertInBytecode(code, "LOAD_CONST", 1)
1223 self.assertNotInBytecode(code, "LOAD_NAME")
1224 self.assertNotInBytecode(code, "LOAD_NAME", "a")
1225
1226 def test_assert_not_in_with_arg_not_in_bytecode(self):
1227 code = compile("a = 1", "<string>", "exec")
1228 self.assertInBytecode(code, "LOAD_CONST")
1229 self.assertInBytecode(code, "LOAD_CONST", 1)
1230 self.assertNotInBytecode(code, "LOAD_CONST", 2)
1231
1232 def test_assert_not_in_with_arg_in_bytecode(self):
1233 code = compile("a = 1", "<string>", "exec")
1234 with self.assertRaises(AssertionError):
1235 self.assertNotInBytecode(code, "LOAD_CONST", 1)
1236
Skip Montanaroadd0ccc2003-02-27 21:27:07 +00001237if __name__ == "__main__":
Zachary Waree80e8062013-12-26 09:53:49 -06001238 unittest.main()