mirror of https://github.com/python/cpython
2228 lines
93 KiB
Python
2228 lines
93 KiB
Python
# Minimal tests for dis module
|
|
|
|
import contextlib
|
|
import dis
|
|
import io
|
|
import re
|
|
import sys
|
|
import types
|
|
import unittest
|
|
from test.support import (captured_stdout, requires_debug_ranges,
|
|
requires_specialization, cpython_only)
|
|
from test.support.bytecode_helper import BytecodeTestCase
|
|
|
|
import opcode
|
|
|
|
|
|
def get_tb():
|
|
def _error():
|
|
try:
|
|
1 / 0
|
|
except Exception as e:
|
|
tb = e.__traceback__
|
|
return tb
|
|
|
|
tb = _error()
|
|
while tb.tb_next:
|
|
tb = tb.tb_next
|
|
return tb
|
|
|
|
TRACEBACK_CODE = get_tb().tb_frame.f_code
|
|
|
|
class _C:
|
|
def __init__(self, x):
|
|
self.x = x == 1
|
|
|
|
@staticmethod
|
|
def sm(x):
|
|
x = x == 1
|
|
|
|
@classmethod
|
|
def cm(cls, x):
|
|
cls.x = x == 1
|
|
|
|
dis_c_instance_method = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_FAST 1 (x)
|
|
LOAD_CONST 1 (1)
|
|
COMPARE_OP 72 (==)
|
|
LOAD_FAST 0 (self)
|
|
STORE_ATTR 0 (x)
|
|
RETURN_CONST 0 (None)
|
|
""" % (_C.__init__.__code__.co_firstlineno, _C.__init__.__code__.co_firstlineno + 1,)
|
|
|
|
dis_c_instance_method_bytes = """\
|
|
RESUME 0
|
|
LOAD_FAST 1
|
|
LOAD_CONST 1
|
|
COMPARE_OP 72 (==)
|
|
LOAD_FAST 0
|
|
STORE_ATTR 0
|
|
RETURN_CONST 0
|
|
"""
|
|
|
|
dis_c_class_method = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_FAST 1 (x)
|
|
LOAD_CONST 1 (1)
|
|
COMPARE_OP 72 (==)
|
|
LOAD_FAST 0 (cls)
|
|
STORE_ATTR 0 (x)
|
|
RETURN_CONST 0 (None)
|
|
""" % (_C.cm.__code__.co_firstlineno, _C.cm.__code__.co_firstlineno + 2,)
|
|
|
|
dis_c_static_method = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_FAST 0 (x)
|
|
LOAD_CONST 1 (1)
|
|
COMPARE_OP 72 (==)
|
|
STORE_FAST 0 (x)
|
|
RETURN_CONST 0 (None)
|
|
""" % (_C.sm.__code__.co_firstlineno, _C.sm.__code__.co_firstlineno + 2,)
|
|
|
|
# Class disassembling info has an extra newline at end.
|
|
dis_c = """\
|
|
Disassembly of %s:
|
|
%s
|
|
Disassembly of %s:
|
|
%s
|
|
Disassembly of %s:
|
|
%s
|
|
""" % (_C.__init__.__name__, dis_c_instance_method,
|
|
_C.cm.__name__, dis_c_class_method,
|
|
_C.sm.__name__, dis_c_static_method)
|
|
|
|
def _f(a):
|
|
print(a)
|
|
return 1
|
|
|
|
dis_f = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_GLOBAL 1 (NULL + print)
|
|
LOAD_FAST 0 (a)
|
|
CALL 1
|
|
POP_TOP
|
|
|
|
%3d RETURN_CONST 1 (1)
|
|
""" % (_f.__code__.co_firstlineno,
|
|
_f.__code__.co_firstlineno + 1,
|
|
_f.__code__.co_firstlineno + 2)
|
|
|
|
|
|
dis_f_co_code = """\
|
|
RESUME 0
|
|
LOAD_GLOBAL 1
|
|
LOAD_FAST 0
|
|
CALL 1
|
|
POP_TOP
|
|
RETURN_CONST 1
|
|
"""
|
|
|
|
|
|
def bug708901():
|
|
for res in range(1,
|
|
10):
|
|
pass
|
|
|
|
dis_bug708901 = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_GLOBAL 1 (NULL + range)
|
|
LOAD_CONST 1 (1)
|
|
|
|
%3d LOAD_CONST 2 (10)
|
|
|
|
%3d CALL 2
|
|
GET_ITER
|
|
>> FOR_ITER 3 (to 36)
|
|
STORE_FAST 0 (res)
|
|
|
|
%3d JUMP_BACKWARD 5 (to 26)
|
|
|
|
%3d >> END_FOR
|
|
RETURN_CONST 0 (None)
|
|
""" % (bug708901.__code__.co_firstlineno,
|
|
bug708901.__code__.co_firstlineno + 1,
|
|
bug708901.__code__.co_firstlineno + 2,
|
|
bug708901.__code__.co_firstlineno + 1,
|
|
bug708901.__code__.co_firstlineno + 3,
|
|
bug708901.__code__.co_firstlineno + 1)
|
|
|
|
|
|
def bug1333982(x=[]):
|
|
assert 0, ((s for s in x) +
|
|
1)
|
|
pass
|
|
|
|
dis_bug1333982 = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_ASSERTION_ERROR
|
|
LOAD_CONST 1 (<code object <genexpr> at 0x..., file "%s", line %d>)
|
|
MAKE_FUNCTION
|
|
LOAD_FAST 0 (x)
|
|
GET_ITER
|
|
CALL 0
|
|
|
|
%3d LOAD_CONST 2 (1)
|
|
|
|
%3d BINARY_OP 0 (+)
|
|
CALL 0
|
|
RAISE_VARARGS 1
|
|
""" % (bug1333982.__code__.co_firstlineno,
|
|
bug1333982.__code__.co_firstlineno + 1,
|
|
__file__,
|
|
bug1333982.__code__.co_firstlineno + 1,
|
|
bug1333982.__code__.co_firstlineno + 2,
|
|
bug1333982.__code__.co_firstlineno + 1)
|
|
|
|
|
|
def bug42562():
|
|
pass
|
|
|
|
|
|
# Set line number for 'pass' to None
|
|
bug42562.__code__ = bug42562.__code__.replace(co_linetable=b'\xf8')
|
|
|
|
|
|
dis_bug42562 = """\
|
|
RESUME 0
|
|
RETURN_CONST 0 (None)
|
|
"""
|
|
|
|
# Extended arg followed by NOP
|
|
code_bug_45757 = bytes([
|
|
0x90, 0x01, # EXTENDED_ARG 0x01
|
|
0x09, 0xFF, # NOP 0xFF
|
|
0x90, 0x01, # EXTENDED_ARG 0x01
|
|
0x64, 0x29, # LOAD_CONST 0x29
|
|
0x53, 0x00, # RETURN_VALUE 0x00
|
|
])
|
|
|
|
dis_bug_45757 = """\
|
|
EXTENDED_ARG 1
|
|
NOP
|
|
EXTENDED_ARG 1
|
|
LOAD_CONST 297
|
|
RETURN_VALUE
|
|
"""
|
|
|
|
# [255, 255, 255, 252] is -4 in a 4 byte signed integer
|
|
bug46724 = bytes([
|
|
opcode.EXTENDED_ARG, 255,
|
|
opcode.EXTENDED_ARG, 255,
|
|
opcode.EXTENDED_ARG, 255,
|
|
opcode.opmap['JUMP_FORWARD'], 252,
|
|
])
|
|
|
|
|
|
dis_bug46724 = """\
|
|
>> EXTENDED_ARG 255
|
|
EXTENDED_ARG 65535
|
|
EXTENDED_ARG 16777215
|
|
JUMP_FORWARD -4 (to 0)
|
|
"""
|
|
|
|
def func_w_kwargs(a, b, **c):
|
|
pass
|
|
|
|
def wrap_func_w_kwargs():
|
|
func_w_kwargs(1, 2, c=5)
|
|
|
|
dis_kw_names = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_GLOBAL 1 (NULL + func_w_kwargs)
|
|
LOAD_CONST 1 (1)
|
|
LOAD_CONST 2 (2)
|
|
LOAD_CONST 3 (5)
|
|
KW_NAMES 4 (('c',))
|
|
CALL 3
|
|
POP_TOP
|
|
RETURN_CONST 0 (None)
|
|
""" % (wrap_func_w_kwargs.__code__.co_firstlineno,
|
|
wrap_func_w_kwargs.__code__.co_firstlineno + 1)
|
|
|
|
dis_intrinsic_1_2 = """\
|
|
0 RESUME 0
|
|
|
|
1 LOAD_CONST 0 (0)
|
|
LOAD_CONST 1 (('*',))
|
|
IMPORT_NAME 0 (math)
|
|
CALL_INTRINSIC_1 2 (INTRINSIC_IMPORT_STAR)
|
|
POP_TOP
|
|
RETURN_CONST 2 (None)
|
|
"""
|
|
|
|
dis_intrinsic_1_5 = """\
|
|
0 RESUME 0
|
|
|
|
1 LOAD_NAME 0 (a)
|
|
CALL_INTRINSIC_1 5 (INTRINSIC_UNARY_POSITIVE)
|
|
RETURN_VALUE
|
|
"""
|
|
|
|
dis_intrinsic_1_6 = """\
|
|
0 RESUME 0
|
|
|
|
1 BUILD_LIST 0
|
|
LOAD_NAME 0 (a)
|
|
LIST_EXTEND 1
|
|
CALL_INTRINSIC_1 6 (INTRINSIC_LIST_TO_TUPLE)
|
|
RETURN_VALUE
|
|
"""
|
|
|
|
_BIG_LINENO_FORMAT = """\
|
|
1 RESUME 0
|
|
|
|
%3d LOAD_GLOBAL 0 (spam)
|
|
POP_TOP
|
|
RETURN_CONST 0 (None)
|
|
"""
|
|
|
|
_BIG_LINENO_FORMAT2 = """\
|
|
1 RESUME 0
|
|
|
|
%4d LOAD_GLOBAL 0 (spam)
|
|
POP_TOP
|
|
RETURN_CONST 0 (None)
|
|
"""
|
|
|
|
dis_module_expected_results = """\
|
|
Disassembly of f:
|
|
4 RESUME 0
|
|
RETURN_CONST 0 (None)
|
|
|
|
Disassembly of g:
|
|
5 RESUME 0
|
|
RETURN_CONST 0 (None)
|
|
|
|
"""
|
|
|
|
expr_str = "x + 1"
|
|
|
|
dis_expr_str = """\
|
|
0 RESUME 0
|
|
|
|
1 LOAD_NAME 0 (x)
|
|
LOAD_CONST 0 (1)
|
|
BINARY_OP 0 (+)
|
|
RETURN_VALUE
|
|
"""
|
|
|
|
simple_stmt_str = "x = x + 1"
|
|
|
|
dis_simple_stmt_str = """\
|
|
0 RESUME 0
|
|
|
|
1 LOAD_NAME 0 (x)
|
|
LOAD_CONST 0 (1)
|
|
BINARY_OP 0 (+)
|
|
STORE_NAME 0 (x)
|
|
RETURN_CONST 1 (None)
|
|
"""
|
|
|
|
annot_stmt_str = """\
|
|
|
|
x: int = 1
|
|
y: fun(1)
|
|
lst[fun(0)]: int = 1
|
|
"""
|
|
# leading newline is for a reason (tests lineno)
|
|
|
|
dis_annot_stmt_str = """\
|
|
0 RESUME 0
|
|
|
|
2 SETUP_ANNOTATIONS
|
|
LOAD_CONST 0 (1)
|
|
STORE_NAME 0 (x)
|
|
LOAD_NAME 1 (int)
|
|
LOAD_NAME 2 (__annotations__)
|
|
LOAD_CONST 1 ('x')
|
|
STORE_SUBSCR
|
|
|
|
3 PUSH_NULL
|
|
LOAD_NAME 3 (fun)
|
|
LOAD_CONST 0 (1)
|
|
CALL 1
|
|
LOAD_NAME 2 (__annotations__)
|
|
LOAD_CONST 2 ('y')
|
|
STORE_SUBSCR
|
|
|
|
4 LOAD_CONST 0 (1)
|
|
LOAD_NAME 4 (lst)
|
|
PUSH_NULL
|
|
LOAD_NAME 3 (fun)
|
|
LOAD_CONST 3 (0)
|
|
CALL 1
|
|
STORE_SUBSCR
|
|
LOAD_NAME 1 (int)
|
|
POP_TOP
|
|
RETURN_CONST 4 (None)
|
|
"""
|
|
|
|
compound_stmt_str = """\
|
|
x = 0
|
|
while 1:
|
|
x += 1"""
|
|
# Trailing newline has been deliberately omitted
|
|
|
|
dis_compound_stmt_str = """\
|
|
0 RESUME 0
|
|
|
|
1 LOAD_CONST 0 (0)
|
|
STORE_NAME 0 (x)
|
|
|
|
2 NOP
|
|
|
|
3 >> LOAD_NAME 0 (x)
|
|
LOAD_CONST 1 (1)
|
|
BINARY_OP 13 (+=)
|
|
STORE_NAME 0 (x)
|
|
|
|
2 JUMP_BACKWARD 7 (to 8)
|
|
"""
|
|
|
|
dis_traceback = """\
|
|
%3d RESUME 0
|
|
|
|
%3d NOP
|
|
|
|
%3d LOAD_CONST 1 (1)
|
|
LOAD_CONST 2 (0)
|
|
--> BINARY_OP 11 (/)
|
|
POP_TOP
|
|
|
|
%3d LOAD_FAST_CHECK 1 (tb)
|
|
RETURN_VALUE
|
|
>> PUSH_EXC_INFO
|
|
|
|
%3d LOAD_GLOBAL 0 (Exception)
|
|
CHECK_EXC_MATCH
|
|
POP_JUMP_IF_FALSE 23 (to 80)
|
|
STORE_FAST 0 (e)
|
|
|
|
%3d LOAD_FAST 0 (e)
|
|
LOAD_ATTR 2 (__traceback__)
|
|
STORE_FAST 1 (tb)
|
|
POP_EXCEPT
|
|
LOAD_CONST 0 (None)
|
|
STORE_FAST 0 (e)
|
|
DELETE_FAST 0 (e)
|
|
|
|
%3d LOAD_FAST 1 (tb)
|
|
RETURN_VALUE
|
|
>> LOAD_CONST 0 (None)
|
|
STORE_FAST 0 (e)
|
|
DELETE_FAST 0 (e)
|
|
RERAISE 1
|
|
|
|
%3d >> RERAISE 0
|
|
>> COPY 3
|
|
POP_EXCEPT
|
|
RERAISE 1
|
|
ExceptionTable:
|
|
4 rows
|
|
""" % (TRACEBACK_CODE.co_firstlineno,
|
|
TRACEBACK_CODE.co_firstlineno + 1,
|
|
TRACEBACK_CODE.co_firstlineno + 2,
|
|
TRACEBACK_CODE.co_firstlineno + 5,
|
|
TRACEBACK_CODE.co_firstlineno + 3,
|
|
TRACEBACK_CODE.co_firstlineno + 4,
|
|
TRACEBACK_CODE.co_firstlineno + 5,
|
|
TRACEBACK_CODE.co_firstlineno + 3)
|
|
|
|
def _fstring(a, b, c, d):
|
|
return f'{a} {b:4} {c!r} {d!r:4}'
|
|
|
|
dis_fstring = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_FAST 0 (a)
|
|
FORMAT_SIMPLE
|
|
LOAD_CONST 1 (' ')
|
|
LOAD_FAST 1 (b)
|
|
LOAD_CONST 2 ('4')
|
|
FORMAT_WITH_SPEC
|
|
LOAD_CONST 1 (' ')
|
|
LOAD_FAST 2 (c)
|
|
CONVERT_VALUE 2 (repr)
|
|
FORMAT_SIMPLE
|
|
LOAD_CONST 1 (' ')
|
|
LOAD_FAST 3 (d)
|
|
CONVERT_VALUE 2 (repr)
|
|
LOAD_CONST 2 ('4')
|
|
FORMAT_WITH_SPEC
|
|
BUILD_STRING 7
|
|
RETURN_VALUE
|
|
""" % (_fstring.__code__.co_firstlineno, _fstring.__code__.co_firstlineno + 1)
|
|
|
|
def _with(c):
|
|
with c:
|
|
x = 1
|
|
y = 2
|
|
|
|
dis_with = """\
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_FAST 0 (c)
|
|
BEFORE_WITH
|
|
POP_TOP
|
|
|
|
%3d LOAD_CONST 1 (1)
|
|
STORE_FAST 1 (x)
|
|
|
|
%3d LOAD_CONST 0 (None)
|
|
LOAD_CONST 0 (None)
|
|
LOAD_CONST 0 (None)
|
|
CALL 2
|
|
POP_TOP
|
|
|
|
%3d LOAD_CONST 2 (2)
|
|
STORE_FAST 2 (y)
|
|
RETURN_CONST 0 (None)
|
|
|
|
%3d >> PUSH_EXC_INFO
|
|
WITH_EXCEPT_START
|
|
TO_BOOL
|
|
POP_JUMP_IF_TRUE 1 (to 50)
|
|
RERAISE 2
|
|
>> POP_TOP
|
|
POP_EXCEPT
|
|
POP_TOP
|
|
POP_TOP
|
|
|
|
%3d LOAD_CONST 2 (2)
|
|
STORE_FAST 2 (y)
|
|
RETURN_CONST 0 (None)
|
|
>> COPY 3
|
|
POP_EXCEPT
|
|
RERAISE 1
|
|
ExceptionTable:
|
|
2 rows
|
|
""" % (_with.__code__.co_firstlineno,
|
|
_with.__code__.co_firstlineno + 1,
|
|
_with.__code__.co_firstlineno + 2,
|
|
_with.__code__.co_firstlineno + 1,
|
|
_with.__code__.co_firstlineno + 3,
|
|
_with.__code__.co_firstlineno + 1,
|
|
_with.__code__.co_firstlineno + 3,
|
|
)
|
|
|
|
async def _asyncwith(c):
|
|
async with c:
|
|
x = 1
|
|
y = 2
|
|
|
|
dis_asyncwith = """\
|
|
%3d RETURN_GENERATOR
|
|
POP_TOP
|
|
RESUME 0
|
|
|
|
%3d LOAD_FAST 0 (c)
|
|
BEFORE_ASYNC_WITH
|
|
GET_AWAITABLE 1
|
|
LOAD_CONST 0 (None)
|
|
>> SEND 3 (to 24)
|
|
YIELD_VALUE 2
|
|
RESUME 3
|
|
JUMP_BACKWARD_NO_INTERRUPT 5 (to 14)
|
|
>> END_SEND
|
|
POP_TOP
|
|
|
|
%3d LOAD_CONST 1 (1)
|
|
STORE_FAST 1 (x)
|
|
|
|
%3d LOAD_CONST 0 (None)
|
|
LOAD_CONST 0 (None)
|
|
LOAD_CONST 0 (None)
|
|
CALL 2
|
|
GET_AWAITABLE 2
|
|
LOAD_CONST 0 (None)
|
|
>> SEND 3 (to 60)
|
|
YIELD_VALUE 2
|
|
RESUME 3
|
|
JUMP_BACKWARD_NO_INTERRUPT 5 (to 50)
|
|
>> END_SEND
|
|
POP_TOP
|
|
|
|
%3d LOAD_CONST 2 (2)
|
|
STORE_FAST 2 (y)
|
|
RETURN_CONST 0 (None)
|
|
|
|
%3d >> CLEANUP_THROW
|
|
JUMP_BACKWARD 26 (to 24)
|
|
>> CLEANUP_THROW
|
|
JUMP_BACKWARD 11 (to 60)
|
|
>> PUSH_EXC_INFO
|
|
WITH_EXCEPT_START
|
|
GET_AWAITABLE 2
|
|
LOAD_CONST 0 (None)
|
|
>> SEND 4 (to 102)
|
|
YIELD_VALUE 3
|
|
RESUME 3
|
|
JUMP_BACKWARD_NO_INTERRUPT 5 (to 90)
|
|
>> CLEANUP_THROW
|
|
>> END_SEND
|
|
TO_BOOL
|
|
POP_JUMP_IF_TRUE 1 (to 116)
|
|
RERAISE 2
|
|
>> POP_TOP
|
|
POP_EXCEPT
|
|
POP_TOP
|
|
POP_TOP
|
|
|
|
%3d LOAD_CONST 2 (2)
|
|
STORE_FAST 2 (y)
|
|
RETURN_CONST 0 (None)
|
|
>> COPY 3
|
|
POP_EXCEPT
|
|
RERAISE 1
|
|
>> CALL_INTRINSIC_1 3 (INTRINSIC_STOPITERATION_ERROR)
|
|
RERAISE 1
|
|
ExceptionTable:
|
|
12 rows
|
|
""" % (_asyncwith.__code__.co_firstlineno,
|
|
_asyncwith.__code__.co_firstlineno + 1,
|
|
_asyncwith.__code__.co_firstlineno + 2,
|
|
_asyncwith.__code__.co_firstlineno + 1,
|
|
_asyncwith.__code__.co_firstlineno + 3,
|
|
_asyncwith.__code__.co_firstlineno + 1,
|
|
_asyncwith.__code__.co_firstlineno + 3,
|
|
)
|
|
|
|
|
|
def _tryfinally(a, b):
|
|
try:
|
|
return a
|
|
finally:
|
|
b()
|
|
|
|
def _tryfinallyconst(b):
|
|
try:
|
|
return 1
|
|
finally:
|
|
b()
|
|
|
|
dis_tryfinally = """\
|
|
%3d RESUME 0
|
|
|
|
%3d NOP
|
|
|
|
%3d LOAD_FAST 0 (a)
|
|
|
|
%3d PUSH_NULL
|
|
LOAD_FAST 1 (b)
|
|
CALL 0
|
|
POP_TOP
|
|
RETURN_VALUE
|
|
>> PUSH_EXC_INFO
|
|
PUSH_NULL
|
|
LOAD_FAST 1 (b)
|
|
CALL 0
|
|
POP_TOP
|
|
RERAISE 0
|
|
>> COPY 3
|
|
POP_EXCEPT
|
|
RERAISE 1
|
|
ExceptionTable:
|
|
2 rows
|
|
""" % (_tryfinally.__code__.co_firstlineno,
|
|
_tryfinally.__code__.co_firstlineno + 1,
|
|
_tryfinally.__code__.co_firstlineno + 2,
|
|
_tryfinally.__code__.co_firstlineno + 4,
|
|
)
|
|
|
|
dis_tryfinallyconst = """\
|
|
%3d RESUME 0
|
|
|
|
%3d NOP
|
|
|
|
%3d NOP
|
|
|
|
%3d PUSH_NULL
|
|
LOAD_FAST 0 (b)
|
|
CALL 0
|
|
POP_TOP
|
|
RETURN_CONST 1 (1)
|
|
PUSH_EXC_INFO
|
|
PUSH_NULL
|
|
LOAD_FAST 0 (b)
|
|
CALL 0
|
|
POP_TOP
|
|
RERAISE 0
|
|
>> COPY 3
|
|
POP_EXCEPT
|
|
RERAISE 1
|
|
ExceptionTable:
|
|
1 row
|
|
""" % (_tryfinallyconst.__code__.co_firstlineno,
|
|
_tryfinallyconst.__code__.co_firstlineno + 1,
|
|
_tryfinallyconst.__code__.co_firstlineno + 2,
|
|
_tryfinallyconst.__code__.co_firstlineno + 4,
|
|
)
|
|
|
|
def _g(x):
|
|
yield x
|
|
|
|
async def _ag(x):
|
|
yield x
|
|
|
|
async def _co(x):
|
|
async for item in _ag(x):
|
|
pass
|
|
|
|
def _h(y):
|
|
def foo(x):
|
|
'''funcdoc'''
|
|
return list(x + z for z in y)
|
|
return foo
|
|
|
|
dis_nested_0 = """\
|
|
MAKE_CELL 0 (y)
|
|
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_FAST 0 (y)
|
|
BUILD_TUPLE 1
|
|
LOAD_CONST 1 (<code object foo at 0x..., file "%s", line %d>)
|
|
MAKE_FUNCTION
|
|
SET_FUNCTION_ATTRIBUTE 8 (closure)
|
|
STORE_FAST 1 (foo)
|
|
|
|
%3d LOAD_FAST 1 (foo)
|
|
RETURN_VALUE
|
|
""" % (_h.__code__.co_firstlineno,
|
|
_h.__code__.co_firstlineno + 1,
|
|
__file__,
|
|
_h.__code__.co_firstlineno + 1,
|
|
_h.__code__.co_firstlineno + 4,
|
|
)
|
|
|
|
dis_nested_1 = """%s
|
|
Disassembly of <code object foo at 0x..., file "%s", line %d>:
|
|
COPY_FREE_VARS 1
|
|
MAKE_CELL 0 (x)
|
|
|
|
%3d RESUME 0
|
|
|
|
%3d LOAD_GLOBAL 1 (NULL + list)
|
|
LOAD_FAST 0 (x)
|
|
BUILD_TUPLE 1
|
|
LOAD_CONST 1 (<code object <genexpr> at 0x..., file "%s", line %d>)
|
|
MAKE_FUNCTION
|
|
SET_FUNCTION_ATTRIBUTE 8 (closure)
|
|
LOAD_DEREF 1 (y)
|
|
GET_ITER
|
|
CALL 0
|
|
CALL 1
|
|
RETURN_VALUE
|
|
""" % (dis_nested_0,
|
|
__file__,
|
|
_h.__code__.co_firstlineno + 1,
|
|
_h.__code__.co_firstlineno + 1,
|
|
_h.__code__.co_firstlineno + 3,
|
|
__file__,
|
|
_h.__code__.co_firstlineno + 3,
|
|
)
|
|
|
|
dis_nested_2 = """%s
|
|
Disassembly of <code object <genexpr> at 0x..., file "%s", line %d>:
|
|
COPY_FREE_VARS 1
|
|
|
|
%3d RETURN_GENERATOR
|
|
POP_TOP
|
|
RESUME 0
|
|
LOAD_FAST 0 (.0)
|
|
>> FOR_ITER 10 (to 34)
|
|
STORE_FAST 1 (z)
|
|
LOAD_DEREF 2 (x)
|
|
LOAD_FAST 1 (z)
|
|
BINARY_OP 0 (+)
|
|
YIELD_VALUE 1
|
|
RESUME 1
|
|
POP_TOP
|
|
JUMP_BACKWARD 12 (to 10)
|
|
>> END_FOR
|
|
RETURN_CONST 0 (None)
|
|
>> CALL_INTRINSIC_1 3 (INTRINSIC_STOPITERATION_ERROR)
|
|
RERAISE 1
|
|
ExceptionTable:
|
|
1 row
|
|
""" % (dis_nested_1,
|
|
__file__,
|
|
_h.__code__.co_firstlineno + 3,
|
|
_h.__code__.co_firstlineno + 3,
|
|
)
|
|
|
|
def load_test(x, y=0):
|
|
a, b = x, y
|
|
return a, b
|
|
|
|
dis_load_test_quickened_code = """\
|
|
%3d 0 RESUME 0
|
|
|
|
%3d 2 LOAD_FAST_LOAD_FAST 1 (x, y)
|
|
4 STORE_FAST_STORE_FAST 50 (b, a)
|
|
|
|
%3d 6 LOAD_FAST_LOAD_FAST 35 (a, b)
|
|
8 BUILD_TUPLE 2
|
|
10 RETURN_VALUE
|
|
""" % (load_test.__code__.co_firstlineno,
|
|
load_test.__code__.co_firstlineno + 1,
|
|
load_test.__code__.co_firstlineno + 2)
|
|
|
|
def loop_test():
|
|
for i in [1, 2, 3] * 3:
|
|
load_test(i)
|
|
|
|
dis_loop_test_quickened_code = """\
|
|
%3d RESUME 0
|
|
|
|
%3d BUILD_LIST 0
|
|
LOAD_CONST 1 ((1, 2, 3))
|
|
LIST_EXTEND 1
|
|
LOAD_CONST 2 (3)
|
|
BINARY_OP 5 (*)
|
|
GET_ITER
|
|
>> FOR_ITER_LIST 14 (to 48)
|
|
STORE_FAST 0 (i)
|
|
|
|
%3d LOAD_GLOBAL_MODULE 1 (NULL + load_test)
|
|
LOAD_FAST 0 (i)
|
|
CALL_PY_WITH_DEFAULTS 1
|
|
POP_TOP
|
|
JUMP_BACKWARD 16 (to 16)
|
|
|
|
%3d >> END_FOR
|
|
RETURN_CONST 0 (None)
|
|
""" % (loop_test.__code__.co_firstlineno,
|
|
loop_test.__code__.co_firstlineno + 1,
|
|
loop_test.__code__.co_firstlineno + 2,
|
|
loop_test.__code__.co_firstlineno + 1,)
|
|
|
|
def extended_arg_quick():
|
|
*_, _ = ...
|
|
|
|
dis_extended_arg_quick_code = """\
|
|
%3d 0 RESUME 0
|
|
|
|
%3d 2 LOAD_CONST 1 (Ellipsis)
|
|
4 EXTENDED_ARG 1
|
|
6 UNPACK_EX 256
|
|
8 POP_TOP
|
|
10 STORE_FAST 0 (_)
|
|
12 RETURN_CONST 0 (None)
|
|
"""% (extended_arg_quick.__code__.co_firstlineno,
|
|
extended_arg_quick.__code__.co_firstlineno + 1,)
|
|
|
|
ADAPTIVE_WARMUP_DELAY = 2
|
|
|
|
class DisTestBase(unittest.TestCase):
|
|
"Common utilities for DisTests and TestDisTraceback"
|
|
|
|
def strip_addresses(self, text):
|
|
return re.sub(r'\b0x[0-9A-Fa-f]+\b', '0x...', text)
|
|
|
|
def find_offset_column(self, lines):
|
|
for line in lines:
|
|
if line and not line.startswith("Disassembly"):
|
|
break
|
|
else:
|
|
return 0, 0
|
|
offset = 5
|
|
while (line[offset] == " "):
|
|
offset += 1
|
|
if (line[offset] == ">"):
|
|
offset += 2
|
|
while (line[offset] == " "):
|
|
offset += 1
|
|
end = offset
|
|
while line[end] in "0123456789":
|
|
end += 1
|
|
return end-5, end
|
|
|
|
def assert_offsets_increasing(self, text, delta):
|
|
expected_offset = 0
|
|
lines = text.splitlines()
|
|
start, end = self.find_offset_column(lines)
|
|
for line in lines:
|
|
if not line:
|
|
continue
|
|
if line.startswith("Disassembly"):
|
|
expected_offset = 0
|
|
continue
|
|
if line.startswith("Exception"):
|
|
break
|
|
offset = int(line[start:end])
|
|
self.assertGreaterEqual(offset, expected_offset, line)
|
|
expected_offset = offset + delta
|
|
|
|
def assert_exception_table_increasing(self, lines):
|
|
prev_start, prev_end = -1, -1
|
|
count = 0
|
|
for line in lines:
|
|
m = re.match(r' (\d+) to (\d+) -> \d+ \[\d+\]', line)
|
|
start, end = [int(g) for g in m.groups()]
|
|
self.assertGreaterEqual(end, start)
|
|
self.assertGreater(start, prev_end)
|
|
prev_start, prev_end = start, end
|
|
count += 1
|
|
return count
|
|
|
|
def strip_offsets(self, text):
|
|
lines = text.splitlines(True)
|
|
start, end = self.find_offset_column(lines)
|
|
res = []
|
|
lines = iter(lines)
|
|
for line in lines:
|
|
if line.startswith("Exception"):
|
|
res.append(line)
|
|
break
|
|
if not line or line.startswith("Disassembly"):
|
|
res.append(line)
|
|
else:
|
|
res.append(line[:start] + line[end:])
|
|
num_rows = self.assert_exception_table_increasing(lines)
|
|
if num_rows:
|
|
res.append(f"{num_rows} row{'s' if num_rows > 1 else ''}\n")
|
|
return "".join(res)
|
|
|
|
def do_disassembly_compare(self, got, expected, with_offsets=False):
|
|
if not with_offsets:
|
|
self.assert_offsets_increasing(got, 2)
|
|
got = self.strip_offsets(got)
|
|
if got != expected:
|
|
got = self.strip_addresses(got)
|
|
self.assertEqual(got, expected)
|
|
|
|
|
|
class DisTests(DisTestBase):
|
|
|
|
maxDiff = None
|
|
|
|
def get_disassembly(self, func, lasti=-1, wrapper=True, **kwargs):
|
|
# We want to test the default printing behaviour, not the file arg
|
|
output = io.StringIO()
|
|
with contextlib.redirect_stdout(output):
|
|
if wrapper:
|
|
dis.dis(func, **kwargs)
|
|
else:
|
|
dis.disassemble(func, lasti, **kwargs)
|
|
return output.getvalue()
|
|
|
|
def get_disassemble_as_string(self, func, lasti=-1):
|
|
return self.get_disassembly(func, lasti, False)
|
|
|
|
def do_disassembly_test(self, func, expected, with_offsets=False):
|
|
self.maxDiff = None
|
|
got = self.get_disassembly(func, depth=0)
|
|
self.do_disassembly_compare(got, expected, with_offsets)
|
|
# Add checks for dis.disco
|
|
if hasattr(func, '__code__'):
|
|
got_disco = io.StringIO()
|
|
with contextlib.redirect_stdout(got_disco):
|
|
dis.disco(func.__code__)
|
|
self.do_disassembly_compare(got_disco.getvalue(), expected,
|
|
with_offsets)
|
|
|
|
def test_opmap(self):
|
|
self.assertEqual(dis.opmap["NOP"], 9)
|
|
self.assertIn(dis.opmap["LOAD_CONST"], dis.hasconst)
|
|
self.assertIn(dis.opmap["STORE_NAME"], dis.hasname)
|
|
|
|
def test_opname(self):
|
|
self.assertEqual(dis.opname[dis.opmap["LOAD_FAST"]], "LOAD_FAST")
|
|
|
|
def test_boundaries(self):
|
|
self.assertEqual(dis.opmap["EXTENDED_ARG"], dis.EXTENDED_ARG)
|
|
self.assertEqual(dis.opmap["STORE_NAME"], dis.HAVE_ARGUMENT)
|
|
|
|
def test_widths(self):
|
|
long_opcodes = set(['JUMP_BACKWARD_NO_INTERRUPT',
|
|
'INSTRUMENTED_CALL_FUNCTION_EX'])
|
|
for opcode, opname in enumerate(dis.opname):
|
|
if opname in long_opcodes or opname.startswith("INSTRUMENTED"):
|
|
continue
|
|
with self.subTest(opname=opname):
|
|
width = dis._OPNAME_WIDTH
|
|
if opcode in dis.hasarg:
|
|
width += 1 + dis._OPARG_WIDTH
|
|
self.assertLessEqual(len(opname), width)
|
|
|
|
def test_dis(self):
|
|
self.do_disassembly_test(_f, dis_f)
|
|
|
|
def test_bug_708901(self):
|
|
self.do_disassembly_test(bug708901, dis_bug708901)
|
|
|
|
def test_bug_1333982(self):
|
|
# This one is checking bytecodes generated for an `assert` statement,
|
|
# so fails if the tests are run with -O. Skip this test then.
|
|
if not __debug__:
|
|
self.skipTest('need asserts, run without -O')
|
|
|
|
self.do_disassembly_test(bug1333982, dis_bug1333982)
|
|
|
|
def test_bug_42562(self):
|
|
self.do_disassembly_test(bug42562, dis_bug42562)
|
|
|
|
def test_bug_45757(self):
|
|
# Extended arg followed by NOP
|
|
self.do_disassembly_test(code_bug_45757, dis_bug_45757)
|
|
|
|
def test_bug_46724(self):
|
|
# Test that negative operargs are handled properly
|
|
self.do_disassembly_test(bug46724, dis_bug46724)
|
|
|
|
def test_kw_names(self):
|
|
# Test that value is displayed for KW_NAMES
|
|
self.do_disassembly_test(wrap_func_w_kwargs, dis_kw_names)
|
|
|
|
def test_intrinsic_1(self):
|
|
# Test that argrepr is displayed for CALL_INTRINSIC_1
|
|
self.do_disassembly_test("from math import *", dis_intrinsic_1_2)
|
|
self.do_disassembly_test("+a", dis_intrinsic_1_5)
|
|
self.do_disassembly_test("(*a,)", dis_intrinsic_1_6)
|
|
|
|
def test_intrinsic_2(self):
|
|
self.assertIn("CALL_INTRINSIC_2 1 (INTRINSIC_PREP_RERAISE_STAR)",
|
|
self.get_disassembly("try: pass\nexcept* Exception: x"))
|
|
|
|
def test_big_linenos(self):
|
|
def func(count):
|
|
namespace = {}
|
|
func = "def foo():\n " + "".join(["\n "] * count + ["spam\n"])
|
|
exec(func, namespace)
|
|
return namespace['foo']
|
|
|
|
# Test all small ranges
|
|
for i in range(1, 300):
|
|
expected = _BIG_LINENO_FORMAT % (i + 2)
|
|
self.do_disassembly_test(func(i), expected)
|
|
|
|
# Test some larger ranges too
|
|
for i in range(300, 1000, 10):
|
|
expected = _BIG_LINENO_FORMAT % (i + 2)
|
|
self.do_disassembly_test(func(i), expected)
|
|
|
|
for i in range(1000, 5000, 10):
|
|
expected = _BIG_LINENO_FORMAT2 % (i + 2)
|
|
self.do_disassembly_test(func(i), expected)
|
|
|
|
from test import dis_module
|
|
self.do_disassembly_test(dis_module, dis_module_expected_results)
|
|
|
|
def test_big_offsets(self):
|
|
self.maxDiff = None
|
|
def func(count):
|
|
namespace = {}
|
|
func = "def foo(x):\n " + ";".join(["x = x + 1"] * count) + "\n return x"
|
|
exec(func, namespace)
|
|
return namespace['foo']
|
|
|
|
def expected(count, w):
|
|
s = ['''\
|
|
1 %*d RESUME 0
|
|
|
|
2 %*d LOAD_FAST 0 (x)
|
|
%*d LOAD_CONST 1 (1)
|
|
%*d BINARY_OP 0 (+)
|
|
''' % (w, 0, w, 2, w, 4, w, 6)]
|
|
s += ['''\
|
|
%*d STORE_FAST_LOAD_FAST 0 (x, x)
|
|
%*d LOAD_CONST 1 (1)
|
|
%*d BINARY_OP 0 (+)
|
|
''' % (w, 8*i + 10, w, 8*i + 12, w, 8*i + 14)
|
|
for i in range(count-1)]
|
|
s += ['''\
|
|
%*d STORE_FAST 0 (x)
|
|
|
|
3 %*d LOAD_FAST 0 (x)
|
|
%*d RETURN_VALUE
|
|
''' % (w, 8*count + 2, w, 8*count + 4, w, 8*count + 6)]
|
|
return ''.join(s)
|
|
|
|
for i in range(1, 5):
|
|
self.do_disassembly_test(func(i), expected(i, 4), True)
|
|
self.do_disassembly_test(func(1200), expected(1200, 4), True)
|
|
self.do_disassembly_test(func(1300), expected(1300, 5), True)
|
|
|
|
def test_disassemble_str(self):
|
|
self.do_disassembly_test(expr_str, dis_expr_str)
|
|
self.do_disassembly_test(simple_stmt_str, dis_simple_stmt_str)
|
|
self.do_disassembly_test(annot_stmt_str, dis_annot_stmt_str)
|
|
self.do_disassembly_test(compound_stmt_str, dis_compound_stmt_str)
|
|
|
|
def test_disassemble_bytes(self):
|
|
self.do_disassembly_test(_f.__code__.co_code, dis_f_co_code)
|
|
|
|
def test_disassemble_class(self):
|
|
self.do_disassembly_test(_C, dis_c)
|
|
|
|
def test_disassemble_instance_method(self):
|
|
self.do_disassembly_test(_C(1).__init__, dis_c_instance_method)
|
|
|
|
def test_disassemble_instance_method_bytes(self):
|
|
method_bytecode = _C(1).__init__.__code__.co_code
|
|
self.do_disassembly_test(method_bytecode, dis_c_instance_method_bytes)
|
|
|
|
def test_disassemble_static_method(self):
|
|
self.do_disassembly_test(_C.sm, dis_c_static_method)
|
|
|
|
def test_disassemble_class_method(self):
|
|
self.do_disassembly_test(_C.cm, dis_c_class_method)
|
|
|
|
def test_disassemble_generator(self):
|
|
gen_func_disas = self.get_disassembly(_g) # Generator function
|
|
gen_disas = self.get_disassembly(_g(1)) # Generator iterator
|
|
self.assertEqual(gen_disas, gen_func_disas)
|
|
|
|
def test_disassemble_async_generator(self):
|
|
agen_func_disas = self.get_disassembly(_ag) # Async generator function
|
|
agen_disas = self.get_disassembly(_ag(1)) # Async generator iterator
|
|
self.assertEqual(agen_disas, agen_func_disas)
|
|
|
|
def test_disassemble_coroutine(self):
|
|
coro_func_disas = self.get_disassembly(_co) # Coroutine function
|
|
coro = _co(1) # Coroutine object
|
|
coro.close() # Avoid a RuntimeWarning (never awaited)
|
|
coro_disas = self.get_disassembly(coro)
|
|
self.assertEqual(coro_disas, coro_func_disas)
|
|
|
|
def test_disassemble_fstring(self):
|
|
self.do_disassembly_test(_fstring, dis_fstring)
|
|
|
|
def test_disassemble_with(self):
|
|
self.do_disassembly_test(_with, dis_with)
|
|
|
|
def test_disassemble_asyncwith(self):
|
|
self.do_disassembly_test(_asyncwith, dis_asyncwith)
|
|
|
|
def test_disassemble_try_finally(self):
|
|
self.do_disassembly_test(_tryfinally, dis_tryfinally)
|
|
self.do_disassembly_test(_tryfinallyconst, dis_tryfinallyconst)
|
|
|
|
def test_dis_none(self):
|
|
try:
|
|
del sys.last_exc
|
|
except AttributeError:
|
|
pass
|
|
try:
|
|
del sys.last_traceback
|
|
except AttributeError:
|
|
pass
|
|
self.assertRaises(RuntimeError, dis.dis, None)
|
|
|
|
def test_dis_traceback(self):
|
|
self.maxDiff = None
|
|
try:
|
|
del sys.last_traceback
|
|
except AttributeError:
|
|
pass
|
|
|
|
try:
|
|
1/0
|
|
except Exception as e:
|
|
tb = e.__traceback__
|
|
sys.last_exc = e
|
|
|
|
tb_dis = self.get_disassemble_as_string(tb.tb_frame.f_code, tb.tb_lasti)
|
|
self.do_disassembly_test(None, tb_dis, True)
|
|
|
|
def test_dis_object(self):
|
|
self.assertRaises(TypeError, dis.dis, object())
|
|
|
|
def test_disassemble_recursive(self):
|
|
def check(expected, **kwargs):
|
|
dis = self.get_disassembly(_h, **kwargs)
|
|
dis = self.strip_addresses(dis)
|
|
dis = self.strip_offsets(dis)
|
|
self.assertEqual(dis, expected)
|
|
|
|
check(dis_nested_0, depth=0)
|
|
check(dis_nested_1, depth=1)
|
|
check(dis_nested_2, depth=2)
|
|
check(dis_nested_2, depth=3)
|
|
check(dis_nested_2, depth=None)
|
|
check(dis_nested_2)
|
|
|
|
def test__try_compile_no_context_exc_on_error(self):
|
|
# see gh-102114
|
|
try:
|
|
dis._try_compile(")", "")
|
|
except Exception as e:
|
|
self.assertIsNone(e.__context__)
|
|
|
|
@staticmethod
|
|
def code_quicken(f, times=ADAPTIVE_WARMUP_DELAY):
|
|
for _ in range(times):
|
|
f()
|
|
|
|
@cpython_only
|
|
@requires_specialization
|
|
def test_super_instructions(self):
|
|
self.code_quicken(lambda: load_test(0, 0))
|
|
got = self.get_disassembly(load_test, adaptive=True)
|
|
self.do_disassembly_compare(got, dis_load_test_quickened_code, True)
|
|
|
|
@cpython_only
|
|
@requires_specialization
|
|
def test_binary_specialize(self):
|
|
binary_op_quicken = """\
|
|
0 0 RESUME 0
|
|
|
|
1 2 LOAD_NAME 0 (a)
|
|
4 LOAD_NAME 1 (b)
|
|
6 %s
|
|
10 RETURN_VALUE
|
|
"""
|
|
co_int = compile('a + b', "<int>", "eval")
|
|
self.code_quicken(lambda: exec(co_int, {}, {'a': 1, 'b': 2}))
|
|
got = self.get_disassembly(co_int, adaptive=True)
|
|
self.do_disassembly_compare(got, binary_op_quicken % "BINARY_OP_ADD_INT 0 (+)", True)
|
|
|
|
co_unicode = compile('a + b', "<unicode>", "eval")
|
|
self.code_quicken(lambda: exec(co_unicode, {}, {'a': 'a', 'b': 'b'}))
|
|
got = self.get_disassembly(co_unicode, adaptive=True)
|
|
self.do_disassembly_compare(got, binary_op_quicken % "BINARY_OP_ADD_UNICODE 0 (+)", True)
|
|
|
|
binary_subscr_quicken = """\
|
|
0 0 RESUME 0
|
|
|
|
1 2 LOAD_NAME 0 (a)
|
|
4 LOAD_CONST 0 (0)
|
|
6 %s
|
|
10 RETURN_VALUE
|
|
"""
|
|
co_list = compile('a[0]', "<list>", "eval")
|
|
self.code_quicken(lambda: exec(co_list, {}, {'a': [0]}))
|
|
got = self.get_disassembly(co_list, adaptive=True)
|
|
self.do_disassembly_compare(got, binary_subscr_quicken % "BINARY_SUBSCR_LIST_INT", True)
|
|
|
|
co_dict = compile('a[0]', "<dict>", "eval")
|
|
self.code_quicken(lambda: exec(co_dict, {}, {'a': {0: '1'}}))
|
|
got = self.get_disassembly(co_dict, adaptive=True)
|
|
self.do_disassembly_compare(got, binary_subscr_quicken % "BINARY_SUBSCR_DICT", True)
|
|
|
|
@cpython_only
|
|
@requires_specialization
|
|
def test_load_attr_specialize(self):
|
|
load_attr_quicken = """\
|
|
0 0 RESUME 0
|
|
|
|
1 2 LOAD_CONST 0 ('a')
|
|
4 LOAD_ATTR_SLOT 0 (__class__)
|
|
24 RETURN_VALUE
|
|
"""
|
|
co = compile("'a'.__class__", "", "eval")
|
|
self.code_quicken(lambda: exec(co, {}, {}))
|
|
got = self.get_disassembly(co, adaptive=True)
|
|
self.do_disassembly_compare(got, load_attr_quicken, True)
|
|
|
|
@cpython_only
|
|
@requires_specialization
|
|
def test_call_specialize(self):
|
|
call_quicken = """\
|
|
0 RESUME 0
|
|
|
|
1 PUSH_NULL
|
|
LOAD_NAME 0 (str)
|
|
LOAD_CONST 0 (1)
|
|
CALL_NO_KW_STR_1 1
|
|
RETURN_VALUE
|
|
"""
|
|
co = compile("str(1)", "", "eval")
|
|
self.code_quicken(lambda: exec(co, {}, {}))
|
|
got = self.get_disassembly(co, adaptive=True)
|
|
self.do_disassembly_compare(got, call_quicken)
|
|
|
|
@cpython_only
|
|
@requires_specialization
|
|
def test_loop_quicken(self):
|
|
# Loop can trigger a quicken where the loop is located
|
|
self.code_quicken(loop_test, 1)
|
|
got = self.get_disassembly(loop_test, adaptive=True)
|
|
self.do_disassembly_compare(got, dis_loop_test_quickened_code)
|
|
|
|
@cpython_only
|
|
def test_extended_arg_quick(self):
|
|
got = self.get_disassembly(extended_arg_quick)
|
|
self.do_disassembly_compare(got, dis_extended_arg_quick_code, True)
|
|
|
|
def get_cached_values(self, quickened, adaptive):
|
|
def f():
|
|
l = []
|
|
for i in range(42):
|
|
l.append(i)
|
|
if quickened:
|
|
self.code_quicken(f)
|
|
else:
|
|
# "copy" the code to un-quicken it:
|
|
f.__code__ = f.__code__.replace()
|
|
for instruction in dis.get_instructions(
|
|
f, show_caches=True, adaptive=adaptive
|
|
):
|
|
if instruction.opname == "CACHE":
|
|
yield instruction.argrepr
|
|
|
|
@cpython_only
|
|
def test_show_caches(self):
|
|
for quickened in (False, True):
|
|
for adaptive in (False, True):
|
|
with self.subTest(f"{quickened=}, {adaptive=}"):
|
|
if adaptive:
|
|
pattern = r"^(\w+: \d+)?$"
|
|
else:
|
|
pattern = r"^(\w+: 0)?$"
|
|
caches = list(self.get_cached_values(quickened, adaptive))
|
|
for cache in caches:
|
|
self.assertRegex(cache, pattern)
|
|
total_caches = 21
|
|
empty_caches = 7
|
|
self.assertEqual(caches.count(""), empty_caches)
|
|
self.assertEqual(len(caches), total_caches)
|
|
|
|
@cpython_only
|
|
def test_show_currinstr_with_cache(self):
|
|
"""
|
|
Make sure that with lasti pointing to CACHE, it still shows the current
|
|
line correctly
|
|
"""
|
|
def f():
|
|
print(a)
|
|
# The code above should generate a LOAD_GLOBAL which has CACHE instr after
|
|
# However, this might change in the future. So we explicitly try to find
|
|
# a CACHE entry in the instructions. If we can't do that, fail the test
|
|
|
|
for inst in dis.get_instructions(f, show_caches=True):
|
|
if inst.opname == "CACHE":
|
|
op_offset = inst.offset - 2
|
|
cache_offset = inst.offset
|
|
break
|
|
else:
|
|
self.fail("Can't find a CACHE entry in the function provided to do the test")
|
|
|
|
assem_op = self.get_disassembly(f.__code__, lasti=op_offset, wrapper=False)
|
|
assem_cache = self.get_disassembly(f.__code__, lasti=cache_offset, wrapper=False)
|
|
|
|
# Make sure --> exists and points to the correct offset
|
|
self.assertRegex(assem_op, fr"-->\s+{op_offset}")
|
|
# Make sure when lasti points to cache, it shows the same disassembly
|
|
self.assertEqual(assem_op, assem_cache)
|
|
|
|
|
|
class DisWithFileTests(DisTests):
|
|
|
|
# Run the tests again, using the file arg instead of print
|
|
def get_disassembly(self, func, lasti=-1, wrapper=True, **kwargs):
|
|
output = io.StringIO()
|
|
if wrapper:
|
|
dis.dis(func, file=output, **kwargs)
|
|
else:
|
|
dis.disassemble(func, lasti, file=output, **kwargs)
|
|
return output.getvalue()
|
|
|
|
|
|
if dis.code_info.__doc__ is None:
|
|
code_info_consts = "0: None"
|
|
else:
|
|
code_info_consts = "0: 'Formatted details of methods, functions, or code.'"
|
|
|
|
code_info_code_info = f"""\
|
|
Name: code_info
|
|
Filename: (.*)
|
|
Argument count: 1
|
|
Positional-only arguments: 0
|
|
Kw-only arguments: 0
|
|
Number of locals: 1
|
|
Stack size: \\d+
|
|
Flags: OPTIMIZED, NEWLOCALS
|
|
Constants:
|
|
{code_info_consts}
|
|
Names:
|
|
0: _format_code_info
|
|
1: _get_code_object
|
|
Variable names:
|
|
0: x"""
|
|
|
|
|
|
@staticmethod
|
|
def tricky(a, b, /, x, y, z=True, *args, c, d, e=[], **kwds):
|
|
def f(c=c):
|
|
print(a, b, x, y, z, c, d, e, f)
|
|
yield a, b, x, y, z, c, d, e, f
|
|
|
|
code_info_tricky = """\
|
|
Name: tricky
|
|
Filename: (.*)
|
|
Argument count: 5
|
|
Positional-only arguments: 2
|
|
Kw-only arguments: 3
|
|
Number of locals: 10
|
|
Stack size: \\d+
|
|
Flags: OPTIMIZED, NEWLOCALS, VARARGS, VARKEYWORDS, GENERATOR
|
|
Constants:
|
|
0: None
|
|
1: <code object f at (.*), file "(.*)", line (.*)>
|
|
Variable names:
|
|
0: a
|
|
1: b
|
|
2: x
|
|
3: y
|
|
4: z
|
|
5: c
|
|
6: d
|
|
7: e
|
|
8: args
|
|
9: kwds
|
|
Cell variables:
|
|
0: [abedfxyz]
|
|
1: [abedfxyz]
|
|
2: [abedfxyz]
|
|
3: [abedfxyz]
|
|
4: [abedfxyz]
|
|
5: [abedfxyz]"""
|
|
# NOTE: the order of the cell variables above depends on dictionary order!
|
|
|
|
co_tricky_nested_f = tricky.__func__.__code__.co_consts[1]
|
|
|
|
code_info_tricky_nested_f = """\
|
|
Filename: (.*)
|
|
Argument count: 1
|
|
Positional-only arguments: 0
|
|
Kw-only arguments: 0
|
|
Number of locals: 1
|
|
Stack size: \\d+
|
|
Flags: OPTIMIZED, NEWLOCALS, NESTED
|
|
Constants:
|
|
0: None
|
|
Names:
|
|
0: print
|
|
Variable names:
|
|
0: c
|
|
Free variables:
|
|
0: [abedfxyz]
|
|
1: [abedfxyz]
|
|
2: [abedfxyz]
|
|
3: [abedfxyz]
|
|
4: [abedfxyz]
|
|
5: [abedfxyz]"""
|
|
|
|
code_info_expr_str = """\
|
|
Name: <module>
|
|
Filename: <disassembly>
|
|
Argument count: 0
|
|
Positional-only arguments: 0
|
|
Kw-only arguments: 0
|
|
Number of locals: 0
|
|
Stack size: \\d+
|
|
Flags: 0x0
|
|
Constants:
|
|
0: 1
|
|
Names:
|
|
0: x"""
|
|
|
|
code_info_simple_stmt_str = """\
|
|
Name: <module>
|
|
Filename: <disassembly>
|
|
Argument count: 0
|
|
Positional-only arguments: 0
|
|
Kw-only arguments: 0
|
|
Number of locals: 0
|
|
Stack size: \\d+
|
|
Flags: 0x0
|
|
Constants:
|
|
0: 1
|
|
1: None
|
|
Names:
|
|
0: x"""
|
|
|
|
code_info_compound_stmt_str = """\
|
|
Name: <module>
|
|
Filename: <disassembly>
|
|
Argument count: 0
|
|
Positional-only arguments: 0
|
|
Kw-only arguments: 0
|
|
Number of locals: 0
|
|
Stack size: \\d+
|
|
Flags: 0x0
|
|
Constants:
|
|
0: 0
|
|
1: 1
|
|
Names:
|
|
0: x"""
|
|
|
|
|
|
async def async_def():
|
|
await 1
|
|
async for a in b: pass
|
|
async with c as d: pass
|
|
|
|
code_info_async_def = """\
|
|
Name: async_def
|
|
Filename: (.*)
|
|
Argument count: 0
|
|
Positional-only arguments: 0
|
|
Kw-only arguments: 0
|
|
Number of locals: 2
|
|
Stack size: \\d+
|
|
Flags: OPTIMIZED, NEWLOCALS, COROUTINE
|
|
Constants:
|
|
0: None
|
|
1: 1
|
|
Names:
|
|
0: b
|
|
1: c
|
|
Variable names:
|
|
0: a
|
|
1: d"""
|
|
|
|
class CodeInfoTests(unittest.TestCase):
|
|
test_pairs = [
|
|
(dis.code_info, code_info_code_info),
|
|
(tricky, code_info_tricky),
|
|
(co_tricky_nested_f, code_info_tricky_nested_f),
|
|
(expr_str, code_info_expr_str),
|
|
(simple_stmt_str, code_info_simple_stmt_str),
|
|
(compound_stmt_str, code_info_compound_stmt_str),
|
|
(async_def, code_info_async_def)
|
|
]
|
|
|
|
def test_code_info(self):
|
|
self.maxDiff = 1000
|
|
for x, expected in self.test_pairs:
|
|
self.assertRegex(dis.code_info(x), expected)
|
|
|
|
def test_show_code(self):
|
|
self.maxDiff = 1000
|
|
for x, expected in self.test_pairs:
|
|
with captured_stdout() as output:
|
|
dis.show_code(x)
|
|
self.assertRegex(output.getvalue(), expected+"\n")
|
|
output = io.StringIO()
|
|
dis.show_code(x, file=output)
|
|
self.assertRegex(output.getvalue(), expected)
|
|
|
|
def test_code_info_object(self):
|
|
self.assertRaises(TypeError, dis.code_info, object())
|
|
|
|
def test_pretty_flags_no_flags(self):
|
|
self.assertEqual(dis.pretty_flags(0), '0x0')
|
|
|
|
|
|
# Fodder for instruction introspection tests
|
|
# Editing any of these may require recalculating the expected output
|
|
def outer(a=1, b=2):
|
|
def f(c=3, d=4):
|
|
def inner(e=5, f=6):
|
|
print(a, b, c, d, e, f)
|
|
print(a, b, c, d)
|
|
return inner
|
|
print(a, b, '', 1, [], {}, "Hello world!")
|
|
return f
|
|
|
|
def jumpy():
|
|
# This won't actually run (but that's OK, we only disassemble it)
|
|
for i in range(10):
|
|
print(i)
|
|
if i < 4:
|
|
continue
|
|
if i > 6:
|
|
break
|
|
else:
|
|
print("I can haz else clause?")
|
|
while i:
|
|
print(i)
|
|
i -= 1
|
|
if i > 6:
|
|
continue
|
|
if i < 4:
|
|
break
|
|
else:
|
|
print("Who let lolcatz into this test suite?")
|
|
try:
|
|
1 / 0
|
|
except ZeroDivisionError:
|
|
print("Here we go, here we go, here we go...")
|
|
else:
|
|
with i as dodgy:
|
|
print("Never reach this")
|
|
finally:
|
|
print("OK, now we're done")
|
|
|
|
# End fodder for opinfo generation tests
|
|
expected_outer_line = 1
|
|
_line_offset = outer.__code__.co_firstlineno - 1
|
|
code_object_f = outer.__code__.co_consts[1]
|
|
expected_f_line = code_object_f.co_firstlineno - _line_offset
|
|
code_object_inner = code_object_f.co_consts[1]
|
|
expected_inner_line = code_object_inner.co_firstlineno - _line_offset
|
|
expected_jumpy_line = 1
|
|
|
|
# The following lines are useful to regenerate the expected results after
|
|
# either the fodder is modified or the bytecode generation changes
|
|
# After regeneration, update the references to code_object_f and
|
|
# code_object_inner before rerunning the tests
|
|
|
|
def _stringify_instruction(instr):
|
|
# Since line numbers and other offsets change a lot for these
|
|
# test cases, ignore them.
|
|
return f" {instr._replace(positions=None)!r},"
|
|
|
|
def _prepare_test_cases():
|
|
ignore = io.StringIO()
|
|
with contextlib.redirect_stdout(ignore):
|
|
f = outer()
|
|
inner = f()
|
|
_instructions_outer = dis.get_instructions(outer, first_line=expected_outer_line)
|
|
_instructions_f = dis.get_instructions(f, first_line=expected_f_line)
|
|
_instructions_inner = dis.get_instructions(inner, first_line=expected_inner_line)
|
|
_instructions_jumpy = dis.get_instructions(jumpy, first_line=expected_jumpy_line)
|
|
result = "\n".join(
|
|
[
|
|
"expected_opinfo_outer = [",
|
|
*map(_stringify_instruction, _instructions_outer),
|
|
"]",
|
|
"",
|
|
"expected_opinfo_f = [",
|
|
*map(_stringify_instruction, _instructions_f),
|
|
"]",
|
|
"",
|
|
"expected_opinfo_inner = [",
|
|
*map(_stringify_instruction, _instructions_inner),
|
|
"]",
|
|
"",
|
|
"expected_opinfo_jumpy = [",
|
|
*map(_stringify_instruction, _instructions_jumpy),
|
|
"]",
|
|
]
|
|
)
|
|
result = result.replace(repr(repr(code_object_f)), "repr(code_object_f)")
|
|
result = result.replace(repr(code_object_f), "code_object_f")
|
|
result = result.replace(repr(repr(code_object_inner)), "repr(code_object_inner)")
|
|
result = result.replace(repr(code_object_inner), "code_object_inner")
|
|
print(result)
|
|
|
|
# _prepare_test_cases()
|
|
|
|
Instruction = dis.Instruction
|
|
|
|
expected_opinfo_outer = [
|
|
Instruction(opname='MAKE_CELL', opcode=135, arg=0, argval='a', argrepr='a', offset=0, start_offset=0, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='MAKE_CELL', opcode=135, arg=1, argval='b', argrepr='b', offset=2, start_offset=2, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RESUME', opcode=151, arg=0, argval=0, argrepr='', offset=4, start_offset=4, starts_line=1, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval=(3, 4), argrepr='(3, 4)', offset=6, start_offset=6, starts_line=2, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='a', argrepr='a', offset=8, start_offset=8, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=1, argval='b', argrepr='b', offset=10, start_offset=10, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='BUILD_TUPLE', opcode=102, arg=2, argval=2, argrepr='', offset=12, start_offset=12, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=1, argval=code_object_f, argrepr=repr(code_object_f), offset=14, start_offset=14, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='MAKE_FUNCTION', opcode=24, arg=None, argval=None, argrepr='', offset=16, start_offset=16, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='SET_FUNCTION_ATTRIBUTE', opcode=177, arg=8, argval=8, argrepr='closure', offset=18, start_offset=18, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='SET_FUNCTION_ATTRIBUTE', opcode=177, arg=1, argval=1, argrepr='defaults', offset=20, start_offset=20, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='STORE_FAST', opcode=125, arg=2, argval='f', argrepr='f', offset=22, start_offset=22, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='NULL + print', offset=24, start_offset=24, starts_line=7, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=0, argval='a', argrepr='a', offset=34, start_offset=34, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=1, argval='b', argrepr='b', offset=36, start_offset=36, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=2, argval='', argrepr="''", offset=38, start_offset=38, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=1, argrepr='1', offset=40, start_offset=40, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='BUILD_LIST', opcode=103, arg=0, argval=0, argrepr='', offset=42, start_offset=42, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='BUILD_MAP', opcode=105, arg=0, argval=0, argrepr='', offset=44, start_offset=44, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=4, argval='Hello world!', argrepr="'Hello world!'", offset=46, start_offset=46, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=7, argval=7, argrepr='', offset=48, start_offset=48, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=56, start_offset=56, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=2, argval='f', argrepr='f', offset=58, start_offset=58, starts_line=8, is_jump_target=False, positions=None),
|
|
Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=60, start_offset=60, starts_line=None, is_jump_target=False, positions=None),
|
|
]
|
|
|
|
expected_opinfo_f = [
|
|
Instruction(opname='COPY_FREE_VARS', opcode=149, arg=2, argval=2, argrepr='', offset=0, start_offset=0, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='MAKE_CELL', opcode=135, arg=0, argval='c', argrepr='c', offset=2, start_offset=2, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='MAKE_CELL', opcode=135, arg=1, argval='d', argrepr='d', offset=4, start_offset=4, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RESUME', opcode=151, arg=0, argval=0, argrepr='', offset=6, start_offset=6, starts_line=2, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=2, argval=(5, 6), argrepr='(5, 6)', offset=8, start_offset=8, starts_line=3, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=3, argval='a', argrepr='a', offset=10, start_offset=10, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=4, argval='b', argrepr='b', offset=12, start_offset=12, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='c', argrepr='c', offset=14, start_offset=14, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=1, argval='d', argrepr='d', offset=16, start_offset=16, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='BUILD_TUPLE', opcode=102, arg=4, argval=4, argrepr='', offset=18, start_offset=18, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=1, argval=code_object_inner, argrepr=repr(code_object_inner), offset=20, start_offset=20, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='MAKE_FUNCTION', opcode=24, arg=None, argval=None, argrepr='', offset=22, start_offset=22, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='SET_FUNCTION_ATTRIBUTE', opcode=177, arg=8, argval=8, argrepr='closure', offset=24, start_offset=24, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='SET_FUNCTION_ATTRIBUTE', opcode=177, arg=1, argval=1, argrepr='defaults', offset=26, start_offset=26, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='STORE_FAST', opcode=125, arg=2, argval='inner', argrepr='inner', offset=28, start_offset=28, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='NULL + print', offset=30, start_offset=30, starts_line=5, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=3, argval='a', argrepr='a', offset=40, start_offset=40, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=4, argval='b', argrepr='b', offset=42, start_offset=42, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=0, argval='c', argrepr='c', offset=44, start_offset=44, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=1, argval='d', argrepr='d', offset=46, start_offset=46, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=4, argval=4, argrepr='', offset=48, start_offset=48, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=56, start_offset=56, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=2, argval='inner', argrepr='inner', offset=58, start_offset=58, starts_line=6, is_jump_target=False, positions=None),
|
|
Instruction(opname='RETURN_VALUE', opcode=83, arg=None, argval=None, argrepr='', offset=60, start_offset=60, starts_line=None, is_jump_target=False, positions=None),
|
|
]
|
|
|
|
expected_opinfo_inner = [
|
|
Instruction(opname='COPY_FREE_VARS', opcode=149, arg=4, argval=4, argrepr='', offset=0, start_offset=0, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RESUME', opcode=151, arg=0, argval=0, argrepr='', offset=2, start_offset=2, starts_line=3, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='print', argrepr='NULL + print', offset=4, start_offset=4, starts_line=4, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=2, argval='a', argrepr='a', offset=14, start_offset=14, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=3, argval='b', argrepr='b', offset=16, start_offset=16, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=4, argval='c', argrepr='c', offset=18, start_offset=18, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_DEREF', opcode=137, arg=5, argval='d', argrepr='d', offset=20, start_offset=20, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST_LOAD_FAST', opcode=168, arg=1, argval=('e', 'f'), argrepr='e, f', offset=22, start_offset=22, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=6, argval=6, argrepr='', offset=24, start_offset=24, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=32, start_offset=32, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RETURN_CONST', opcode=121, arg=0, argval=None, argrepr='None', offset=34, start_offset=34, starts_line=None, is_jump_target=False, positions=None),
|
|
]
|
|
|
|
expected_opinfo_jumpy = [
|
|
Instruction(opname='RESUME', opcode=151, arg=0, argval=0, argrepr='', offset=0, start_offset=0, starts_line=1, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=1, argval='range', argrepr='NULL + range', offset=2, start_offset=2, starts_line=3, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=1, argval=10, argrepr='10', offset=12, start_offset=12, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=14, start_offset=14, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='GET_ITER', opcode=68, arg=None, argval=None, argrepr='', offset=22, start_offset=22, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='FOR_ITER', opcode=93, arg=28, argval=84, argrepr='to 84', offset=24, start_offset=24, starts_line=None, is_jump_target=True, positions=None),
|
|
Instruction(opname='STORE_FAST', opcode=125, arg=0, argval='i', argrepr='i', offset=28, start_offset=28, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=30, start_offset=30, starts_line=4, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=40, start_offset=40, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=42, start_offset=42, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=50, start_offset=50, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=52, start_offset=52, starts_line=5, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=2, argval=4, argrepr='4', offset=54, start_offset=54, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='COMPARE_OP', opcode=107, arg=18, argval='<', argrepr='bool(<)', offset=56, start_offset=56, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=2, argval=66, argrepr='to 66', offset=60, start_offset=60, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_BACKWARD', opcode=140, arg=21, argval=24, argrepr='to 24', offset=62, start_offset=62, starts_line=6, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=66, start_offset=66, starts_line=7, is_jump_target=True, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=6, argrepr='6', offset=68, start_offset=68, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='COMPARE_OP', opcode=107, arg=148, argval='>', argrepr='bool(>)', offset=70, start_offset=70, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_TRUE', opcode=115, arg=2, argval=80, argrepr='to 80', offset=74, start_offset=74, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_BACKWARD', opcode=140, arg=28, argval=24, argrepr='to 24', offset=76, start_offset=76, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=80, start_offset=80, starts_line=8, is_jump_target=True, positions=None),
|
|
Instruction(opname='JUMP_FORWARD', opcode=110, arg=12, argval=108, argrepr='to 108', offset=82, start_offset=82, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='END_FOR', opcode=4, arg=None, argval=None, argrepr='', offset=84, start_offset=84, starts_line=3, is_jump_target=True, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=86, start_offset=86, starts_line=10, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=4, argval='I can haz else clause?', argrepr="'I can haz else clause?'", offset=96, start_offset=96, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=98, start_offset=98, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=106, start_offset=106, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST_CHECK', opcode=127, arg=0, argval='i', argrepr='i', offset=108, start_offset=108, starts_line=11, is_jump_target=True, positions=None),
|
|
Instruction(opname='TO_BOOL', opcode=6, arg=None, argval=None, argrepr='', offset=110, start_offset=110, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=37, argval=194, argrepr='to 194', offset=118, start_offset=118, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=120, start_offset=120, starts_line=12, is_jump_target=True, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=130, start_offset=130, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=132, start_offset=132, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=140, start_offset=140, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=142, start_offset=142, starts_line=13, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval=1, argrepr='1', offset=144, start_offset=144, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='BINARY_OP', opcode=122, arg=23, argval=23, argrepr='-=', offset=146, start_offset=146, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='STORE_FAST', opcode=125, arg=0, argval='i', argrepr='i', offset=150, start_offset=150, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=152, start_offset=152, starts_line=14, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=3, argval=6, argrepr='6', offset=154, start_offset=154, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='COMPARE_OP', opcode=107, arg=148, argval='>', argrepr='bool(>)', offset=156, start_offset=156, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=2, argval=166, argrepr='to 166', offset=160, start_offset=160, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_BACKWARD', opcode=140, arg=29, argval=108, argrepr='to 108', offset=162, start_offset=162, starts_line=15, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=166, start_offset=166, starts_line=16, is_jump_target=True, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=2, argval=4, argrepr='4', offset=168, start_offset=168, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='COMPARE_OP', opcode=107, arg=18, argval='<', argrepr='bool(<)', offset=170, start_offset=170, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=1, argval=178, argrepr='to 178', offset=174, start_offset=174, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_FORWARD', opcode=110, arg=19, argval=216, argrepr='to 216', offset=176, start_offset=176, starts_line=17, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=178, start_offset=178, starts_line=11, is_jump_target=True, positions=None),
|
|
Instruction(opname='TO_BOOL', opcode=6, arg=None, argval=None, argrepr='', offset=180, start_offset=180, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=2, argval=194, argrepr='to 194', offset=188, start_offset=188, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_BACKWARD', opcode=140, arg=37, argval=120, argrepr='to 120', offset=190, start_offset=190, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=194, start_offset=194, starts_line=19, is_jump_target=True, positions=None),
|
|
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=204, start_offset=204, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=206, start_offset=206, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=214, start_offset=214, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='NOP', opcode=9, arg=None, argval=None, argrepr='', offset=216, start_offset=216, starts_line=20, is_jump_target=True, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=5, argval=1, argrepr='1', offset=218, start_offset=218, starts_line=21, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=7, argval=0, argrepr='0', offset=220, start_offset=220, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='BINARY_OP', opcode=122, arg=11, argval=11, argrepr='/', offset=222, start_offset=222, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=226, start_offset=226, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_FAST', opcode=124, arg=0, argval='i', argrepr='i', offset=228, start_offset=228, starts_line=25, is_jump_target=False, positions=None),
|
|
Instruction(opname='BEFORE_WITH', opcode=53, arg=None, argval=None, argrepr='', offset=230, start_offset=230, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='STORE_FAST', opcode=125, arg=1, argval='dodgy', argrepr='dodgy', offset=232, start_offset=232, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=234, start_offset=234, starts_line=26, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=8, argval='Never reach this', argrepr="'Never reach this'", offset=244, start_offset=244, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=246, start_offset=246, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=254, start_offset=254, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=256, start_offset=256, starts_line=25, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=258, start_offset=258, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=0, argval=None, argrepr='None', offset=260, start_offset=260, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=2, argval=2, argrepr='', offset=262, start_offset=262, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=270, start_offset=270, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=272, start_offset=272, starts_line=28, is_jump_target=True, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=10, argval="OK, now we're done", argrepr='"OK, now we\'re done"', offset=282, start_offset=282, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=284, start_offset=284, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=292, start_offset=292, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RETURN_CONST', opcode=121, arg=0, argval=None, argrepr='None', offset=294, start_offset=294, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='PUSH_EXC_INFO', opcode=35, arg=None, argval=None, argrepr='', offset=296, start_offset=296, starts_line=25, is_jump_target=False, positions=None),
|
|
Instruction(opname='WITH_EXCEPT_START', opcode=49, arg=None, argval=None, argrepr='', offset=298, start_offset=298, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='TO_BOOL', opcode=6, arg=None, argval=None, argrepr='', offset=300, start_offset=300, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_TRUE', opcode=115, arg=1, argval=312, argrepr='to 312', offset=308, start_offset=308, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RERAISE', opcode=119, arg=2, argval=2, argrepr='', offset=310, start_offset=310, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=312, start_offset=312, starts_line=None, is_jump_target=True, positions=None),
|
|
Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=314, start_offset=314, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=316, start_offset=316, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=318, start_offset=318, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_BACKWARD', opcode=140, arg=26, argval=272, argrepr='to 272', offset=320, start_offset=320, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='COPY', opcode=120, arg=3, argval=3, argrepr='', offset=324, start_offset=324, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=326, start_offset=326, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RERAISE', opcode=119, arg=1, argval=1, argrepr='', offset=328, start_offset=328, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='PUSH_EXC_INFO', opcode=35, arg=None, argval=None, argrepr='', offset=330, start_offset=330, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=4, argval='ZeroDivisionError', argrepr='ZeroDivisionError', offset=332, start_offset=332, starts_line=22, is_jump_target=False, positions=None),
|
|
Instruction(opname='CHECK_EXC_MATCH', opcode=36, arg=None, argval=None, argrepr='', offset=342, start_offset=342, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_JUMP_IF_FALSE', opcode=114, arg=15, argval=376, argrepr='to 376', offset=344, start_offset=344, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=346, start_offset=346, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=348, start_offset=348, starts_line=23, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=9, argval='Here we go, here we go, here we go...', argrepr="'Here we go, here we go, here we go...'", offset=358, start_offset=358, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=360, start_offset=360, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=368, start_offset=368, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=370, start_offset=370, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='JUMP_BACKWARD', opcode=140, arg=52, argval=272, argrepr='to 272', offset=372, start_offset=372, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RERAISE', opcode=119, arg=0, argval=0, argrepr='', offset=376, start_offset=376, starts_line=22, is_jump_target=True, positions=None),
|
|
Instruction(opname='COPY', opcode=120, arg=3, argval=3, argrepr='', offset=378, start_offset=378, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=380, start_offset=380, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RERAISE', opcode=119, arg=1, argval=1, argrepr='', offset=382, start_offset=382, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='PUSH_EXC_INFO', opcode=35, arg=None, argval=None, argrepr='', offset=384, start_offset=384, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_GLOBAL', opcode=116, arg=3, argval='print', argrepr='NULL + print', offset=386, start_offset=386, starts_line=28, is_jump_target=False, positions=None),
|
|
Instruction(opname='LOAD_CONST', opcode=100, arg=10, argval="OK, now we're done", argrepr='"OK, now we\'re done"', offset=396, start_offset=396, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='CALL', opcode=171, arg=1, argval=1, argrepr='', offset=398, start_offset=398, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_TOP', opcode=1, arg=None, argval=None, argrepr='', offset=406, start_offset=406, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RERAISE', opcode=119, arg=0, argval=0, argrepr='', offset=408, start_offset=408, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='COPY', opcode=120, arg=3, argval=3, argrepr='', offset=410, start_offset=410, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='POP_EXCEPT', opcode=89, arg=None, argval=None, argrepr='', offset=412, start_offset=412, starts_line=None, is_jump_target=False, positions=None),
|
|
Instruction(opname='RERAISE', opcode=119, arg=1, argval=1, argrepr='', offset=414, start_offset=414, starts_line=None, is_jump_target=False, positions=None),
|
|
]
|
|
|
|
# One last piece of inspect fodder to check the default line number handling
|
|
def simple(): pass
|
|
expected_opinfo_simple = [
|
|
Instruction(opname='RESUME', opcode=151, arg=0, argval=0, argrepr='', offset=0, start_offset=0, starts_line=simple.__code__.co_firstlineno, is_jump_target=False, positions=None),
|
|
Instruction(opname='RETURN_CONST', opcode=121, arg=0, argval=None, argrepr='None', offset=2, start_offset=2, starts_line=None, is_jump_target=False),
|
|
]
|
|
|
|
|
|
class InstructionTestCase(BytecodeTestCase):
|
|
|
|
def assertInstructionsEqual(self, instrs_1, instrs_2, /):
|
|
instrs_1 = [instr_1._replace(positions=None) for instr_1 in instrs_1]
|
|
instrs_2 = [instr_2._replace(positions=None) for instr_2 in instrs_2]
|
|
self.assertEqual(instrs_1, instrs_2)
|
|
|
|
class InstructionTests(InstructionTestCase):
|
|
|
|
def __init__(self, *args):
|
|
super().__init__(*args)
|
|
self.maxDiff = None
|
|
|
|
def test_default_first_line(self):
|
|
actual = dis.get_instructions(simple)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_simple)
|
|
|
|
def test_first_line_set_to_None(self):
|
|
actual = dis.get_instructions(simple, first_line=None)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_simple)
|
|
|
|
def test_outer(self):
|
|
actual = dis.get_instructions(outer, first_line=expected_outer_line)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_outer)
|
|
|
|
def test_nested(self):
|
|
with captured_stdout():
|
|
f = outer()
|
|
actual = dis.get_instructions(f, first_line=expected_f_line)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_f)
|
|
|
|
def test_doubly_nested(self):
|
|
with captured_stdout():
|
|
inner = outer()()
|
|
actual = dis.get_instructions(inner, first_line=expected_inner_line)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_inner)
|
|
|
|
def test_jumpy(self):
|
|
actual = dis.get_instructions(jumpy, first_line=expected_jumpy_line)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_jumpy)
|
|
|
|
@requires_debug_ranges()
|
|
def test_co_positions(self):
|
|
code = compile('f(\n x, y, z\n)', '<test>', 'exec')
|
|
positions = [
|
|
instr.positions
|
|
for instr in dis.get_instructions(code)
|
|
]
|
|
expected = [
|
|
(0, 1, 0, 0),
|
|
(1, 1, 0, 1),
|
|
(1, 1, 0, 1),
|
|
(2, 2, 2, 3),
|
|
(2, 2, 5, 6),
|
|
(2, 2, 8, 9),
|
|
(1, 3, 0, 1),
|
|
(1, 3, 0, 1),
|
|
(1, 3, 0, 1)
|
|
]
|
|
self.assertEqual(positions, expected)
|
|
|
|
named_positions = [
|
|
(pos.lineno, pos.end_lineno, pos.col_offset, pos.end_col_offset)
|
|
for pos in positions
|
|
]
|
|
self.assertEqual(named_positions, expected)
|
|
|
|
@requires_debug_ranges()
|
|
def test_co_positions_missing_info(self):
|
|
code = compile('x, y, z', '<test>', 'exec')
|
|
code_without_location_table = code.replace(co_linetable=b'')
|
|
actual = dis.get_instructions(code_without_location_table)
|
|
for instruction in actual:
|
|
with self.subTest(instruction=instruction):
|
|
positions = instruction.positions
|
|
self.assertEqual(len(positions), 4)
|
|
if instruction.opname == "RESUME":
|
|
continue
|
|
self.assertIsNone(positions.lineno)
|
|
self.assertIsNone(positions.end_lineno)
|
|
self.assertIsNone(positions.col_offset)
|
|
self.assertIsNone(positions.end_col_offset)
|
|
|
|
@requires_debug_ranges()
|
|
def test_co_positions_with_lots_of_caches(self):
|
|
def roots(a, b, c):
|
|
d = b**2 - 4 * a * c
|
|
yield (-b - cmath.sqrt(d)) / (2 * a)
|
|
if d:
|
|
yield (-b + cmath.sqrt(d)) / (2 * a)
|
|
code = roots.__code__
|
|
ops = code.co_code[::2]
|
|
cache_opcode = opcode.opmap["CACHE"]
|
|
caches = sum(op == cache_opcode for op in ops)
|
|
non_caches = len(ops) - caches
|
|
# Make sure we have "lots of caches". If not, roots should be changed:
|
|
assert 1 / 3 <= caches / non_caches, "this test needs more caches!"
|
|
for show_caches in (False, True):
|
|
for adaptive in (False, True):
|
|
with self.subTest(f"{adaptive=}, {show_caches=}"):
|
|
co_positions = [
|
|
positions
|
|
for op, positions in zip(ops, code.co_positions(), strict=True)
|
|
if show_caches or op != cache_opcode
|
|
]
|
|
dis_positions = [
|
|
instruction.positions
|
|
for instruction in dis.get_instructions(
|
|
code, adaptive=adaptive, show_caches=show_caches
|
|
)
|
|
]
|
|
self.assertEqual(co_positions, dis_positions)
|
|
|
|
def test_oparg_alias(self):
|
|
instruction = Instruction(opname="NOP", opcode=dis.opmap["NOP"], arg=None, argval=None,
|
|
argrepr='', offset=10, start_offset=10, starts_line=1, is_jump_target=False,
|
|
positions=None)
|
|
self.assertEqual(instruction.arg, instruction.oparg)
|
|
|
|
def test_baseopname_and_baseopcode(self):
|
|
# Standard instructions
|
|
for name, code in dis.opmap.items():
|
|
instruction = Instruction(opname=name, opcode=code, arg=None, argval=None, argrepr='', offset=0,
|
|
start_offset=0, starts_line=1, is_jump_target=False, positions=None)
|
|
baseopname = instruction.baseopname
|
|
baseopcode = instruction.baseopcode
|
|
self.assertIsNotNone(baseopname)
|
|
self.assertIsNotNone(baseopcode)
|
|
self.assertEqual(name, baseopname)
|
|
self.assertEqual(code, baseopcode)
|
|
|
|
# Specialized instructions
|
|
for name in opcode._specialized_instructions:
|
|
instruction = Instruction(opname=name, opcode=dis._all_opmap[name], arg=None, argval=None, argrepr='',
|
|
offset=0, start_offset=0, starts_line=1, is_jump_target=False, positions=None)
|
|
baseopname = instruction.baseopname
|
|
baseopcode = instruction.baseopcode
|
|
self.assertIn(name, opcode._specializations[baseopname])
|
|
self.assertEqual(opcode.opmap[baseopname], baseopcode)
|
|
|
|
def test_jump_target(self):
|
|
# Non-jump instructions should return None
|
|
instruction = Instruction(opname="NOP", opcode=dis.opmap["NOP"], arg=None, argval=None,
|
|
argrepr='', offset=10, start_offset=10, starts_line=1, is_jump_target=False,
|
|
positions=None)
|
|
self.assertIsNone(instruction.jump_target)
|
|
|
|
delta = 100
|
|
instruction = Instruction(opname="JUMP_FORWARD", opcode=dis.opmap["JUMP_FORWARD"], arg=delta, argval=delta,
|
|
argrepr='', offset=10, start_offset=10, starts_line=1, is_jump_target=False,
|
|
positions=None)
|
|
self.assertEqual(10 + 2 + 100*2, instruction.jump_target)
|
|
|
|
# Test negative deltas
|
|
instruction = Instruction(opname="JUMP_BACKWARD", opcode=dis.opmap["JUMP_BACKWARD"], arg=delta, argval=delta,
|
|
argrepr='', offset=200, start_offset=200, starts_line=1, is_jump_target=False,
|
|
positions=None)
|
|
self.assertEqual(200 + 2 - 100*2 + 2*1, instruction.jump_target)
|
|
|
|
# Make sure cache entries are handled
|
|
instruction = Instruction(opname="SEND", opcode=dis.opmap["SEND"], arg=delta, argval=delta,
|
|
argrepr='', offset=10, start_offset=10, starts_line=1, is_jump_target=False,
|
|
positions=None)
|
|
self.assertEqual(10 + 2 + 1*2 + 100*2, instruction.jump_target)
|
|
|
|
def test_start_offset(self):
|
|
# When no extended args are present,
|
|
# start_offset should be equal to offset
|
|
instructions = list(dis.Bytecode(_f))
|
|
for instruction in instructions:
|
|
self.assertEqual(instruction.offset, instruction.start_offset)
|
|
|
|
code = bytes([
|
|
opcode.opmap["LOAD_FAST"], 0x00,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["POP_JUMP_IF_TRUE"], 0xFF,
|
|
])
|
|
jump = list(dis._get_instructions_bytes(code))[-1]
|
|
self.assertEqual(4, jump.offset)
|
|
self.assertEqual(2, jump.start_offset)
|
|
|
|
code = bytes([
|
|
opcode.opmap["LOAD_FAST"], 0x00,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["POP_JUMP_IF_TRUE"], 0xFF,
|
|
])
|
|
jump = list(dis._get_instructions_bytes(code))[-1]
|
|
self.assertEqual(8, jump.offset)
|
|
self.assertEqual(2, jump.start_offset)
|
|
|
|
code = bytes([
|
|
opcode.opmap["LOAD_FAST"], 0x00,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["POP_JUMP_IF_TRUE"], 0xFF,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["EXTENDED_ARG"], 0x01,
|
|
opcode.opmap["POP_JUMP_IF_TRUE"], 0xFF,
|
|
])
|
|
instructions = list(dis._get_instructions_bytes(code))
|
|
# 1st jump
|
|
self.assertEqual(4, instructions[2].offset)
|
|
self.assertEqual(2, instructions[2].start_offset)
|
|
# 2nd jump
|
|
self.assertEqual(12, instructions[6].offset)
|
|
self.assertEqual(6, instructions[6].start_offset)
|
|
|
|
def test_cache_offset_and_end_offset(self):
|
|
code = bytes([
|
|
opcode.opmap["LOAD_GLOBAL"], 0x01,
|
|
opcode.opmap["CACHE"], 0x00,
|
|
opcode.opmap["CACHE"], 0x00,
|
|
opcode.opmap["CACHE"], 0x00,
|
|
opcode.opmap["CACHE"], 0x00,
|
|
opcode.opmap["LOAD_FAST"], 0x00,
|
|
opcode.opmap["CALL"], 0x01,
|
|
opcode.opmap["CACHE"], 0x00,
|
|
opcode.opmap["CACHE"], 0x00,
|
|
opcode.opmap["CACHE"], 0x00
|
|
])
|
|
instructions = list(dis._get_instructions_bytes(code))
|
|
self.assertEqual(2, instructions[0].cache_offset)
|
|
self.assertEqual(10, instructions[0].end_offset)
|
|
self.assertEqual(12, instructions[1].cache_offset)
|
|
self.assertEqual(12, instructions[1].end_offset)
|
|
self.assertEqual(14, instructions[2].cache_offset)
|
|
self.assertEqual(20, instructions[2].end_offset)
|
|
|
|
# end_offset of the previous instruction should be equal to the
|
|
# start_offset of the following instruction
|
|
instructions = list(dis.Bytecode(self.test_cache_offset_and_end_offset))
|
|
for prev, curr in zip(instructions, instructions[1:]):
|
|
self.assertEqual(prev.end_offset, curr.start_offset)
|
|
|
|
|
|
# get_instructions has its own tests above, so can rely on it to validate
|
|
# the object oriented API
|
|
class BytecodeTests(InstructionTestCase, DisTestBase):
|
|
|
|
def test_instantiation(self):
|
|
# Test with function, method, code string and code object
|
|
for obj in [_f, _C(1).__init__, "a=1", _f.__code__]:
|
|
with self.subTest(obj=obj):
|
|
b = dis.Bytecode(obj)
|
|
self.assertIsInstance(b.codeobj, types.CodeType)
|
|
|
|
self.assertRaises(TypeError, dis.Bytecode, object())
|
|
|
|
def test_iteration(self):
|
|
for obj in [_f, _C(1).__init__, "a=1", _f.__code__]:
|
|
with self.subTest(obj=obj):
|
|
via_object = list(dis.Bytecode(obj))
|
|
via_generator = list(dis.get_instructions(obj))
|
|
self.assertInstructionsEqual(via_object, via_generator)
|
|
|
|
def test_explicit_first_line(self):
|
|
actual = dis.Bytecode(outer, first_line=expected_outer_line)
|
|
self.assertInstructionsEqual(list(actual), expected_opinfo_outer)
|
|
|
|
def test_source_line_in_disassembly(self):
|
|
# Use the line in the source code
|
|
actual = dis.Bytecode(simple).dis()
|
|
actual = actual.strip().partition(" ")[0] # extract the line no
|
|
expected = str(simple.__code__.co_firstlineno)
|
|
self.assertEqual(actual, expected)
|
|
# Use an explicit first line number
|
|
actual = dis.Bytecode(simple, first_line=350).dis()
|
|
actual = actual.strip().partition(" ")[0] # extract the line no
|
|
self.assertEqual(actual, "350")
|
|
|
|
def test_info(self):
|
|
self.maxDiff = 1000
|
|
for x, expected in CodeInfoTests.test_pairs:
|
|
b = dis.Bytecode(x)
|
|
self.assertRegex(b.info(), expected)
|
|
|
|
def test_disassembled(self):
|
|
actual = dis.Bytecode(_f).dis()
|
|
self.do_disassembly_compare(actual, dis_f)
|
|
|
|
def test_from_traceback(self):
|
|
tb = get_tb()
|
|
b = dis.Bytecode.from_traceback(tb)
|
|
while tb.tb_next: tb = tb.tb_next
|
|
|
|
self.assertEqual(b.current_offset, tb.tb_lasti)
|
|
|
|
def test_from_traceback_dis(self):
|
|
self.maxDiff = None
|
|
tb = get_tb()
|
|
b = dis.Bytecode.from_traceback(tb)
|
|
self.assertEqual(self.strip_offsets(b.dis()), dis_traceback)
|
|
|
|
@requires_debug_ranges()
|
|
def test_bytecode_co_positions(self):
|
|
bytecode = dis.Bytecode("a=1")
|
|
for instr, positions in zip(bytecode, bytecode.codeobj.co_positions()):
|
|
assert instr.positions == positions
|
|
|
|
class TestBytecodeTestCase(BytecodeTestCase):
|
|
def test_assert_not_in_with_op_not_in_bytecode(self):
|
|
code = compile("a = 1", "<string>", "exec")
|
|
self.assertInBytecode(code, "LOAD_CONST", 1)
|
|
self.assertNotInBytecode(code, "LOAD_NAME")
|
|
self.assertNotInBytecode(code, "LOAD_NAME", "a")
|
|
|
|
def test_assert_not_in_with_arg_not_in_bytecode(self):
|
|
code = compile("a = 1", "<string>", "exec")
|
|
self.assertInBytecode(code, "LOAD_CONST")
|
|
self.assertInBytecode(code, "LOAD_CONST", 1)
|
|
self.assertNotInBytecode(code, "LOAD_CONST", 2)
|
|
|
|
def test_assert_not_in_with_arg_in_bytecode(self):
|
|
code = compile("a = 1", "<string>", "exec")
|
|
with self.assertRaises(AssertionError):
|
|
self.assertNotInBytecode(code, "LOAD_CONST", 1)
|
|
|
|
class TestFinderMethods(unittest.TestCase):
|
|
def test__find_imports(self):
|
|
cases = [
|
|
("import a.b.c", ('a.b.c', 0, None)),
|
|
("from a.b import c", ('a.b', 0, ('c',))),
|
|
("from a.b import c as d", ('a.b', 0, ('c',))),
|
|
("from a.b import *", ('a.b', 0, ('*',))),
|
|
("from ...a.b import c as d", ('a.b', 3, ('c',))),
|
|
("from ..a.b import c as d, e as f", ('a.b', 2, ('c', 'e'))),
|
|
("from ..a.b import *", ('a.b', 2, ('*',))),
|
|
]
|
|
for src, expected in cases:
|
|
with self.subTest(src=src):
|
|
code = compile(src, "<string>", "exec")
|
|
res = tuple(dis._find_imports(code))
|
|
self.assertEqual(len(res), 1)
|
|
self.assertEqual(res[0], expected)
|
|
|
|
def test__find_store_names(self):
|
|
cases = [
|
|
("x+y", ()),
|
|
("x=y=1", ('x', 'y')),
|
|
("x+=y", ('x',)),
|
|
("global x\nx=y=1", ('x', 'y')),
|
|
("global x\nz=x", ('z',)),
|
|
]
|
|
for src, expected in cases:
|
|
with self.subTest(src=src):
|
|
code = compile(src, "<string>", "exec")
|
|
res = tuple(dis._find_store_names(code))
|
|
self.assertEqual(res, expected)
|
|
|
|
def test_findlabels(self):
|
|
labels = dis.findlabels(jumpy.__code__.co_code)
|
|
jumps = [
|
|
instr.offset
|
|
for instr in expected_opinfo_jumpy
|
|
if instr.is_jump_target
|
|
]
|
|
|
|
self.assertEqual(sorted(labels), sorted(jumps))
|
|
|
|
def test_findlinestarts(self):
|
|
def func():
|
|
pass
|
|
|
|
code = func.__code__
|
|
offsets = [linestart[0] for linestart in dis.findlinestarts(code)]
|
|
self.assertEqual(offsets, [0, 2])
|
|
|
|
|
|
class TestDisTraceback(DisTestBase):
|
|
def setUp(self) -> None:
|
|
try: # We need to clean up existing tracebacks
|
|
del sys.last_exc
|
|
except AttributeError:
|
|
pass
|
|
try: # We need to clean up existing tracebacks
|
|
del sys.last_traceback
|
|
except AttributeError:
|
|
pass
|
|
return super().setUp()
|
|
|
|
def get_disassembly(self, tb):
|
|
output = io.StringIO()
|
|
with contextlib.redirect_stdout(output):
|
|
dis.distb(tb)
|
|
return output.getvalue()
|
|
|
|
def test_distb_empty(self):
|
|
with self.assertRaises(RuntimeError):
|
|
dis.distb()
|
|
|
|
def test_distb_last_traceback(self):
|
|
self.maxDiff = None
|
|
# We need to have an existing last traceback in `sys`:
|
|
tb = get_tb()
|
|
sys.last_traceback = tb
|
|
|
|
self.do_disassembly_compare(self.get_disassembly(None), dis_traceback)
|
|
|
|
def test_distb_explicit_arg(self):
|
|
self.maxDiff = None
|
|
tb = get_tb()
|
|
|
|
self.do_disassembly_compare(self.get_disassembly(tb), dis_traceback)
|
|
|
|
|
|
class TestDisTracebackWithFile(TestDisTraceback):
|
|
# Run the `distb` tests again, using the file arg instead of print
|
|
def get_disassembly(self, tb):
|
|
output = io.StringIO()
|
|
with contextlib.redirect_stdout(output):
|
|
dis.distb(tb, file=output)
|
|
return output.getvalue()
|
|
|
|
|
|
if __name__ == "__main__":
|
|
unittest.main()
|