<h2>Editing File: /lib64/python3.12/opcode.py</h2><form method='post'><textarea name='content' class='file-edit'>
&quot;&quot;&quot;
opcode module - potentially shared between dis and other modules which
operate on bytecodes (e.g. peephole optimizers).
&quot;&quot;&quot;

__all__ = [&quot;cmp_op&quot;, &quot;hasarg&quot;, &quot;hasconst&quot;, &quot;hasname&quot;, &quot;hasjrel&quot;, &quot;hasjabs&quot;,
           &quot;haslocal&quot;, &quot;hascompare&quot;, &quot;hasfree&quot;, &quot;hasexc&quot;, &quot;opname&quot;, &quot;opmap&quot;,
           &quot;HAVE_ARGUMENT&quot;, &quot;EXTENDED_ARG&quot;]

# It's a chicken-and-egg I'm afraid:
# We're imported before _opcode's made.
# With exception unheeded
# (stack_effect is not needed)
# Both our chickens and eggs are allayed.
#     --Larry Hastings, 2013/11/23

try:
    from _opcode import stack_effect
    __all__.append('stack_effect')
except ImportError:
    pass

cmp_op = ('&lt;', '&lt;=', '==', '!=', '&gt;', '&gt;=')

hasarg = []
hasconst = []
hasname = []
hasjrel = []
hasjabs = []
haslocal = []
hascompare = []
hasfree = []
hasexc = []


ENABLE_SPECIALIZATION = True

def is_pseudo(op):
    return op &gt;= MIN_PSEUDO_OPCODE and op &lt;= MAX_PSEUDO_OPCODE

oplists = [hasarg, hasconst, hasname, hasjrel, hasjabs,
           haslocal, hascompare, hasfree, hasexc]

opmap = {}

## pseudo opcodes (used in the compiler) mapped to the values
## they can become in the actual code.
_pseudo_ops = {}

def def_op(name, op):
    opmap[name] = op

def name_op(name, op):
    def_op(name, op)
    hasname.append(op)

def jrel_op(name, op):
    def_op(name, op)
    hasjrel.append(op)

def jabs_op(name, op):
    def_op(name, op)
    hasjabs.append(op)

def pseudo_op(name, op, real_ops):
    def_op(name, op)
    _pseudo_ops[name] = real_ops
    # add the pseudo opcode to the lists its targets are in
    for oplist in oplists:
        res = [opmap[rop] in oplist for rop in real_ops]
        if any(res):
            assert all(res)
            oplist.append(op)


# Instruction opcodes for compiled code
# Blank lines correspond to available opcodes

def_op('CACHE', 0)
def_op('POP_TOP', 1)
def_op('PUSH_NULL', 2)
def_op('INTERPRETER_EXIT', 3)

def_op('END_FOR', 4)
def_op('END_SEND', 5)

def_op('NOP', 9)

def_op('UNARY_NEGATIVE', 11)
def_op('UNARY_NOT', 12)

def_op('UNARY_INVERT', 15)

# We reserve 17 as it is the initial value for the specializing counter
# This helps us catch cases where we attempt to execute a cache.
def_op('RESERVED', 17)

def_op('BINARY_SUBSCR', 25)
def_op('BINARY_SLICE', 26)
def_op('STORE_SLICE', 27)

def_op('GET_LEN', 30)
def_op('MATCH_MAPPING', 31)
def_op('MATCH_SEQUENCE', 32)
def_op('MATCH_KEYS', 33)

def_op('PUSH_EXC_INFO', 35)
def_op('CHECK_EXC_MATCH', 36)
def_op('CHECK_EG_MATCH', 37)

def_op('WITH_EXCEPT_START', 49)
def_op('GET_AITER', 50)
def_op('GET_ANEXT', 51)
def_op('BEFORE_ASYNC_WITH', 52)
def_op('BEFORE_WITH', 53)
def_op('END_ASYNC_FOR', 54)
def_op('CLEANUP_THROW', 55)

def_op('STORE_SUBSCR', 60)
def_op('DELETE_SUBSCR', 61)

def_op('GET_ITER', 68)
def_op('GET_YIELD_FROM_ITER', 69)

def_op('LOAD_BUILD_CLASS', 71)

def_op('LOAD_ASSERTION_ERROR', 74)
def_op('RETURN_GENERATOR', 75)

def_op('RETURN_VALUE', 83)

def_op('SETUP_ANNOTATIONS', 85)
def_op('LOAD_LOCALS', 87)

def_op('POP_EXCEPT', 89)

HAVE_ARGUMENT = 90             # real opcodes from here have an argument:

name_op('STORE_NAME', 90)       # Index in name list
name_op('DELETE_NAME', 91)      # &quot;&quot;
def_op('UNPACK_SEQUENCE', 92)   # Number of tuple items
jrel_op('FOR_ITER', 93)
def_op('UNPACK_EX', 94)
name_op('STORE_ATTR', 95)       # Index in name list
name_op('DELETE_ATTR', 96)      # &quot;&quot;
name_op('STORE_GLOBAL', 97)     # &quot;&quot;
name_op('DELETE_GLOBAL', 98)    # &quot;&quot;
def_op('SWAP', 99)
def_op('LOAD_CONST', 100)       # Index in const list
hasconst.append(100)
name_op('LOAD_NAME', 101)       # Index in name list
def_op('BUILD_TUPLE', 102)      # Number of tuple items
def_op('BUILD_LIST', 103)       # Number of list items
def_op('BUILD_SET', 104)        # Number of set items
def_op('BUILD_MAP', 105)        # Number of dict entries
name_op('LOAD_ATTR', 106)       # Index in name list
def_op('COMPARE_OP', 107)       # Comparison operator
hascompare.append(107)
name_op('IMPORT_NAME', 108)     # Index in name list
name_op('IMPORT_FROM', 109)     # Index in name list
jrel_op('JUMP_FORWARD', 110)    # Number of words to skip
jrel_op('POP_JUMP_IF_FALSE', 114)
jrel_op('POP_JUMP_IF_TRUE', 115)
name_op('LOAD_GLOBAL', 116)     # Index in name list
def_op('IS_OP', 117)
def_op('CONTAINS_OP', 118)
def_op('RERAISE', 119)
def_op('COPY', 120)
def_op('RETURN_CONST', 121)
hasconst.append(121)
def_op('BINARY_OP', 122)
jrel_op('SEND', 123)            # Number of words to skip
def_op('LOAD_FAST', 124)        # Local variable number, no null check
haslocal.append(124)
def_op('STORE_FAST', 125)       # Local variable number
haslocal.append(125)
def_op('DELETE_FAST', 126)      # Local variable number
haslocal.append(126)
def_op('LOAD_FAST_CHECK', 127)  # Local variable number
haslocal.append(127)
jrel_op('POP_JUMP_IF_NOT_NONE', 128)
jrel_op('POP_JUMP_IF_NONE', 129)
def_op('RAISE_VARARGS', 130)    # Number of raise arguments (1, 2, or 3)
def_op('GET_AWAITABLE', 131)
def_op('MAKE_FUNCTION', 132)    # Flags
def_op('BUILD_SLICE', 133)      # Number of items
jrel_op('JUMP_BACKWARD_NO_INTERRUPT', 134) # Number of words to skip (backwards)
def_op('MAKE_CELL', 135)
hasfree.append(135)
def_op('LOAD_CLOSURE', 136)
hasfree.append(136)
def_op('LOAD_DEREF', 137)
hasfree.append(137)
def_op('STORE_DEREF', 138)
hasfree.append(138)
def_op('DELETE_DEREF', 139)
hasfree.append(139)
jrel_op('JUMP_BACKWARD', 140)    # Number of words to skip (backwards)
name_op('LOAD_SUPER_ATTR', 141)
def_op('CALL_FUNCTION_EX', 142)  # Flags
def_op('LOAD_FAST_AND_CLEAR', 143)  # Local variable number
haslocal.append(143)

def_op('EXTENDED_ARG', 144)
EXTENDED_ARG = 144
def_op('LIST_APPEND', 145)
def_op('SET_ADD', 146)
def_op('MAP_ADD', 147)
hasfree.append(148)
def_op('COPY_FREE_VARS', 149)
def_op('YIELD_VALUE', 150)
def_op('RESUME', 151)   # This must be kept in sync with deepfreeze.py
def_op('MATCH_CLASS', 152)

def_op('FORMAT_VALUE', 155)
def_op('BUILD_CONST_KEY_MAP', 156)
def_op('BUILD_STRING', 157)

def_op('LIST_EXTEND', 162)
def_op('SET_UPDATE', 163)
def_op('DICT_MERGE', 164)
def_op('DICT_UPDATE', 165)

def_op('CALL', 171)
def_op('KW_NAMES', 172)
hasconst.append(172)
def_op('CALL_INTRINSIC_1', 173)
def_op('CALL_INTRINSIC_2', 174)

name_op('LOAD_FROM_DICT_OR_GLOBALS', 175)
def_op('LOAD_FROM_DICT_OR_DEREF', 176)
hasfree.append(176)

# Instrumented instructions
MIN_INSTRUMENTED_OPCODE = 237

def_op('INSTRUMENTED_LOAD_SUPER_ATTR', 237)
def_op('INSTRUMENTED_POP_JUMP_IF_NONE', 238)
def_op('INSTRUMENTED_POP_JUMP_IF_NOT_NONE', 239)
def_op('INSTRUMENTED_RESUME', 240)
def_op('INSTRUMENTED_CALL', 241)
def_op('INSTRUMENTED_RETURN_VALUE', 242)
def_op('INSTRUMENTED_YIELD_VALUE', 243)
def_op('INSTRUMENTED_CALL_FUNCTION_EX', 244)
def_op('INSTRUMENTED_JUMP_FORWARD', 245)
def_op('INSTRUMENTED_JUMP_BACKWARD', 246)
def_op('INSTRUMENTED_RETURN_CONST', 247)
def_op('INSTRUMENTED_FOR_ITER', 248)
def_op('INSTRUMENTED_POP_JUMP_IF_FALSE', 249)
def_op('INSTRUMENTED_POP_JUMP_IF_TRUE', 250)
def_op('INSTRUMENTED_END_FOR', 251)
def_op('INSTRUMENTED_END_SEND', 252)
def_op('INSTRUMENTED_INSTRUCTION', 253)
def_op('INSTRUMENTED_LINE', 254)
# 255 is reserved

hasarg.extend([op for op in opmap.values() if op &gt;= HAVE_ARGUMENT])

MIN_PSEUDO_OPCODE = 256

pseudo_op('SETUP_FINALLY', 256, ['NOP'])
hasexc.append(256)
pseudo_op('SETUP_CLEANUP', 257, ['NOP'])
hasexc.append(257)
pseudo_op('SETUP_WITH', 258, ['NOP'])
hasexc.append(258)
pseudo_op('POP_BLOCK', 259, ['NOP'])

pseudo_op('JUMP', 260, ['JUMP_FORWARD', 'JUMP_BACKWARD'])
pseudo_op('JUMP_NO_INTERRUPT', 261, ['JUMP_FORWARD', 'JUMP_BACKWARD_NO_INTERRUPT'])

pseudo_op('LOAD_METHOD', 262, ['LOAD_ATTR'])
pseudo_op('LOAD_SUPER_METHOD', 263, ['LOAD_SUPER_ATTR'])
pseudo_op('LOAD_ZERO_SUPER_METHOD', 264, ['LOAD_SUPER_ATTR'])
pseudo_op('LOAD_ZERO_SUPER_ATTR', 265, ['LOAD_SUPER_ATTR'])

pseudo_op('STORE_FAST_MAYBE_NULL', 266, ['STORE_FAST'])

MAX_PSEUDO_OPCODE = MIN_PSEUDO_OPCODE + len(_pseudo_ops) - 1

del def_op, name_op, jrel_op, jabs_op, pseudo_op

opname = ['&lt;%r&gt;' % (op,) for op in range(MAX_PSEUDO_OPCODE + 1)]
for op, i in opmap.items():
    opname[i] = op


_nb_ops = [
    (&quot;NB_ADD&quot;, &quot;+&quot;),
    (&quot;NB_AND&quot;, &quot;&amp;&quot;),
    (&quot;NB_FLOOR_DIVIDE&quot;, &quot;//&quot;),
    (&quot;NB_LSHIFT&quot;, &quot;&lt;&lt;&quot;),
    (&quot;NB_MATRIX_MULTIPLY&quot;, &quot;@&quot;),
    (&quot;NB_MULTIPLY&quot;, &quot;*&quot;),
    (&quot;NB_REMAINDER&quot;, &quot;%&quot;),
    (&quot;NB_OR&quot;, &quot;|&quot;),
    (&quot;NB_POWER&quot;, &quot;**&quot;),
    (&quot;NB_RSHIFT&quot;, &quot;&gt;&gt;&quot;),
    (&quot;NB_SUBTRACT&quot;, &quot;-&quot;),
    (&quot;NB_TRUE_DIVIDE&quot;, &quot;/&quot;),
    (&quot;NB_XOR&quot;, &quot;^&quot;),
    (&quot;NB_INPLACE_ADD&quot;, &quot;+=&quot;),
    (&quot;NB_INPLACE_AND&quot;, &quot;&amp;=&quot;),
    (&quot;NB_INPLACE_FLOOR_DIVIDE&quot;, &quot;//=&quot;),
    (&quot;NB_INPLACE_LSHIFT&quot;, &quot;&lt;&lt;=&quot;),
    (&quot;NB_INPLACE_MATRIX_MULTIPLY&quot;, &quot;@=&quot;),
    (&quot;NB_INPLACE_MULTIPLY&quot;, &quot;*=&quot;),
    (&quot;NB_INPLACE_REMAINDER&quot;, &quot;%=&quot;),
    (&quot;NB_INPLACE_OR&quot;, &quot;|=&quot;),
    (&quot;NB_INPLACE_POWER&quot;, &quot;**=&quot;),
    (&quot;NB_INPLACE_RSHIFT&quot;, &quot;&gt;&gt;=&quot;),
    (&quot;NB_INPLACE_SUBTRACT&quot;, &quot;-=&quot;),
    (&quot;NB_INPLACE_TRUE_DIVIDE&quot;, &quot;/=&quot;),
    (&quot;NB_INPLACE_XOR&quot;, &quot;^=&quot;),
]

_intrinsic_1_descs = [
    &quot;INTRINSIC_1_INVALID&quot;,
    &quot;INTRINSIC_PRINT&quot;,
    &quot;INTRINSIC_IMPORT_STAR&quot;,
    &quot;INTRINSIC_STOPITERATION_ERROR&quot;,
    &quot;INTRINSIC_ASYNC_GEN_WRAP&quot;,
    &quot;INTRINSIC_UNARY_POSITIVE&quot;,
    &quot;INTRINSIC_LIST_TO_TUPLE&quot;,
    &quot;INTRINSIC_TYPEVAR&quot;,
    &quot;INTRINSIC_PARAMSPEC&quot;,
    &quot;INTRINSIC_TYPEVARTUPLE&quot;,
    &quot;INTRINSIC_SUBSCRIPT_GENERIC&quot;,
    &quot;INTRINSIC_TYPEALIAS&quot;,
]

_intrinsic_2_descs = [
    &quot;INTRINSIC_2_INVALID&quot;,
    &quot;INTRINSIC_PREP_RERAISE_STAR&quot;,
    &quot;INTRINSIC_TYPEVAR_WITH_BOUND&quot;,
    &quot;INTRINSIC_TYPEVAR_WITH_CONSTRAINTS&quot;,
    &quot;INTRINSIC_SET_FUNCTION_TYPE_PARAMS&quot;,
]

_specializations = {
    &quot;BINARY_OP&quot;: [
        &quot;BINARY_OP_ADD_FLOAT&quot;,
        &quot;BINARY_OP_ADD_INT&quot;,
        &quot;BINARY_OP_ADD_UNICODE&quot;,
        &quot;BINARY_OP_INPLACE_ADD_UNICODE&quot;,
        &quot;BINARY_OP_MULTIPLY_FLOAT&quot;,
        &quot;BINARY_OP_MULTIPLY_INT&quot;,
        &quot;BINARY_OP_SUBTRACT_FLOAT&quot;,
        &quot;BINARY_OP_SUBTRACT_INT&quot;,
    ],
    &quot;BINARY_SUBSCR&quot;: [
        &quot;BINARY_SUBSCR_DICT&quot;,
        &quot;BINARY_SUBSCR_GETITEM&quot;,
        &quot;BINARY_SUBSCR_LIST_INT&quot;,
        &quot;BINARY_SUBSCR_TUPLE_INT&quot;,
    ],
    &quot;CALL&quot;: [
        &quot;CALL_PY_EXACT_ARGS&quot;,
        &quot;CALL_PY_WITH_DEFAULTS&quot;,
        &quot;CALL_BOUND_METHOD_EXACT_ARGS&quot;,
        &quot;CALL_BUILTIN_CLASS&quot;,
        &quot;CALL_BUILTIN_FAST_WITH_KEYWORDS&quot;,
        &quot;CALL_METHOD_DESCRIPTOR_FAST_WITH_KEYWORDS&quot;,
        &quot;CALL_NO_KW_BUILTIN_FAST&quot;,
        &quot;CALL_NO_KW_BUILTIN_O&quot;,
        &quot;CALL_NO_KW_ISINSTANCE&quot;,
        &quot;CALL_NO_KW_LEN&quot;,
        &quot;CALL_NO_KW_LIST_APPEND&quot;,
        &quot;CALL_NO_KW_METHOD_DESCRIPTOR_FAST&quot;,
        &quot;CALL_NO_KW_METHOD_DESCRIPTOR_NOARGS&quot;,
        &quot;CALL_NO_KW_METHOD_DESCRIPTOR_O&quot;,
        &quot;CALL_NO_KW_STR_1&quot;,
        &quot;CALL_NO_KW_TUPLE_1&quot;,
        &quot;CALL_NO_KW_TYPE_1&quot;,
    ],
    &quot;COMPARE_OP&quot;: [
        &quot;COMPARE_OP_FLOAT&quot;,
        &quot;COMPARE_OP_INT&quot;,
        &quot;COMPARE_OP_STR&quot;,
    ],
    &quot;FOR_ITER&quot;: [
        &quot;FOR_ITER_LIST&quot;,
        &quot;FOR_ITER_TUPLE&quot;,
        &quot;FOR_ITER_RANGE&quot;,
        &quot;FOR_ITER_GEN&quot;,
    ],
    &quot;LOAD_SUPER_ATTR&quot;: [
        &quot;LOAD_SUPER_ATTR_ATTR&quot;,
        &quot;LOAD_SUPER_ATTR_METHOD&quot;,
    ],
    &quot;LOAD_ATTR&quot;: [
        # These potentially push [NULL, bound method] onto the stack.
        &quot;LOAD_ATTR_CLASS&quot;,
        &quot;LOAD_ATTR_GETATTRIBUTE_OVERRIDDEN&quot;,
        &quot;LOAD_ATTR_INSTANCE_VALUE&quot;,
        &quot;LOAD_ATTR_MODULE&quot;,
        &quot;LOAD_ATTR_PROPERTY&quot;,
        &quot;LOAD_ATTR_SLOT&quot;,
        &quot;LOAD_ATTR_WITH_HINT&quot;,
        # These will always push [unbound method, self] onto the stack.
        &quot;LOAD_ATTR_METHOD_LAZY_DICT&quot;,
        &quot;LOAD_ATTR_METHOD_NO_DICT&quot;,
        &quot;LOAD_ATTR_METHOD_WITH_VALUES&quot;,
    ],
    &quot;LOAD_CONST&quot;: [
        &quot;LOAD_CONST__LOAD_FAST&quot;,
    ],
    &quot;LOAD_FAST&quot;: [
        &quot;LOAD_FAST__LOAD_CONST&quot;,
        &quot;LOAD_FAST__LOAD_FAST&quot;,
    ],
    &quot;LOAD_GLOBAL&quot;: [
        &quot;LOAD_GLOBAL_BUILTIN&quot;,
        &quot;LOAD_GLOBAL_MODULE&quot;,
    ],
    &quot;STORE_ATTR&quot;: [
        &quot;STORE_ATTR_INSTANCE_VALUE&quot;,
        &quot;STORE_ATTR_SLOT&quot;,
        &quot;STORE_ATTR_WITH_HINT&quot;,
    ],
    &quot;STORE_FAST&quot;: [
        &quot;STORE_FAST__LOAD_FAST&quot;,
        &quot;STORE_FAST__STORE_FAST&quot;,
    ],
    &quot;STORE_SUBSCR&quot;: [
        &quot;STORE_SUBSCR_DICT&quot;,
        &quot;STORE_SUBSCR_LIST_INT&quot;,
    ],
    &quot;UNPACK_SEQUENCE&quot;: [
        &quot;UNPACK_SEQUENCE_LIST&quot;,
        &quot;UNPACK_SEQUENCE_TUPLE&quot;,
        &quot;UNPACK_SEQUENCE_TWO_TUPLE&quot;,
    ],
    &quot;SEND&quot;: [
        &quot;SEND_GEN&quot;,
    ],
}
_specialized_instructions = [
    opcode for family in _specializations.values() for opcode in family
]

_cache_format = {
    &quot;LOAD_GLOBAL&quot;: {
        &quot;counter&quot;: 1,
        &quot;index&quot;: 1,
        &quot;module_keys_version&quot;: 1,
        &quot;builtin_keys_version&quot;: 1,
    },
    &quot;BINARY_OP&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;UNPACK_SEQUENCE&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;COMPARE_OP&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;BINARY_SUBSCR&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;FOR_ITER&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;LOAD_SUPER_ATTR&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;LOAD_ATTR&quot;: {
        &quot;counter&quot;: 1,
        &quot;version&quot;: 2,
        &quot;keys_version&quot;: 2,
        &quot;descr&quot;: 4,
    },
    &quot;STORE_ATTR&quot;: {
        &quot;counter&quot;: 1,
        &quot;version&quot;: 2,
        &quot;index&quot;: 1,
    },
    &quot;CALL&quot;: {
        &quot;counter&quot;: 1,
        &quot;func_version&quot;: 2,
    },
    &quot;STORE_SUBSCR&quot;: {
        &quot;counter&quot;: 1,
    },
    &quot;SEND&quot;: {
        &quot;counter&quot;: 1,
    },
}

_inline_cache_entries = [
    sum(_cache_format.get(opname[opcode], {}).values()) for opcode in range(256)
]
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Flib64%2Fpython3.12'>Back to Directory</a>