3 ^ #@sdZddlZddlmZddlmZddlmZddl m Z ddl m Z ddlmZmZmZmZd ZerlendZGd d d Zejefd d ZeZejZejZejZej Z ej!Z!ej"Z"ej#Z#ej$Z$ejZej%Z%ejZej&Z&ejZejZej'Z'ej(Z(ej)Z)ej Z ej*Z*ej+Z+ej,Z,dS)a Provide the same API as Python 3.x so xdis can be used as a drop in replacement for dis. This will provide a dis module with support for the Python version being run. Why would you want this? The main reason is if you want a compatibility shim for supporting the more advanced Python 3 dis API (being able to iterate through opcodes, supplying a custom file to dump the dis to) across python versions, for example: import xdis.std as dis # works in Python 2 and 3 for op in dis.Bytecode('for i in range(10): pass'): print(op) There is also the ability to generate an std api for a specific version, for example: from xdis.std import make_std_api dis = make_std_api(2.4) # dis can now disassemble code objects from python 2.4 Version 'variants' are also supported, for example: from xdis.std import make_std_api dis = make_std_api(2.6, 'pypy') # dis can now disassemble pypy code objects from python 2.6 N)IS_PYPY)Bytecode) _Instruction)disco)get_opcode_module) code_info pretty_flags show_code xstack_effectZpypyc@seZdZejefddZdddZddZddd Z dd d Z d d Z d ddZ d!ddZ d#ddZd%ddZd&ddZddZddZdS)'_StdApics|dkrddlj}n ddlj}||_t|||_j|_|t k|_ j |_ j |_ j |_ j|_j|_j|_Gfdddt|_Gfdddt}||_dS) Nrcs&eZdZdZdfdd ZZS)z"_StdApi.__init__..BytecodeaThe bytecode operations of a piece of code Instantiate this with a function, method, string of code, or a code object (as returned by compile()). Iterating over this yields the bytecode operations as Instruction instances. Ncst|j|||ddS)N)opc first_linecurrent_offset)super__init__)selfxrr)r __class__rE/home/psgendb/BIRCHDEV/python/lib/python3.6/site-packages/xdis/std.pyr[sz+_StdApi.__init__..Bytecode.__init__)NN)__name__ __module__ __qualname____doc__r __classcell__r)rr)rrrSsrcseZdZdZfddZdS)z%_StdApi.__init__..InstructionaDetails 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 cst|||_dS)N)rr)rargskwargs)rrrrns z._StdApi.__init__..Instruction.__init__N)rrrrrr)rrr Instruction`s r)r r )Z xdis.wordcodeZwordcode xdis.bytecodebytecodexcoderrversionpython_versionPYPYis_pypyhasconsthasnameopmapopname EXTENDED_ARG HAVE_ARGUMENT _Bytecoderrr)rr$variantr"rr)rrrrAs"    z_StdApi.__init__NcCs(|dkrt|n|jt|ddS)N )printwritestr)rrfilerrr_printss z_StdApi._printcCs t||jS)z1Formatted details of methods, functions, or code.) _code_infor$)rrrrrrysz_StdApi.code_infocCst||jj||jdS)zPrint details of methods, functions, or code to *file*. If *file* is not provided, the output is printed on stdout. )r&) _show_coderr#r&)rrr3rrrr }sz_StdApi.show_codecCstt|j||S)zDCompute the stack effect of *opcode* with argument *oparg*. ) _stack_effectrr)rZopargZjumprrr stack_effectsz_StdApi.stack_effectcCst|S)z+Return pretty representation of code flags.) _pretty_flags)rflagsrrrrsz_StdApi.pretty_flagscCs|j|j|j|dS)zDisassemble classes, methods, functions, generators, or code. With no argument, disassemble the last traceback. N)r4rdis)rrr3rrrr;sz _StdApi.disc Cs\|dkrBy tj}Wntk r.tdYnXx|jr@|j}q2W|j|jj|j|ddS)z2Disassemble a traceback (default: last traceback).Nz no last traceback to disassemble)r3) syslast_tracebackAttributeError RuntimeErrortb_next disassembletb_framef_codetb_lasti)rtbr3rrrdistbs  z _StdApi.distbcCs|j|||S)zDisassemble a code object.)r)rcodelastir3rrrrAsz_StdApi.disassemblecCst|j|d||jddS)zDisassemble a code object.NF) timestampoutr&header)_discor$r&)rrHrIr3rrrrs z _StdApi.discocCs|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. )rget_instructions)rrrrrrrNs z_StdApi.get_instructionscCs |jj|S)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. )rfindlinestarts)rrHrrrrOsz_StdApi.findlinestartscCs|jj||jS)zhDetect all offsets in a byte code which are jump targets. Return the list of offsets. )r findlabels)rrHrrrrPsz_StdApi.findlabels)N)N)NN)NN)NN)rQNrQ)rQN)N)rrrr< version_infoVARIANTrr4rr r8rr;rFrArrNrOrPrrrrr ?s2       r cCs8t|tr.t|}t||dd}||f}t||S)a Generate an object which can be used in the same way as the python standard dis module. The difference is that the generated 'module' can be used to disassemble byte / word code from a different python version than the version of the interpreter under which we are running. :param python_version: Generate a dis module for this version of python (defaults to the currently running python version.) :param variant: The string denoting the variant of the python version being run, for example 'pypy' or 'alpha0', 'rc1' etc, or None to auto detect based on the currently running interpreter. :return: object which can be used like the std dis module. g? ) isinstancefloatintr )r$r.majorminorrrr make_std_apis  rZ)-rr<xdisrr rr-Zxdis.instructionrZ xdis.mainrrMZxdis.op_importsrZxdis.cross_disrr5rr9r r6r r7r%rSr rRrZZ_std_apir'r(r)r*r+r,r"rrr4r;rFrArNrOrPrrrr.sD