B /g^Mc @sdZddlZddlZddlZddlZddlTddlmZddddd d d d d ddg eZ[ejej ej e e e fZedZddZdPdddddZdQddddZdddddddddd d! Zd"d#Zd$d%Zd&dZd'd(Zddd)d Zed*d+Zd,ej_d-ej_d.ej_d/ej_d0ej_d1ej _d2ej!_d3ej"_d4Z#d5Z$Gd6ddeZ%dd7d8d Z&d9d:Z'd;d<Z(dRd=d>Z)dSddd@dZ*ddddAdBZ+dTdddCdDdEZ,dFdGZ-e*Z.dHdIZ/dJd Z0dKd Z1GdLddZ2dMdNZ3e4dOkre3dS)Uz0Disassembler of Python byte code into mnemonics.N)Z*)__all__ code_infodis disassembledistbdiscofindlinestarts findlabels show_codeget_instructions InstructionBytecode FORMAT_VALUEcCs6yt||d}Wn tk r0t||d}YnX|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 Zevalexec)compileZ SyntaxError)sourcenameZcr/usr/lib64/python3.7/dis.py _try_compiles rfiledepthc Csn|dkrt|ddSt|dr&|j}t|dr8|j}n4t|drJ|j}n"t|dr\|j}nt|drl|j}t|drt|j }x|D]p\}}t |t rt d ||dyt |||d Wn0tk r}zt d ||dWdd}~XYnXt |dqWnht|d rt|||d nLt |ttfr            rcCs\|dkrDy tj}Wntk r0tddYnXx|jrB|j}q4Wt|jj|j|ddS)z2Disassemble a traceback (default: last traceback).Nz no last traceback to disassembler) sysZlast_tracebackZAttributeErrorZ RuntimeErrortb_nextrtb_framef_codetb_lasti)tbrrrrrOs  Z OPTIMIZEDZ NEWLOCALSZVARARGSZ VARKEYWORDSZNESTEDZ GENERATORZNOFREEZ COROUTINEZITERABLE_COROUTINEZASYNC_GENERATOR) i i@icCsbg}xRtdD]8}d|>}||@r|t|t|||N}|sPqW|t|d|S)z+Return pretty representation of code flags.r8r4, )rangeappendCOMPILER_FLAG_NAMESgetZhexjoin)ZflagsnamesiZflagrrr pretty_flagsisrCcCst|dr|j}t|dr"|j}n4t|dr4|j}n"t|drF|j}nt|drV|j}t|trjt|d}t|drx|St dt |j d S) zDHelper to handle methods, compiled or raw code objects, and strings.rrrrrz rr N) r!rrrrrr#r)rr&r+r,r-rrr_get_code_objectws         rEcCs tt|S)z1Formatted details of methods, functions, or code.)_format_code_inforErDrrrrcCsg}|d|j|d|j|d|j|d|j|d|j|d|j|dt|j|j r|dx t |j D]}|d |qW|j r|d x t |j D]}|d |qW|j r|d x t |j D]}|d |qW|j rF|d x"t |j D]}|d |q.W|jr||dx"t |jD]}|d |qdWd|S)NzName: %szFilename: %szArgument count: %szKw-only arguments: %szNumber of locals: %szStack size: %szFlags: %sz Constants:z%4d: %rzNames:z%4d: %szVariable names:zFree variables:zCell variables:Z )r=Zco_nameZ co_filenameZ co_argcountZco_kwonlyargcountZ co_nlocalsZ co_stacksizerCZco_flags co_constsZ enumerateco_names co_varnames co_freevars co_cellvarsr@)coZlinesZi_cZi_nrrrrFs:     rFcCstt||ddS)z}Print details of methods, functions, or code to *file*. If *file* is not provided, the output is printed on stdout. rN)r%r)rMrrrrr s _InstructionzBopname opcode arg argval argrepr offset starts_line is_jump_targetz!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 Falseiic@seZdZdZdddZdS) r aKDetails 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 Fr6cCsg}|r:|jdk r,d|}|||jn|d||rJ|dn |d|jrf|dn |d|t|j|||jt|j dk r|t|j t |j r|d|j d d | 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 Nz%%%ddz z-->z z>>z z(z)) starts_liner=is_jump_targetreproffsetZrjustopnameZljust _OPNAME_WIDTHarg _OPARG_WIDTHargreprr@Zrstrip)self lineno_widthZmark_as_current offset_widthZfieldsZ lineno_fmtrrr _disassembles&      zInstruction._disassembleN)rOFr6)r, __module__ __qualname____doc__r\rrrrr s ) first_linecCsTt|}|j|j}tt|}|dk r4||j}nd}t|j|j|j |j |||S)aIterator 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. Nr) rErLrKdictrco_firstlineno_get_instructions_bytesrrJrIrH)r-r`rM cell_names linestarts line_offsetrrrr s    cCs |}|dk r||}|t|fS)zHelper to get optional details about const references Returns the dereferenced constant and its repr if the constant list is defined. Otherwise returns the constant index and its repr(). NrR)Z const_indexZ const_listargvalrrr_get_const_infosricCs*|}|dk r||}|}nt|}||fS)zHelper 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 name index and its repr(). Nrg)Z name_indexZ name_listrhrXrrr_get_name_infos rjc csxt|}d}xdt|D]V\} } } |dk rH|| d}|dk rH||7}| |k} d} d}| dk rT| } | tkr~t| |\} }n| tkrt| |\} }n| tkr| d| } dt| }n| t krt| |\} }n| t krt | } | }nn| t krt| |\} }nV| t krTdtttf| d@t| d@f} d| d@}| drT|rL|d 7}|d 7}tt| | | | || || VqWdS) 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, constants) can be specified using optional arguments. Nr5zto rOr6)rkr)rRasciir4r;z with format)r_unpack_opargsr?ZhasconstriZhasnamerjhasjrelrRZhaslocalZ hascompareZcmp_opZhasfreer r)rlZboolr rT)codevarnamesrA constantscellsrerflabelsrPrSoprVrQrhrXrrrrc-sH         rcc Cs<|j|j}tt|}t|j||j|j|j|||ddS)zDisassemble a code object.rN) rLrKrarr(rrJrIrH)rMlastirrdrerrrr`s  cCstt||d|dks|dkrp|dk r,|d}xB|jD]8}t|dr4t|dtd|f|dt|||dq4WdS)Nrrr4rzDisassembly of %r:r)rrHr!r%r')rMrrr-rrrr'gs    r')rrfc Cs|dk } | r8t||} | dkr2tt| } qN)r'r)rZkwargsrrrr*rGr*ccshd}x^tdt|dD]J}||}|tkrP||d|B}|tkrJ|d>nd}nd}|||fVqWdS)Nrr5r4r7)r<rxZ HAVE_ARGUMENTZ EXTENDED_ARG)roZ extended_argrBrtrVrrrrmsrmcCs`g}xVt|D]J\}}}|dk r|tkr6|d|}n|tkr|}nq||kr||qW|S)z`Detect all offsets in a byte code which are jump targets. Return the list of offsets. Nr5)rmrnZhasjabsr=)rorsrSrtrVZlabelrrrrsccs|jddd}|jddd}d}|j}d}xPt||D]B\}}|rd||kr\||fV|}||7}|dkrt|d8}||7}q:W||kr||fVdS)zFind the offsets in a byte code which are start of lines in the source. Generate pairs (offset, lineno) as described in Python/compile.c. rNr5r4r9r:)Z co_lnotabrbZzip)roZbyte_incrementsZline_incrementsZ lastlinenoZlinenoZaddrZ byte_incrZ line_incrrrrrs   c@sLeZdZdZdddddZddZdd Zed d Zd d Z ddZ dS)r aThe 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. N)r`current_offsetcCsdt||_}|dkr&|j|_d|_n||_||j|_|j|j|_tt ||_ ||_ ||_ dS)Nr) rEcodeobjrbr` _line_offsetrLrK _cell_namesrar _linestarts_original_objectry)rYr-r`ryrMrrr__init__s zBytecode.__init__c Cs*|j}t|j|j|j|j|j|j|jdS)Nrw) rzrcrrJrIrHr|r}r{)rYrMrrr__iter__s zBytecode.__iter__cCsd|jj|jS)Nz{}({!r}))ZformatZ __class__r,r~rYrrr__repr__s zBytecode.__repr__cCs$x|jr|j}qW||jj|jdS)z/ Construct a Bytecode from the given traceback )ry)r/r0r1r2)Zclsr3rrrfrom_tracebacks zBytecode.from_tracebackcCs t|jS)z3Return formatted information about the code object.)rFrzrrrrinforGz Bytecode.infoc Cs`|j}|jdk r|j}nd}t2}t|j|j|j|j|j |j |j ||d | SQRXdS)z3Return a formatted view of the bytecode operations.Nru)rprArqrrrerfrrv) rzryioZStringIOr(rrJrIrHr|r}r{Zgetvalue)rYrMrSZoutputrrrrs   z Bytecode.dis) r,r]r^r_rrr classmethodrrrrrrrr s  c Csdddl}|}|jd|ddd|}|j}|}WdQRXt||jjd}t |dS)z*Simple test program to disassemble a file.rNinfilez?z-)r+ZnargsZdefaultr) argparseZArgumentParserZ add_argumentZFileTypeZ parse_argsrZreadrrr)rZparserZargsrrrorrr_test srZ__main__Nr)NNNNNr)ru)ruNNNNN)5r_r.ZtypesZ collectionsrZopcoderZ _opcodes_allZ MethodTypeZ FunctionTypeZCodeTyperZ staticmethodr+r$Zopmapr rrrr>rCrErrFr Z namedtuplerNrTrVrhrXrSrPrQrUrWr r rirjrcrr'r(r*rrmrrr rr,rrrrZs~     -4  2  =