python (3.12.0)
ˑe8v d Z ddlZddlZddlZddlZddl ddlmZmZm Z m
Z
m Z m Z m
Z
mZ g dez Z[ej ej ej" eeefZed Zdedfed fed
ffZed Z d Z ed
Z ed Z ed Z ed Z!ed Z"ed Z#ed Z$ed Z%ed Z&ed Z'ed Z(ed Z) e*e+ Z, e-e Z. e/e, D cg c] \ } }|ja d s| c}} Z1 e2e1e D ] \ Z3Z4e4e,e3< e3e.e4< e
jj D ci c] \ }}|D ] }|| c}}}Z6d Z7deddddd d Z8dedddd d Z9d d!d"d#d$d%d&d'd(d)d*
Z:d+ Z; G d, d- Z< e< Z=d. Z>d/ Z?d0 Z@d1 ZAd2 ZBdd3d4ZC ej d5g d6dgd7z 8 ZE ej d9g d:dg8 ZFd;eFjV _ d<eFj
_ d=eFj _ d>eFj _ d?eFj _ d@eFj _ dAeFj _ dBeFj _ dCeFj _ ej dDdE ZNdFZOdGZP G dH dIeF ZQddddJdKZRdL ZSdM ZTdN ZUdO ZVdP ZWdQ ZX dfdSZYdgdddd dTZZddddd dUZ[ dhdddRdddVdWZ\dX Z]eZZ^dYZ_dZe_d[z
z Z`d\ Zad] Zbd^ Zcd_ Zdd` Ze G da db Zfdc Zgehddk( r eg yyc c}} w c c}}}w )iz0Disassembler of Python byte code into mnemonics. N)*)__all__
_cache_format_inline_cache_entries_nb_ops_intrinsic_1_descs_intrinsic_2_descs_specializations_specialized_instructions) code_infodis disassembledistbdiscofindlinestarts
findlabels show_codeget_instructions InstructionBytecode FORMAT_VALUE)N strreprascii
MAKE_FUNCTION)defaults
kwdefaults annotationsclosure
LOAD_CONST RETURN_CONST LOAD_GLOBAL BINARY_OP
JUMP_BACKWARDFOR_ITERSEND LOAD_ATTRLOAD_SUPER_ATTRCALL_INTRINSIC_1CALL_INTRINSIC_2CACHE<c V t | |d S # t $ r Y nw xY wt | |d S )zAttempts to compile the given source, first as an expression and
then as a statement if the first approach fails.
Utility function to accept strings in functions that otherwise
expect code objects
evalexec)compile SyntaxError)sourcenames 7/BuggyBox/python/3.12.0/bootstrap/lib/python3.12/dis.py _try_compiler6 @ s7
vtV,,
64 ((s Ffiledepth show_cachesadaptivec Z | t ||| yt | d r | j } t | d r
| j } nJt | d r
| j } n1t | d r
| j
} nt | d r | j } t | d rlt | j j }|D ]C \ }}t |t st d |z |
t ||||| t |
E yt | d
rt | |||| yt | t t" f rt% | || yt | t& rt) | |||| yt dt+ | j, z # t $ r}t d ||
Y d}~d}~ww xY w)a0 Disassemble classes, methods, functions, and other compiled objects.
With no argument, disassemble the last traceback.
Compiled objects currently include generator objects, async generator
objects, and coroutine objects, all of which store their code object
in a special attribute.
Nr8 r: r; __func____code__gi_codeag_codecr_code__dict__zDisassembly of %s:r8 r7 zSorry:co_code)r8 r: (don't know how to disassemble %s objects)r hasattrr> r? r@ rA rB sortedrC items
isinstance
_have_codeprintr
TypeError_disassemble_recursivebytes bytearray_disassemble_bytesr _disassemble_strtype__name__) xr8 r9 r: r; rI r4 x1msgs r5 r
r
M s{ y
4[8Dq*
JJq*
JJ I
II I
II I
IIq* qzz'')* !HD""j)*T1=4U V^_ 4 !
I qt5k\de Ay) *14[A As U V^_B Q(() * * ! 4(Cd334s &F F*F%%F*r= c X | a t t d rt j j } nt j } | j r| j } | j rt | j j | j ||| y# t
$ r
t
d dw xY w)z2Disassemble a traceback (default: last traceback).Nlast_excz no last traceback to disassembler= ) rG sysrY
__traceback__last_tracebackAttributeError RuntimeErrortb_nextr tb_framef_codetb_lasti)tbr8 r: r; s r5 r r z s z MsJ'\\//'' jjrzz"bjj ""BKKd ^fg M AB L Ms ;B B) OPTIMIZED NEWLOCALSVARARGS VARKEYWORDSNESTED GENERATORNOFREE COROUTINEITERABLE_COROUTINEASYNC_GENERATOR)
@ i c g }t d D ]D }d|z }| |z s|j t j |t | | |z } | rD n |j t | dj | S )z+Return pretty representation of code flags.rs rn , )rangeappendCOMPILER_FLAG_NAMESgethexjoin)flagsnamesiflags r5 pretty_flagsr sx E
2Y !!t 4< LL,00s4yA B TME
! SZ 99U c e Zd Zd Zy)_Unknownc y)Nz <unknown> selfs r5 __repr__z_Unknown.__repr__ s r N)rT
__module__ __qualname__r r r r5 r r s r r c t | d r | j } t | d r
| j } nJt | d r
| j } n1t | d r
| j } nt | d r | j
} t
| t r t | d } t | d r| S t dt | j z ) zDHelper to handle methods, compiled or raw code objects, and strings.r> r? r@ rA rB z
<disassembly>rE rF ) rG r> r? r@ rA rB rJ r r6 rM rS rT rU s r5 _get_code_objectr s q*
JJq*
JJ I
II I
II I
II!S O ,q)
>G$$% & &r c H t | }|t v rt t | S | S N) _all_opnamedeoptmap
_all_opmap)opr4 s r5 _deoptopr s& r?D)-)9:htn %ArAr c 6 |r | j S | j S r )_co_code_adaptiverE )cor; s r5 _get_code_arrayr s #+2 ;;r c * t t | S )z1Formatted details of methods, functions, or code.)_format_code_infor r s r5 r r s -a 0 11r c g }|j d| j z |j d| j z |j d| j z |j d| j z |j d| j
z |j d| j z |j d| j z |j dt | j z | j r?|j d t | j D ] }|j d
|z | j r?|j d t | j D ] }|j d |z | j r?|j d
t | j D ] }|j d |z | j r?|j d t | j D ] }|j d |z | j r?|j d t | j D ] }|j d |z dj! | S )NzName: %szFilename: %szArgument count: %sz Positional-only arguments: %szKw-only arguments: %szNumber of locals: %szStack size: %szFlags: %sz
Constants:z%4d: %rzNames:z%4d: %szVariable names:zFree variables:zCell variables:
)rz co_name co_filename co_argcountco_posonlyargcountco_kwonlyargcount
co_nlocals co_stacksizer co_flags co_consts enumerateco_names co_varnames co_freevars co_cellvarsr~ )r linesi_ci_ns r5 r r s E LL(2::56 LL(2>>9: LL(2>>9: LL023H3HHI LL(2+?+??@ LL(2==89 LL(2??:; LL(< +DDE ||
\" R\\* *C LLS ) * {{
X R[[) *C LLS ) * ~~
&' R^^, *C LLS ) * ~~
&' R^^, *C LLS ) * ~~
&' R^^, *C LLS ) * 99U r rD c 0 t t | | y)z}Print details of methods, functions, or code to *file*.
If *file* is not provided, the output is printed on stdout.
rD N)rL r )r r8 s r5 r r s
)B-d#r Positions)lineno
end_lineno
col_offsetend_col_offsetrp )r _Instruction) opnameopcodeargargvalargreproffset starts_lineis_jump_target positionsz!Human readable name for operationzNumeric code for operationz6Numeric argument to operation (if any), otherwise Nonez4Resolved arg value (if known), otherwise same as argz0Human readable description of operation argumentz1Start index of operation within bytecode sequencez4Line started by this opcode (if any), otherwise Nonez1True if other code jumps to here, otherwise FalsezPdis.Positions object holding the span of source code covered by this instruction_ExceptionTableEntryz start end target depth lasti c e Zd ZdZddZy)r a Details for a bytecode operation
Defined fields:
opname - human readable name for operation
opcode - numeric code for operation
arg - numeric argument to operation (if any), otherwise None
argval - resolved arg value (if known), otherwise same as arg
argrepr - human readable description of operation argument
offset - start index of operation within bytecode sequence
starts_line - line started by this opcode (if any), otherwise None
is_jump_target - True if other code jumps to here, otherwise False
positions - Optional dis.Positions object holding the span of source code
covered by this instruction
c g }|rD| j $d|z }|j || j z n|j d|z |r|j d n|j d | j r|j d n|j d |j t | j j | |j | j j t | j d|j t | j j t | j r!|j d| j z dz dj | j S ) a% Format instruction details for inclusion in disassembly output
*lineno_width* sets the width of the line number field (0 omits it)
*mark_as_current* inserts a '-->' marker arrow as part of the line
*offset_width* sets the width of the instruction offset field
z%%%dd z-->z z>> ())r rz r r r rjustr ljust
_OPNAME_WIDTHr _OPARG_WIDTHr r~ rstrip)r lineno_widthmark_as_current offset_widthfields
lineno_fmts r5 _disassemblezInstruction._disassemble0 s# + $| 3
j4+;+; ;<
cL 01 MM% MM% MM$ MM$
d4;;'--l;<
dkk''
67 88 MM$txx...|< =||
cDLL 03 67xx &&((r N) Frp )rT r r __doc__r r r r5 r r s
#)r r )
first_liner: r; c
t | }t t | }|||j z
}nd}t t || |j |j |j |||j | S )a Iterator for the opcodes in methods, functions or code
Generates a series of Instruction named tuples giving the details of
each operations in the supplied code.
If *first_line* is not None, it indicates the line number that should
be reported for the first source line in the disassembled code.
Otherwise, the source line information (if any) is taken directly from
the disassembled code object.
r ) co_positionsr: )
r dictr co_firstlineno_get_instructions_bytesr _varname_from_opargr r r )rU r r: r; r
linestarts line_offsets r5 r r V sv
! BnR()J 2#4#44 "?2x#@#%#9#9#%;; #-{020A/: < <r c t }||| }|S )zHelper to get the value of the const in a hasconst op.
Returns the dereferenced constant if this is possible.
Otherwise (if it is a LOAD_CONST and co_consts is not
provided) returns the dis.UNKNOWN sentinel.
UNKNOWN)r r r r s r5 _get_const_valuer n s F 3 Mr c N t | || }|t ur t | nd}||fS )a Helper to get optional details about const references
Returns the dereferenced constant and its repr if the value
can be calculated.
Otherwise returns the sentinel value dis.UNKNOWN for the value
and an empty string for its repr.
r )r r r )r r r r r s r5 _get_const_infor | s. b#y
1F $G 3d6lG 7?r c 0 |
|| fi |}||fS t dfS )a
Helper to get optional details about named references
Returns the dereferenced name as both value and repr if the name
list is defined.
Otherwise returns the sentinel value dis.UNKNOWN for the value
and an empty string for its repr.
r r )
name_indexget_name extrainfor s r5 _get_name_infor s- *2 2v~ {r c l t | }|dz }|dz r |dz }t | }||dz z }|dz r |S )N? rt )next)iteratorbvals r5
_parse_varintr sJ XA
b&C
B$ N qt B$ Jr c . t | j }g } t | dz }t | dz }||z }t | dz }t | }|dz }t |dz } |j t ||||| l# t $ r |cY S w xY w)Nro rn )iterco_exceptiontabler boolrz r
StopIteration)
coder entriesstartlengthendtargetdlr9 lastis
r5 _parse_exception_tabler s D**+HG !(+A-E"8,Q.F&.C"8,Q.F x(B!GEAJE NN/sFE5Q R s A-B BBc dt | v S )Nr% )r )r s r5 _is_backward_jumpr s fRj ((r r c # @ K |xs t d }|dn |j } t t | }
|D ]* \ } } }
}}t | | D ] }|
j |
, d}t
| D ]& \ }} ||j |d }|||z
}||
v }d}d}t t |d }t | }t | } }|t v rt | | \ }}n|t v r|t k( r"t! dz | \ }} dz r|rd|z }n|t" k( r"t! dz | \ }} dz rz|rwd|z }np|t$ k( r"t! dz | \ }} dz rO|rLd|z }nEt! | \ }}n4|t& v r dz }d t) | z }n|t* v r2t- | r n }|dz |dz z }|d|z z
}d t) | z }n|t. v s|t0 v rt! | \ }}n|t2 v rt4 dz }|}n|t6 k( r1t8 d
z \ }}|t; dz f}|d ry|r|d z
}|d z
}nl|t< k( r(d j? fd
tA tB D }n;|tD k( r
tF \ }}n%|tH k( r
tJ }n|tL k( r tN }tQ tR | | |||||| t | }|sg|s t | D ] }t |d tT tV | jY D ] \ }}t | D ]l }|dz
}|dk( r5| ||d|z z } | dtZ j] | t^ j` }nd}tQ dtb dd||ddt t |d n ) yw)a& Iterate over the instructions in a bytecode string.
Generates a sequence of Instruction namedtuples giving the details of each
opcode. Additional information about the code's runtime environment
(e.g. variable names, co_consts) can be specified using optional
arguments.
r Nr ro rn zNULL + z NULL|self + rp zto r rx z with formatc 3 8 K | ] \ }}d |z z r| yw)rn Nr ).0r sr s r5 <genexpr>z*_get_instructions_bytes.<locals>.<genexpr> s' $5$!Q'*ad| %& $5s r z: r, F)2r __getitem__setr ry add_unpack_opargsr| r r r r hasconstr hasnamer# r r( r) hasjabsr hasjrelr haslocalhasfree
hascomparecmp_opr FORMAT_VALUE_CONVERTERSr r r~ r MAKE_FUNCTION_FLAGSr$ r r* r r+ r r r r r rI int
from_bytesrZ byteorderr, ) r varname_from_opargr r r r exception_entriesr r: r labelsr r r _r r r r r r r r deopcaches
signed_argr4 sizedatar s @r5 r r s +48L }t%*;*;H
D!
"F$5 sFAquc" A JJv K)$/ WC !$..6K&{* 6) tL" 56 |&t, ?
Fx "1$Y"G ;&&4S!VX&FOFGaW"+g"5Y&&4S!VX&FOFGaW"07":_,&4S!VX&FOFGaW"07":&4S(&COFG Q $v,. %6t%<cT#
!jl2!f*$ $v,.!TW_"06H"I# Q %"9#)"D $sSy/2!9 4},G & )) $5)<O2P $5 5" $S\
7)),S1)),S1+b/2 vw +~yJ J 't, 6]
'\2&
' 't 5;;=
JD$4[
! 6 T(9:D!%b cmm)L(M NG G!UAtWfdE tL" 56
UWs NN c t t | }t | }t t | | || j
| j | j |||| j |
y)zDisassemble a code object.)r8 r r r: N) r r r rQ r r r r r )r r r8 r: r; r r s r5 r r sY nR()J.r2r84 b 4 4{{BLL*4):$&OO$5; Pr c t | ||| ||dkD rS||dz
}| j D ]< }t |d st | t d|d| t ||||| > y y ) Nr= r rn rE rD zDisassembly of :r7 )r r rG rL rN )r r8 r9 r: r; rU s r5 rN rN ) su ;J } AIE Aq)$4 a1=&D;QY "r )r8 r r r r: c
D t | } | r9t |j |z } | dk\ rt t | }
nd}
nd}
t | dz
}|dk\ rt t | }nd}t | ||||||| |
D ] }| xr |j d uxr |j dkD }|r t | |
r|j |k( }nD|j |cxk xr/ |j dt t |j z z k nc }t |j |
|| | |rnt d | |D ][ }|j rd
nd }|j dz
}t d |j d
| d|j d|j" d|
| ] y y )Ni r r ro i' rp r r r r: rD zExceptionTable:z lastir r z to z -> z [])r maxvalueslenr r r r rL r r r r r r r r r9 )r r r r r r r8 r r r r: show_lineno maxlinenor maxoffsetr instrnew_source_lineis_current_instrentryr s r5 rQ rQ 6 s
z"K
))+,{: s9~.L L D A
IE3y>* (/A5)2J5@;L6B5@ B ' , ,,D8 , <<!+ t $||u 4 %||u T<<!&;HU\\<R&S"SS T
e /? N #&
d+& cE % HE))A+C Bu{{m4uD b
QugV]a b c r c 0 t t | d fi | y)z<Compile the source string, then disassemble the code object.z<dis>N)rN r6 )r3 kwargss r5 rR rR c s <8CFCr rs ro rn c # K d}d}t dt | d D ]g }|r|dz } | | }t | }t | }|t v r1| |dz |z }|t
k( r|dz nd}|t k\ r|dt z z }nd }d}|||f i y w)Nr ro rn rq )ry r* r r hasarg EXTENDED_ARG
_INT_OVERFLOW)r extended_argr r r r r s r5 r r o s L
F
1c$i
# aKF
!W|&t, 6>qs)l*C)- )=C1H1L }, M 11 C L"cl's BBc g }t | D ]l \ }}}|
t | }t | }|t v r"t | r| }|dz |dz z }|d|z z
}n|t
v r|dz }nW||vs\|j
| n |S )z`Detect all offsets in a byte code which are jump targets.
Return the list of offsets.
ro )r r r r r r rz )r r r r r r r labels r5 r r s F)$/ %C ?B<D*40Fw$T* $C
SU*V# AF"
e$ % Mr c # d K d}| j D ] \ }}}|
||k7 s|}||f yw)zqFind the offsets in a byte code which are start of lines in the source.
Generate pairs (offset, lineno)
N)co_lines)r lastliner r lines r5 r r sJ
H MMO sD 0H+ s 00 0c # K t d }| j }| j }t | j D cg c] \ }}}|t
k7 r||f }}}}t
| D ]l \ }\ }} ||k( s|dk\ s||dz
}
||dz
} |
d t v s1| d t v s=t | d | d | } t |
d |
d | }
|| | |
f n yc c}}}w w)zFind import statements in the code
Generate triplets (name, level, fromlist) where
name is the imported module and level, fromlist are
the corresponding args to __import__.
IMPORT_NAMEro rn r N) opmapr r r rE r6 r r r )r r@ constsr r r r opargsr opargfrom_oplevel_oplevelfromlists r5
_find_importsrI s
&K
\\F KKE*8*D ) )JAr3<' 3i )F )#F+ 6;B
a QqSkG ac{H
h&8A;(+B(!hqk6J+GAJ
FK U|UH556)s( ;CC C3C9C C!:Cc # K t d t d h}| j }t | j D ] \ }}}||v s || yw)z\Find names of variables which are written in the code
Generate sequence of strings
STORE_NAME STORE_GLOBALN)rA r r rE )r STORE_OPSr r r r s r5 _find_store_namesrN sY l
n I
KKE$RZZ0
2s
?* s ?A
A c R e Zd ZdZddddddZd Zd Zedddd Zd
Z d Z
y) r a The bytecode operations of a piece of code
Instantiate this with a function, method, other compiled object, string of
code, or a code object (as returned by compile()).
Iterating over this yields the bytecode operations as Instruction instances.
NF)r current_offsetr: r; c t | x| _ }||j | _ d| _ n|| _ ||j z
| _ t t
| | _ || _ || _ t | | _ || _ || _
y )Nr )r codeobjr r _line_offsetr r _linestarts_original_objectrP r r r: r; )r rU r rP r: r; r s r5 __init__zBytecode.__init__ s ,Q // r / /DO !D (DO *R->-> >D r 23 ! ,!7!; &
r c | j }t t || j |j |j
|j | j | j | j |j | j S )Nr& ) rR r r r; r r r rT rS r r r: )r r s r5 __iter__zBytecode.__iter__ sk
\\&r4=='I')'='='){{BLL'+'7'7373D3D9=9O9O46OO4E373C3CE Er c b dj | j j | j S )Nz{}({!r}))format __class__rT rU r s r5 r zBytecode.__repr__ s* !8!8!%!6!68 8r )r: r; c |j r|j }|j r | |j j |j || S )z/ Construct a Bytecode from the given traceback )rP r: r; )r_ r` ra rb )clsrc r: r; s r5 from_tracebackzBytecode.from_traceback sB jjB jj KK r{{ ^f
r c , t | j S )z3Return formatted information about the code object.)r rR r s r5 infoz
Bytecode.info s ..r c | j }| j
| j }nd}t j 5 }t t || j |j |j |j | j | j ||| j |j | j |j cddd S # 1 sw Y yxY w)z3Return a formatted view of the bytecode operations.N)
r r r r r r8 r r r r: )rR rP ioStringIOrQ r r; r r r rT rS r r r: getvalue)r r r outputs r5 r
z Bytecode.dis s
\\ *((FF
[[] %f r4== A242H2H%'[[BLL*.*:*:+/+<+<$*%+151G1G,.OO,=+/+;+;
= ??$ % % %s BCC ) rT r r r rV rX r classmethodr^ r` r
r r r5 r r sF )-Tu_d
! E8 /4u
/%r r c N ddl } | j }|j d| j d dd |j }|j
5 }|j
}ddd t |j
j d }t | y# 1 sw Y 6xY w) z*Simple test program to disassemble a file.r Ninfilerb?-)rS nargsdefaultr0 )
argparseArgumentParser add_argumentFileType
parse_argsri readr1 r4 r
)ro parserargsri r3 r s r5 _testrw s
$
$
&F
x'8'8'>cSVW D
64;;++V 4DI s BB$__main__r )NNNNr r NF)rb )rb NNNN)ir rZ types collectionsrc r r _opcodes_allr r r r r r
r
MethodType FunctionTypeCodeTyperg staticmethodrS rK rA r r r r r r r r! r" r# r$ r% r& r' r( r) r* r+ r, listr r r r r
startswith _empty_slotzipspec_op specializedrI r r6 r
r r{ r r r r r r r r r
namedtupler r r r r r r r r r r r r r r r r r r r r r rN rQ rR r _INT_BITSr7 r r r rI rN r rw rT )slotr4 basefamilyr s 00000r5 <module>r sG 6
:<H I 2 2ENN</
^$ %L 6N
G o&
J
<
^$ M" + o&
V} + )*+, +,
g6l
%[
&/ &<U
dPS@TtU -F G &G[&K %J{& +A*:*@*@*B &$V\ GRK )+*Dee +*Z h4UU h"
*&.B<2 @ $
#K " " VaZ
&{%%
V B : S T Q Q #Y &Y #!s -{--.D"$
3), 3)l '+ <0
) 6:269:?C(- kZPd P (,4UUZ ;?>B+c #b$(e+cZD
i!m$
00
6,
E% E%P
z G _ V s K)#K)K/
Browse
Usage
Versions