← Back
Editing: inspect.cpython-33.pyc
� �� fp4 c @ s� d Z d� Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l Z d d l m Z d d l m Z m Z y d d l m Z Wn9 e k rd� \ Z Z d� \ Z Z d� \ Z Z Z Yn5 Xe � Z x( e j! � D] \ Z" Z# e" e d e# <q(Wd� Z$ d d � Z% d d � Z& d d � Z' d d � Z( d d � Z) e* e d � r�d d � Z+ n d d � Z+ e* e d � r�d d! � Z, n d" d! � Z, d# d$ � Z- d% d& � Z. d' d( � Z/ d) d* � Z0 d+ d, � Z1 d- d. � Z2 d/ d0 � Z3 d1 d2 � Z4 d3 d4 � Z5 d d5 d6 � Z7 e d7 d8 � Z8 d9 d: � Z9 d; d< � Z: d= d> � Z; d? d@ � Z< dA dB � Z= dC dD � Z> e dE dF � Z? dG dH � Z@ dI dJ � ZA dK dL � ZB d dM dN � ZC i ZD i ZE d dO dP � ZF dQ dR � ZG dS dT � ZH GdU dV � dV eI � ZJ GdW dX � dX � ZK dY dZ � ZL d[ d\ � ZM d] d^ � ZN d_ d` � ZO d� da db � ZQ e dc dd � ZR de df � ZS dg dh � ZT e di dj � ZU dk dl � ZV e dm dn � ZW do dp � ZX e dq dr � ZY ds dt � ZZ d du dv � Z[ dw dx � Z\ d d d f i i e] dy dz � d{ dz � d| dz � d} dz � e[ d~ d � Z^ e] d� dz � d� dz � d� dz � d� d� � Z_ d� d� � Z` d� d� � Za d� d� � Zb e d� d� � Zc d� d� � Zd e d� d� � Ze d d� d� � Zf d� d� � Zg d d� d� � Zh d d� d� � Zi d� d� � Zj d d� d� � Zk d d� d� � Zl em � Zn d� d� � Zo d� d� � Zp d� d� � Zq d� d� � Zr d� d� � Zs en d� d� � Zt d� Zu d� Zv d� Zw d� Zx d� d� � Zy d� d� � Zz e{ e{ j| � Z} e{ e~ j| � Z e} e e j� f Z� d� d� � Z� d� d� � Z� Gd� d� � d� � Z� Gd� d� � d� � Z� Gd� d� � d� e� � Z� e� d d� d� �Z� e� d d� d� �Z� e� d d� d� �Z� e� d� d� d� �Z� e� d d� d� �Z� Gd� d� � d� � Z� Gd� d� � d� � Z� Gd� d� � d� � Z� d S(� u( Get useful information from live Python objects. This module encapsulates the interface provided by the internal special attributes (co_*, im_*, tb_*, etc.) in a friendlier fashion. It also provides some help for examining source code and class layout. Here are some of the useful functions provided by this module: ismodule(), isclass(), ismethod(), isfunction(), isgeneratorfunction(), isgenerator(), istraceback(), isframe(), iscode(), isbuiltin(), isroutine() - check object types getmembers() - get members of an object that satisfy a given condition getfile(), getsourcefile(), getsource() - find an object's source code getdoc(), getcomments() - get documentation on an object getmodule() - determine the module that an object came from getclasstree() - arrange classes so as to represent their hierarchy getargspec(), getargvalues(), getcallargs() - get info about function arguments getfullargspec() - same, with support for Python-3000 features formatargspec(), formatargvalues() - format an argument spec getouterframes(), getinnerframes() - get info about frames currentframe() - get the current stack frame stack(), trace() - get info about frames on the stack or in a traceback signature() - get a Signature object for the callable u Ka-Ping Yee <ping@lfw.org>u' Yury Selivanov <yselivanov@sprymix.com>i N( u attrgetter( u namedtupleu OrderedDict( u COMPILER_FLAG_NAMESi i i i i i i@ u CO_i c C s t | t j � S( u� Return true if the object is a module. Module objects provide these attributes: __cached__ pathname to byte compiled file __doc__ documentation string __file__ filename (missing for built-in modules)( u isinstanceu typesu ModuleType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu ismoduleC s u ismodulec C s t | t � S( u� Return true if the object is a class. Class objects provide these attributes: __doc__ documentation string __module__ name of module in which this class was defined( u isinstanceu type( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isclassL s u isclassc C s t | t j � S( u_ Return true if the object is an instance method. Instance method objects provide these attributes: __doc__ documentation string __name__ name with which this method was defined __func__ function object containing implementation of method __self__ instance to which this method is bound( u isinstanceu typesu MethodType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu ismethodT s u ismethodc C sQ t | � s$ t | � s$ t | � r( d St | � } t | d � oP t | d � S( u� Return true if the object is a method descriptor. But not if ismethod() or isclass() or isfunction() are true. This is new in Python 2.2, and, for example, is true of int.__add__. An object passing this test has a __get__ attribute but not a __set__ attribute, but beyond that the set of attributes varies. __name__ is usually sensible, and __doc__ often is. Methods implemented via descriptors that also pass one of the other tests return false from the ismethoddescriptor() test, simply because the other tests promise more -- you can, e.g., count on having the __func__ attribute (etc) when an object passes ismethod().u __get__u __set__F( u isclassu ismethodu isfunctionu Falseu typeu hasattr( u objectu tp( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu ismethoddescriptor^ s $ u ismethoddescriptorc C sP t | � s$ t | � s$ t | � r( d St | � } t | d � oO t | d � S( u� Return true if the object is a data descriptor. Data descriptors have both a __get__ and a __set__ attribute. Examples are properties (defined in Python) and getsets and members (defined in C). Typically, data descriptors will also have __name__ and __doc__ attributes (properties, getsets, and members have both of these attributes), but this is not guaranteed.u __set__u __get__F( u isclassu ismethodu isfunctionu Falseu typeu hasattr( u objectu tp( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isdatadescriptorr s $ u isdatadescriptoru MemberDescriptorTypec C s t | t j � S( u� Return true if the object is a member descriptor. Member descriptors are specialized descriptors defined in extension modules.( u isinstanceu typesu MemberDescriptorType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu ismemberdescriptor� s u ismemberdescriptorc C s d S( u� Return true if the object is a member descriptor. Member descriptors are specialized descriptors defined in extension modules.F( u False( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu ismemberdescriptor� s u GetSetDescriptorTypec C s t | t j � S( u� Return true if the object is a getset descriptor. getset descriptors are specialized descriptors defined in extension modules.( u isinstanceu typesu GetSetDescriptorType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isgetsetdescriptor� s u isgetsetdescriptorc C s d S( u� Return true if the object is a getset descriptor. getset descriptors are specialized descriptors defined in extension modules.F( u False( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isgetsetdescriptor� s c C s t | t j � S( u( Return true if the object is a user-defined function. Function objects provide these attributes: __doc__ documentation string __name__ name with which this function was defined __code__ code object containing compiled function bytecode __defaults__ tuple of any default values for arguments __globals__ global namespace in which this function was defined __annotations__ dict of parameter annotations __kwdefaults__ dict of keyword only parameters with defaults( u isinstanceu typesu FunctionType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isfunction� s u isfunctionc C s, t t | � s t | � o( | j j t @� S( u� Return true if the object is a user-defined generator function. Generator function objects provides same attributes as functions. See help(isfunction) for attributes listing.( u boolu isfunctionu ismethodu __code__u co_flagsu CO_GENERATOR( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isgeneratorfunction� s u isgeneratorfunctionc C s t | t j � S( u Return true if the object is a generator. Generator objects provide these attributes: __iter__ defined to support iteration over container close raises a new GeneratorExit exception inside the generator to terminate the iteration gi_code code object gi_frame frame object or possibly None once the generator has been exhausted gi_running set to 1 when generator is executing, 0 otherwise next return the next item from the container send resumes the generator and "sends" a value that becomes the result of the current yield-expression throw used to raise an exception inside the generator( u isinstanceu typesu GeneratorType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isgenerator� s u isgeneratorc C s t | t j � S( ub Return true if the object is a traceback. Traceback objects provide these attributes: tb_frame frame object at this level tb_lasti index of last attempted instruction in bytecode tb_lineno current line number in Python source code tb_next next inner traceback object (called by this level)( u isinstanceu typesu TracebackType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu istraceback� s u istracebackc C s t | t j � S( u` Return true if the object is a frame object. Frame objects provide these attributes: f_back next outer frame object (this frame's caller) f_builtins built-in namespace seen by this frame f_code code object being executed in this frame f_globals global namespace seen by this frame f_lasti index of last attempted instruction in bytecode f_lineno current line number in Python source code f_locals local namespace seen by this frame f_trace tracing function for this frame, or None( u isinstanceu typesu FrameType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isframe� s u isframec C s t | t j � S( uu Return true if the object is a code object. Code objects provide these attributes: co_argcount number of arguments (not including * or ** args) co_code string of raw compiled bytecode co_consts tuple of constants used in the bytecode co_filename name of file in which this code object was created co_firstlineno number of first line in Python source code co_flags bitmap: 1=optimized | 2=newlocals | 4=*arg | 8=**arg co_lnotab encoded mapping of line numbers to bytecode indices co_name name with which this code object was defined co_names tuple of names of local variables co_nlocals number of local variables co_stacksize virtual machine stack space required co_varnames tuple of names of arguments and local variables( u isinstanceu typesu CodeType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu iscode� s u iscodec C s t | t j � S( u, Return true if the object is a built-in function or method. Built-in functions and methods provide these attributes: __doc__ documentation string __name__ original name of this function or method __self__ instance to which a method is bound, or None( u isinstanceu typesu BuiltinFunctionType( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isbuiltin� s u isbuiltinc C s. t | � p- t | � p- t | � p- t | � S( u< Return true if the object is any kind of function or method.( u isbuiltinu isfunctionu ismethodu ismethoddescriptor( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isroutine� s u isroutinec C s t t | t � o | j t @� S( u: Return true if the object is an abstract base class (ABC).( u boolu isinstanceu typeu __flags__u TPFLAGS_IS_ABSTRACT( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu isabstract s u isabstractc C s� t | � r" | f t | � } n f } g } x� t | � D]� } xY | D]& } | | j k rH | j | } PqH qH Wy t | | � } Wn t k r� w; Yn X| s� | | � r; | j | | f � q; q; W| j � | S( u� Return all members of an object as (name, value) pairs sorted by name. Optionally, only return members that satisfy a given predicate.( u isclassu getmrou diru __dict__u getattru AttributeErroru appendu sort( u objectu predicateu mrou resultsu keyu baseu value( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getmembers s" u getmembersu Attributeu name kind defining_class objectc C sb t | � } t | � } g } x=| D]5} d } x\ | f | D], } | | j k r? | j | } | } Pq? q? Wt | | � } t | d | � } t | t � r� d } n� t | t � r� d } n~ t | t � r� d } nf t | � r� d } nQ t | � rd } n< t | | � } t | � s)t | � r2d } n d } | } | j t | | | | � � q% W| S( u� Return list of attribute-descriptor tuples. For each name in dir(cls), the return list contains a 4-tuple with these elements: 0. The name (a string). 1. The kind of attribute this is, one of these strings: 'class method' created via classmethod() 'static method' created via staticmethod() 'property' created via property() 'method' any other flavor of method 'data' not a method 2. The class which defined this attribute (a class). 3. The object as obtained directly from the defining class's __dict__, not via getattr. This is especially important for data attributes: C.data is just a data object, but C.__dict__['data'] may be a data descriptor with additional info, like a __doc__ string. u __objclass__u static methodu class methodu propertyu methodu dataN( u getmrou diru Noneu __dict__u getattru isinstanceu staticmethodu classmethodu propertyu ismethoddescriptoru isdatadescriptoru isfunctionu appendu Attribute( u clsu mrou namesu resultu nameu homeclsu baseu obju kindu obj_via_getattr( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu classify_class_attrs" s< u classify_class_attrsc C s | j S( uH Return tuple of base classes (including cls) in method resolution order.( u __mro__( u cls( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getmroh s u getmroc C s& | j � } t | � t | j � � S( uB Return the indent size, in spaces, at the start of a line of text.( u expandtabsu lenu lstrip( u lineu expline( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu indentsizem s u indentsizec C sC y | j } Wn t k r% d SYn Xt | t � s9 d St | � S( u� Get the documentation string for an object. All tabs are expanded to spaces. To clean up docstrings that are indented to line up with blocks of code, any whitespace than can be uniformly removed from the second line onwards is removed.N( u __doc__u AttributeErroru Noneu isinstanceu stru cleandoc( u objectu doc( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getdocr s u getdocc C sO y | j � j d � } Wn t k r1 d SYnXt j } xR | d d � D]@ } t | j � � } | rL t | � | } t | | � } qL qL W| r� | d j � | d <n | t j k r� x8 t d t | � � D] } | | | d � | | <q� Wn x | r| d r| j � q� Wx" | r=| d r=| j d � q Wd j | � Sd S( u� Clean up indentation from docstrings. Any whitespace that can be uniformly removed from the second line onwards is removed.u i Ni i����( u expandtabsu splitu UnicodeErroru Noneu sysu maxsizeu lenu lstripu minu rangeu popu join( u docu linesu marginu lineu contentu indentu i( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu cleandoc� s( u cleandocc C s t | � r: t | d � r" | j St d j | � � � n t | � r� t j j | j � } t | d � rq | j St d j | � � � n t | � r� | j } n t | � r� | j } n t | � r� | j } n t | � r� | j } n t | � r� | j St d j | � � � d S( u@ Work out which source or compiled file an object was defined in.u __file__u {!r} is a built-in moduleu {!r} is a built-in classuO {!r} is not a module, class, method, function, traceback, frame, or code objectN( u ismoduleu hasattru __file__u TypeErroru formatu isclassu sysu modulesu getu __module__u ismethodu __func__u isfunctionu __code__u istracebacku tb_frameu isframeu f_codeu iscodeu co_filename( u object( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getfile� s* u getfileu ModuleInfou name suffix mode module_typec C s� t j d t d � t j j | � } d d � t j � D� } | j � xM | D]E \ } } } } | | d � | k rO t | d | � | | | � SqO Wd S( uD Get the module name, suffix, mode, and module type for a given file.u% inspect.getmoduleinfo() is deprecatedi c S s2 g | ]( \ } } } t | � | | | f � q S( ( u len( u .0u suffixu modeu mtype( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <listcomp>� s u! getmoduleinfo.<locals>.<listcomp>N( u warningsu warnu DeprecationWarningu osu pathu basenameu impu get_suffixesu sortu ModuleInfo( u pathu filenameu suffixesu neglenu suffixu modeu mtype( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getmoduleinfo� s u getmoduleinfoc C sp t j j | � } d d � t j j � D� } | j � x1 | D]) \ } } | j | � r? | d | � Sq? Wd S( u1 Return the module name for a given file, or None.c S s# g | ] } t | � | f � q S( ( u len( u .0u suffix( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <listcomp>� s u! getmodulename.<locals>.<listcomp>N( u osu pathu basenameu importlibu machineryu all_suffixesu sortu endswithu None( u pathu fnameu suffixesu neglenu suffix( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getmodulename� s u getmodulenamec s� t | � � t j j d d � } | t j j d d � 7} t � f d d � | D� � r� t j j � � d t j j d � n) t � f d d � t j j D� � r� d St j j � � r� � St t | � � d � r� � S� t j k r� � Sd S( u� Return the filename that can be used to locate an object's source. Return None if no way can be identified to get the source. Nc 3 s | ] } � j | � Vq d S( N( u endswith( u .0u s( u filename( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <genexpr>� s u getsourcefile.<locals>.<genexpr>i c 3 s | ] } � j | � Vq d S( N( u endswith( u .0u s( u filename( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <genexpr>� s u __loader__( u getfileu importlibu machineryu DEBUG_BYTECODE_SUFFIXESu OPTIMIZED_BYTECODE_SUFFIXESu anyu osu pathu splitextu SOURCE_SUFFIXESu EXTENSION_SUFFIXESu Noneu existsu hasattru getmoduleu linecacheu cache( u objectu all_bytecode_suffixes( ( u filenameu, /opt/alt/python33/lib64/python3.3/inspect.pyu getsourcefile� s u getsourcefilec C sC | d k r' t | � p! t | � } n t j j t j j | � � S( u� Return an absolute path to the source or compiled file for an object. The idea is for each object to have a unique origin, so this routine normalizes the result as much as possible.N( u Noneu getsourcefileu getfileu osu pathu normcaseu abspath( u objectu _filename( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getabsfile� s u getabsfilec C s t | � r | St | d � r2 t j j | j � S| d k r^ | t k r^ t j j t | � Sy t | | � } Wn t k r� d SYn X| t k r� t j j t | � Sx� t t j j � � D]� \ } } t | � r� t | d � r� | j } | t j | d � k rq� n | t | <t | � } | j t | <t t j j | � <q� q� W| t k rlt j j t | � St j d } t | d � s�d St | | j � r�t | | j � } | | k r�| Sn t j d } t | | j � rt | | j � } | | k r| Sn d S( uA Return the module an object was defined in, or None if not found.u __module__u __file__u __main__u __name__u builtinsN( u ismoduleu hasattru sysu modulesu getu __module__u Noneu modulesbyfileu getabsfileu TypeErroru listu itemsu __file__u _filesbymodnameu __name__u osu pathu realpathu getattr( u objectu _filenameu fileu modnameu moduleu fu mainu mainobjectu builtinu builtinobject( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getmodule� sD " ( u getmodulec C s� t | � } t | � } | rR | d d � | d d � d k rR t d � � n | r^ | n | } t | | � } | r� t j | | j � } n t j | � } | s� t d � � n t | � r� | d f St | � r�| j } t j d | d � } g } xp t t | � � D]\ } | j | | � } | r| | d d k rM| | f S| j | j d � | f � qqW| r�| j � | | d d f St d � � n t | � r�| j } n t | � r�| j } n t | � r�| j } n t | � r| j } n t | � r�t | d � s+t d � � n | j d } t j d � } x1 | d k rz| j | | � rmPn | d } qJW| | f St d � � d S( ub Return the entire source file and starting line number for an object. The argument may be a module, class, method, function, traceback, frame, or code object. The source code is returned as a list of all the lines in the file and the line number indexes a line in that list. An IOError is raised if the source code cannot be retrieved.Ni u <>u source code not availableu could not get source codei u ^(\s*)class\s*u \bu cu could not find class definitionu co_firstlinenou" could not find function definitionu+ ^(\s*def\s)|(.*(?<!\w)lambda(:|\s))|^(\s*@)u could not find code objecti����( u getfileu getsourcefileu IOErroru getmoduleu linecacheu getlinesu __dict__u ismoduleu isclassu __name__u reu compileu rangeu lenu matchu appendu groupu sortu ismethodu __func__u isfunctionu __code__u istracebacku tb_frameu isframeu f_codeu iscodeu hasattru co_firstlineno( u objectu fileu sourcefileu moduleu linesu nameu patu candidatesu iu matchu lnum( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu findsource s\ + # u findsourcec C s� y t | � \ } } Wn t t f k r4 d SYn Xt | � rEd } | rp | d d d � d k rp d } n x6 | t | � k r� | | j � d k r� | d } qs W| t | � k r�| | d d � d k r�g } | } xQ | t | � k r4| | d d � d k r4| j | | j � � | d } q� Wd j | � Sn�| d k r�t | | � } | d } | d k r�| | j � d d � d k r�t | | � | k r�| | j � j � g } | d k rk| d } | | j � j � } xv | d d � d k rgt | | � | k rg| g | d d � <| d } | d k rNPn | | j � j � } q�Wn x0 | r�| d j � d k r�g | d d � <qnWx0 | r�| d j � d k r�g | d d � <q�Wd j | � Sn d S( uw Get lines of comments immediately preceding an object's source code. Returns None when source can't be found. i Ni u #!i u u #( u u #i����i����( u findsourceu IOErroru TypeErroru Noneu ismoduleu lenu stripu appendu expandtabsu joinu indentsizeu lstrip( u objectu linesu lnumu startu commentsu endu indentu comment( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getcommentsb sJ +,/ , / u getcommentsc B s | Ee Z d Z d S( u EndOfBlockN( u __name__u __module__u __qualname__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu EndOfBlock� s u EndOfBlockc B s2 | Ee Z d Z d Z d d � Z d d � Z d S( u BlockFinderu@ Provide a tokeneater() method to detect the end of a code block.c C s1 d | _ d | _ d | _ d | _ d | _ d S( Ni i F( u indentu Falseu islambdau startedu passlineu last( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __init__� s u BlockFinder.__init__c C s$ | j sE | d k r9 | d k r- d | _ n d | _ n d | _ n� | t j k r d | _ | d | _ | j r t � q n� | j r� n� | t j k r� | j d | _ d | _ nj | t j k r� | j d | _ | j d k r t � q n0 | j d k r | t j t j f k r t � n d S( Nu defu classu lambdai i ( u defu classu lambdaTF( u startedu Trueu islambdau passlineu tokenizeu NEWLINEu Falseu lastu EndOfBlocku INDENTu indentu DEDENTu COMMENTu NL( u selfu typeu tokenu srowcolu erowcolu line( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu tokeneater� s, 'u BlockFinder.tokeneaterN( u __name__u __module__u __qualname__u __doc__u __init__u tokeneater( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu BlockFinder� s u BlockFinderc C so t � } y: t j t | � j � } x | D] } | j | � q+ WWn t t f k r] Yn X| d | j � S( u@ Extract the block of code at the top of the given list of lines.N( u BlockFinderu tokenizeu generate_tokensu iteru __next__u tokeneateru EndOfBlocku IndentationErroru last( u linesu blockfinderu tokensu _token( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getblock� s u getblockc C sJ t | � \ } } t | � r( | d f St | | d � � | d f Sd S( u� Return a list of source lines and starting line number for an object. The argument may be a module, class, method, function, traceback, frame, or code object. The source code is returned as a list of the lines corresponding to the object and the line number indicates where in the original source file the first line of code was found. An IOError is raised if the source code cannot be retrieved.i Ni ( u findsourceu ismoduleu getblock( u objectu linesu lnum( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getsourcelines� s u getsourcelinesc C s t | � \ } } d j | � S( u Return the text of the source code for an object. The argument may be a module, class, method, function, traceback, frame, or code object. The source code is returned as a single string. An IOError is raised if the source code cannot be retrieved.u ( u getsourcelinesu join( u objectu linesu lnum( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getsource� s u getsourcec C sv g } | j d t d d � � xP | D]H } | j | | j f � | | k r& | j t | | | | � � q& q& W| S( u- Recursive helper function for getclasstree().u keyu __module__u __name__( u sortu attrgetteru appendu __bases__u walktree( u classesu childrenu parentu resultsu c( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu walktree� s $u walktreec C s� i } g } x� | D]� } | j r� x� | j D]Y } | | k rK g | | <n | | | k ro | | j | � n | r, | | k r, Pq, q, Wq | | k r | j | � q q Wx* | D]" } | | k r� | j | � q� q� Wt | | d � S( u� Arrange the given list of classes into a hierarchy of nested lists. Where a nested list appears, it contains classes derived from the class whose entry immediately precedes the list. Each entry is a 2-tuple containing a class and a tuple of its base classes. If the 'unique' argument is true, exactly one entry appears in the returned structure for each class in the given list. Otherwise, classes using multiple inheritance and their descendants will appear multiple times.N( u __bases__u appendu walktreeu None( u classesu uniqueu childrenu rootsu cu parent( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getclasstree� s" u getclasstreeu Argumentsu args, varargs, varkwc C s, t | � \ } } } } t | | | | � S( u Get information about the arguments accepted by a code object. Three things are returned: (args, varargs, varkw), where 'args' is the list of argument names. Keyword-only arguments are appended. 'varargs' and 'varkw' are the names of the * and ** arguments or None.( u _getfullargsu Arguments( u cou argsu varargsu kwonlyargsu varkw( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getargs s u getargsc C s� t | � s$ t d j | � � � n | j } | j } | j } t | d | � � } t | | | | � � } d } | | 7} d } | j t @r� | j | } | d } n d } | j t @r� | j | } n | | | | f S( u Get information about the arguments accepted by a code object. Four things are returned: (args, varargs, kwonlyargs, varkw), where 'args' and 'kwonlyargs' are lists of argument names, and 'varargs' and 'varkw' are the names of the * and ** arguments or None.u {!r} is not a code objectNi i ( u iscodeu TypeErroru formatu co_argcountu co_varnamesu co_kwonlyargcountu listu Noneu co_flagsu CO_VARARGSu CO_VARKEYWORDS( u cou nargsu namesu nkwargsu argsu kwonlyargsu stepu varargsu varkw( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _getfullargs s" u _getfullargsu ArgSpecu args varargs keywords defaultsc C sO t | � \ } } } } } } } | s- | r< t d � � n t | | | | � S( uS Get the names and default values of a function's arguments. A tuple of four things is returned: (args, varargs, varkw, defaults). 'args' is a list of the argument names. 'args' will include keyword-only argument names. 'varargs' and 'varkw' are the names of the * and ** arguments or None. 'defaults' is an n-tuple of the default values of the last n arguments. Use the getfullargspec() API for Python-3000 code, as annotations and keyword arguments are supported. getargspec() will raise ValueError if the func has either annotations or keyword arguments. uc Function has keyword-only arguments or annotations, use getfullargspec() API which can support them( u getfullargspecu ValueErroru ArgSpec( u funcu argsu varargsu varkwu defaultsu kwonlyargsu kwonlydefaultsu ann( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getargspec) s ! u getargspecu FullArgSpecuG args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, annotationsc C s| t | � r | j } n t | � s< t d j | � � � n t | j � \ } } } } t | | | | j | | j | j � S( u� Get the names and default values of a function's arguments. A tuple of seven things is returned: (args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults annotations). 'args' is a list of the argument names. 'varargs' and 'varkw' are the names of the * and ** arguments or None. 'defaults' is an n-tuple of the default values of the last n arguments. 'kwonlyargs' is a list of keyword-only argument names. 'kwonlydefaults' is a dictionary mapping names from kwonlyargs to defaults. 'annotations' is a dictionary mapping argument names to annotations. The first four items in the tuple correspond to getargspec(). u {!r} is not a Python function( u ismethodu __func__u isfunctionu TypeErroru formatu _getfullargsu __code__u FullArgSpecu __defaults__u __kwdefaults__u __annotations__( u funcu argsu varargsu kwonlyargsu varkw( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getfullargspecA s u getfullargspecu ArgInfou args varargs keywords localsc C s. t | j � \ } } } t | | | | j � S( u9 Get information about arguments passed into a particular frame. A tuple of four things is returned: (args, varargs, varkw, locals). 'args' is a list of the argument names. 'varargs' and 'varkw' are the names of the * and ** arguments or None. 'locals' is the locals dictionary of the given frame.( u getargsu f_codeu ArgInfou f_locals( u frameu argsu varargsu varkw( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getargvaluesZ s u getargvaluesc C sG t | t � r= | j d | f k r+ | j S| j d | j St | � S( Nu builtinsu .( u isinstanceu typeu __module__u __name__u repr( u annotationu base_module( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu formatannotationd s u formatannotationc s( t | d d � � � f d d � } | S( Nu __module__c s t | � � S( N( u formatannotation( u annotation( u module( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _formatannotationm s u5 formatannotationrelativeto.<locals>._formatannotation( u getattru None( u objectu _formatannotation( ( u moduleu, /opt/alt/python33/lib64/python3.3/inspect.pyu formatannotationrelativetok s u formatannotationrelativetoc C s d | S( Nu *( ( u name( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>t s u <lambda>c C s d | S( Nu **( ( u name( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>u s c C s d t | � S( Nu =( u repr( u value( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>v s c C s d | S( Nu -> ( ( u text( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>w s c s� � � � f d d � } g } | r= t | � t | � } n x` t | � D]R \ } } | | � } | r� | | k r� | | | | | � } n | j | � qJ W| d k r� | j | | | � � � n | r� | j d � n | r:xS | D]H } | | � } | r&| | k r&| | | | � 7} n | j | � q� Wn | d k rb| j | | | � � � n d d j | � d } d � k r�| | � � d � � 7} n | S( u� Format an argument spec from the values returned by getargspec or getfullargspec. The first seven arguments are (args, varargs, varkw, defaults, kwonlyargs, kwonlydefaults, annotations). The other five arguments are the corresponding optional formatting functions that are called to turn names and values into strings. The last argument is an optional function to format the sequence of arguments.c s7 � | � } | � k r3 | d � � | � 7} n | S( Nu : ( ( u argu result( u annotationsu formatannotationu formatarg( u, /opt/alt/python33/lib64/python3.3/inspect.pyu formatargandannotation� s u- formatargspec.<locals>.formatargandannotationu *u (u , u )u returnN( u lenu enumerateu appendu Noneu join( u argsu varargsu varkwu defaultsu kwonlyargsu kwonlydefaultsu annotationsu formatargu formatvarargsu formatvarkwu formatvalueu formatreturnsu formatannotationu formatargandannotationu specsu firstdefaultu iu argu specu kwonlyargu result( ( u annotationsu formatannotationu formatargu, /opt/alt/python33/lib64/python3.3/inspect.pyu formatargspecq s2 u formatargspecc C s d | S( Nu *( ( u name( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>� s c C s d | S( Nu **( ( u name( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>� s c C s d t | � S( Nu =( u repr( u value( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <lambda>� s c C s� | | | d d � } g } x1 t t | � � D] } | j | | | � � q. W| ry | j | | � | | | � � n | r� | j | | � | | | � � n d d j | � d S( uf Format an argument spec from the 4 values returned by getargvalues. The first four arguments are (args, varargs, varkw, locals). The next four arguments are the corresponding optional formatting functions that are called to turn names and values into strings. The ninth argument is an optional function to format the sequence of arguments.c S s | | � | | | � S( N( ( u nameu localsu formatargu formatvalue( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu convert� s u formatargvalues.<locals>.convertu (u , u )( u rangeu lenu appendu join( u argsu varargsu varkwu localsu formatargu formatvarargsu formatvarkwu formatvalueu convertu specsu i( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu formatargvalues� s $$u formatargvaluesc s� � f d d � | D� } t | � } | d k r> | d } nW | d k r\ d j | � } n9 d j | d d � � } | d d � =d j | � | } t d | | | r� d n d | d k r� d n d | f � � d S( Nc s( g | ] } | � k r t | � � q S( ( u repr( u .0u name( u values( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <listcomp>� s u& _missing_arguments.<locals>.<listcomp>i i i u {} and {}u , {} and {}u , u* %s() missing %i required %s argument%s: %su positionalu keyword-onlyu u si����i����( u lenu formatu joinu TypeError( u f_nameu argnamesu posu valuesu namesu missingu su tail( ( u valuesu, /opt/alt/python33/lib64/python3.3/inspect.pyu _missing_arguments� s u _missing_argumentsc s1 t | � | } t � f d d � | D� � } | rQ | d k } d | f } nI | rv d } d | t | � f } n$ t | � d k } t t | � � } d } | r� d } | | d k r� d n d | | d k r� d n d f } n t d | | | r� d n d | | | d k r | r d n d f � � d S( Nc s" g | ] } | � k r | � q S( ( ( u .0u arg( u values( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <listcomp>� s u _too_many.<locals>.<listcomp>i u at least %du from %d to %du u7 positional argument%s (and %d keyword-only argument%s)u su5 %s() takes %s positional argument%s but %d%s %s givenu wasu wereT( u lenu Trueu stru TypeError( u f_nameu argsu kwonlyu varargsu defcountu givenu valuesu atleastu kwonly_givenu pluralu sigu kwonly_sigu msg( ( u valuesu, /opt/alt/python33/lib64/python3.3/inspect.pyu _too_many� s$ u _too_manyc O s� | d } | d d � } t | � } | \ } } } } } } } | j } i } t | � r~ | j d k r~ | j f | } n t | � } t | � } | r� t | � n d } t | | � } x& t | � D] } | | | | | <q� W| r t | | d � � | | <n t | | � } | r,i | | <n x� | j � D]z \ } } | | k r�| spt d | | f � � n | | | | <q9n | | k r�t d | | f � � n | | | <q9W| | k r�| r�t | | | | | | | � n | | k r�| d | | � } x0 | D]( } | | k rt | | d | � qqWxH t | | | d � � D]) \ } } | | k rW| | | | <qWqWWn d } xD | D]< } | | k r�| | k r�| | | | <q�| d 7} q�q�W| r�t | | d | � n | S( u� Get the mapping of arguments to values. A dict is returned, with keys the function argument names (including the names of the * and ** arguments, if any), and values the respective bound values from 'positional' and 'named'.i i Nu* %s() got an unexpected keyword argument %ru( %s() got multiple values for argument %rTF( u getfullargspecu __name__u ismethodu __self__u Noneu lenu minu rangeu tupleu setu itemsu TypeErroru _too_manyu _missing_argumentsu Trueu enumerateu False( u func_and_positionalu namedu funcu positionalu specu argsu varargsu varkwu defaultsu kwonlyargsu kwonlydefaultsu annu f_nameu arg2valueu num_posu num_argsu num_defaultsu nu iu possible_kwargsu kwu valueu requ argu missingu kwarg( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getcallargs� sd ' u getcallargsu ClosureVarsu" nonlocals globals builtins unboundc C s^ t | � r | j } n t | � s< t d j | � � � n | j } | j d k r] i } n" d d � t | j | j � D� } | j } | j d t j � } t | � r� | j } n i } i } t � } x~ | j D]s } | d k r� q� n y | | | | <Wq� t k rFy | | | | <Wn t k rA| j | � Yn XYq� Xq� Wt | | | | � S( u Get the mapping of free variables to their current values. Returns a named tuple of dicts mapping the current nonlocal, global and builtin references as seen by the body of the function. A final set of unbound names that could not be resolved is also provided. u '{!r}' is not a Python functionc S s" i | ] \ } } | j | � q S( ( u cell_contents( u .0u varu cell( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <dictcomp>2 s u" getclosurevars.<locals>.<dictcomp>u __builtins__u Noneu Trueu FalseN( u Noneu Trueu False( u ismethodu __func__u isfunctionu TypeErroru formatu __code__u __closure__u Noneu zipu co_freevarsu __globals__u getu builtinsu __dict__u ismoduleu setu co_namesu KeyErroru addu ClosureVars( u funcu codeu nonlocal_varsu global_nsu builtin_nsu global_varsu builtin_varsu unbound_namesu name( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getclosurevars s8 u getclosurevarsu Tracebacku+ filename lineno function code_context indexc C s5 t | � r! | j } | j } n | j } t | � sN t d j | � � � n t | � pc t | � } | d k r| d | d } y t | � \ } } Wn t k r� d } } YqXt | d � } t d t | t | � | � � } | | | | � } | d | } n d } } t | | | j j | | � S( u� Get information about a frame or traceback object. A tuple of five things is returned: the filename, the line number of the current line, the function name, a list of lines of context from the source code, and the index of the current line within that list. The optional second argument specifies the number of lines of context to return, which are centered around the current line.u' {!r} is not a frame or traceback objecti i i N( u istracebacku tb_linenou tb_frameu f_linenou isframeu TypeErroru formatu getsourcefileu getfileu findsourceu IOErroru Noneu maxu minu lenu Tracebacku f_codeu co_name( u frameu contextu linenou filenameu startu linesu lnumu index( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getframeinfoS s& " u getframeinfoc C s | j S( uC Get the line number from a frame object, allowing for optimization.( u f_lineno( u frame( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getlinenot s u getlinenoc C s= g } x0 | r8 | j | f t | | � � | j } q W| S( u� Get a list of records for a frame and all higher (calling) frames. Each record contains a frame object, filename, line number, function name, a list of lines of context, and index within the context.( u appendu getframeinfou f_back( u frameu contextu framelist( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getouterframesy s u getouterframesc C s@ g } x3 | r; | j | j f t | | � � | j } q W| S( u� Get a list of records for a traceback's frame and all lower frames. Each record contains a frame object, filename, line number, function name, a list of lines of context, and index within the context.( u appendu tb_frameu getframeinfou tb_next( u tbu contextu framelist( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getinnerframes� s u getinnerframesc C s t t d � r t j d � Sd S( u? Return the frame of the caller or None if this is not possible.u _getframei N( u hasattru sysu _getframeu None( ( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu currentframe� s u currentframec C s t t j d � | � S( u@ Return a list of records for the stack above the caller's frame.i ( u getouterframesu sysu _getframe( u context( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu stack� s u stackc C s t t j � d | � S( uC Return a list of records for the stack below the current exception.i ( u getinnerframesu sysu exc_info( u context( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu trace� s u tracec C s t j d j | � S( Nu __mro__( u typeu __dict__u __get__( u klass( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _static_getmro� s u _static_getmroc C sD i } y t j | d � } Wn t k r0 Yn Xt j | | t � S( Nu __dict__( u objectu __getattribute__u AttributeErroru dictu getu _sentinel( u obju attru instance_dict( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _check_instance� s u _check_instancec C sZ xS t | � D]E } t t | � � t k r y | j | SWqR t k rN YqR Xq q Wt S( N( u _static_getmrou _shadowed_dictu typeu _sentinelu __dict__u KeyError( u klassu attru entry( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _check_class� s u _check_classc C s+ y t | � Wn t k r& d SYn Xd S( NFT( u _static_getmrou TypeErroru Falseu True( u obj( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _is_type� s u _is_typec C s� t j d } xw t | � D]i } y | j | � d } Wn t k rK Yq Xt | � t j k o| | j d k o| | j | k s | Sq Wt S( Nu __dict__( u typeu __dict__u _static_getmrou __get__u KeyErroru typesu GetSetDescriptorTypeu __name__u __objclass__u _sentinel( u klassu dict_attru entryu class_dict( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _shadowed_dict� s u _shadowed_dictc C su t } t | � s` t | � } t | � } | t k sK t | � t j k rf t | | � } qf n | } t | | � } | t k r� | t k r� t t | � d � t k r� t t | � d � t k r� | Sn | t k r� | S| t k r� | S| | k rUx\ t t | � � D]E } t t | � � t k r y | j | SWqNt k rJYqNXq q Wn | t k re| St | � � d S( u� Retrieve attributes without triggering dynamic lookup via the descriptor protocol, __getattr__ or __getattribute__. Note: this function may not be able to retrieve all attributes that getattr can fetch (like dynamically created attributes) and may find attributes that getattr can't (like descriptors that raise AttributeError). It can also return descriptor objects instead of instance members in some cases. See the documentation for details. u __get__u __set__N( u _sentinelu _is_typeu typeu _shadowed_dictu typesu MemberDescriptorTypeu _check_instanceu _check_classu _static_getmrou __dict__u KeyErroru AttributeError( u obju attru defaultu instance_resultu klassu dict_attru klass_resultu entry( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getattr_static� s6 u getattr_staticu GEN_CREATEDu GEN_RUNNINGu GEN_SUSPENDEDu GEN_CLOSEDc C s: | j r t S| j d k r t S| j j d k r6 t St S( u# Get current state of a generator-iterator. Possible states are: GEN_CREATED: Waiting to start execution. GEN_RUNNING: Currently being executed by the interpreter. GEN_SUSPENDED: Currently suspended at a yield expression. GEN_CLOSED: Execution has completed. i Ni����( u gi_runningu GEN_RUNNINGu gi_frameu Noneu GEN_CLOSEDu f_lastiu GEN_CREATEDu GEN_SUSPENDED( u generator( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getgeneratorstate� s u getgeneratorstatec C sT t | � s$ t d j | � � � n t | d d � } | d k rL | j j Si Sd S( u� Get the mapping of generator local variables to their current values. A dict is returned, with the keys the local variable names and values the bound values.u '{!r}' is not a Python generatoru gi_frameN( u isgeneratoru TypeErroru formatu getattru Noneu gi_frameu f_locals( u generatoru frame( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu getgeneratorlocals s u getgeneratorlocalsc C sC y t | | � } Wn t k r+ d SYn Xt | t � s? | Sd S( N( u getattru AttributeErroru isinstanceu _NonUserDefinedCallables( u clsu method_nameu meth( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _get_user_defined_method. s u _get_user_defined_methodc & C s� t | � s$ t d j | � � � n t | t j � rn t | j � } | j d t | j j � � d d � � Sy | j } Wn t k r� Yn X| d k r� | Sy | j } Wn t k r� Yn Xt | � St | t j � r� t j | � St | t j � r5t | j � } t | j j � � } | j p-f } | j p<i } y | j | | � } WnC t k r�} z# d j | � } t | � | � WYd d } ~ Xn Xx� | j j � D]p \ } } | | } | | k r�| j d | d d � | | <q�| j t t f k r�| j! r�| j" | � q�q�W| j d | j � � Sd } t | t# � r�t$ t# | � d � } | d k rzt | � } qt$ | d � } | d k r�t | � } qt$ | d � } | d k rt | � } qnB t | t% � st$ t# | � d � } | d k rt | � } qn | d k rH| j d t | j j � � d d � � St | t j& � rxd j | � } t | � � n t d j | � � � d S( u/ Get a signature object for the passed callable.u {!r} is not a callable objectu parametersi Nu+ partial object {!r} has incorrect argumentsu defaultu _partial_kwargu __call__u __new__u __init__u, no signature found for builtin function {!r}u+ callable {!r} is not supported by signatureT(' u callableu TypeErroru formatu isinstanceu typesu MethodTypeu signatureu __func__u replaceu tupleu parametersu valuesu __signature__u AttributeErroru Noneu __wrapped__u FunctionTypeu Signatureu from_functionu functoolsu partialu funcu OrderedDictu itemsu argsu keywordsu bind_partialu ValueErroru argumentsu Trueu kindu _VAR_KEYWORDu _VAR_POSITIONALu _partial_kwargu popu typeu _get_user_defined_methodu _NonUserDefinedCallablesu BuiltinFunctionType( u obju sigu wrappedu new_paramsu partial_argsu partial_keywordsu bau exu msgu arg_nameu arg_valueu paramu callu newu init( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu signature: st ) " )u signaturec B s | Ee Z d Z d Z d S( u _voidu0 A private marker - used in Parameter & SignatureN( u __name__u __module__u __qualname__u __doc__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _void� s u _voidc B s | Ee Z d Z d S( u _emptyN( u __name__u __module__u __qualname__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _empty� s u _emptyc B s8 | Ee Z d Z d d � Z d d � Z d d � Z d S( u _ParameterKindc G s t j | | � } | | _ | S( N( u intu __new__u _name( u selfu nameu argsu obj( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __new__� s u _ParameterKind.__new__c C s | j S( N( u _name( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __str__� s u _ParameterKind.__str__c C s d j | j � S( Nu <_ParameterKind: {!r}>( u formatu _name( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __repr__� s u _ParameterKind.__repr__N( u __name__u __module__u __qualname__u __new__u __str__u __repr__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _ParameterKind� s u _ParameterKindu nameu POSITIONAL_ONLYu POSITIONAL_OR_KEYWORDu VAR_POSITIONALi u KEYWORD_ONLYu VAR_KEYWORDc B s | Ee Z d Z d Z d Z e Z e Z e Z e Z e Z e Z d e d e d d! d d � Z e d d � � Z e d d � � Z e d d � � Z e d d � � Z d e d e d e d e d e d d � Z d d � Z d d � Z d d � Z d d � Z d S(" u Parameteru� Represents a parameter in a function signature. Has the following public attributes: * name : str The name of the parameter as a string. * default : object The default value for the parameter if specified. If the parameter has no default value, this attribute is not set. * annotation The annotation for the parameter if specified. If the parameter has no annotation, this attribute is not set. * kind : str Describes how argument values are bound to the parameter. Possible values: `Parameter.POSITIONAL_ONLY`, `Parameter.POSITIONAL_OR_KEYWORD`, `Parameter.VAR_POSITIONAL`, `Parameter.KEYWORD_ONLY`, `Parameter.VAR_KEYWORD`. u _nameu _kindu _defaultu _annotationu _partial_kwargu defaultu annotationc C s | t t t t t f k r* t d � � n | | _ | t k rr | t t f k rr d j | � } t | � � qr n | | _ | | _ | d k r� | t k r� t d � � n | | _ nL t | � } | t k r� | j � r� d j | � } t | � � n | | _ | | _ d S( Nu, invalid value for 'Parameter.kind' attributeu( {} parameters cannot have default valuesu< None is not a valid name for a non-positional-only parameteru" {!r} is not a valid parameter name( u _POSITIONAL_ONLYu _POSITIONAL_OR_KEYWORDu _VAR_POSITIONALu _KEYWORD_ONLYu _VAR_KEYWORDu ValueErroru _kindu _emptyu formatu _defaultu _annotationu Noneu _nameu stru isidentifieru _partial_kwarg( u selfu nameu kindu defaultu annotationu _partial_kwargu msg( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __init__� s( u Parameter.__init__c C s | j S( N( u _name( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu name s u Parameter.namec C s | j S( N( u _default( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu default s u Parameter.defaultc C s | j S( N( u _annotation( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu annotation s u Parameter.annotationc C s | j S( N( u _kind( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu kind s u Parameter.kindu nameu kindc C s� | t k r | j } n | t k r0 | j } n | t k rH | j } n | t k r` | j } n | t k rx | j } n t | � | | d | d | d | �S( u+ Creates a customized copy of the Parameter.u defaultu annotationu _partial_kwarg( u _voidu _nameu _kindu _annotationu _defaultu _partial_kwargu type( u selfu nameu kindu annotationu defaultu _partial_kwarg( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu replace s u Parameter.replacec C s� | j } | j } | t k rE | d k r3 d } n d j | � } n | j t k rr d j | t | j � � } n | j t k r� d j | t | j � � } n | t k r� d | } n | t k r� d | } n | S( Nu u <{}>u {}:{}u {}={}u *u **( u kindu _nameu _POSITIONAL_ONLYu Noneu formatu _annotationu _emptyu formatannotationu _defaultu repru _VAR_POSITIONALu _VAR_KEYWORD( u selfu kindu formatted( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __str__) s u Parameter.__str__c C s" d j | j j t | � | j � S( Nu <{} at {:#x} {!r}>( u formatu __class__u __name__u idu name( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __repr__A s u Parameter.__repr__c C sX t | j t � oW | j | j k oW | j | j k oW | j | j k oW | j | j k S( N( u issubclassu __class__u Parameteru _nameu _kindu _defaultu _annotation( u selfu other( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __eq__E s u Parameter.__eq__c C s | j | � S( N( u __eq__( u selfu other( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __ne__L s u Parameter.__ne__N( u _nameu _kindu _defaultu _annotationu _partial_kwargF( u __name__u __module__u __qualname__u __doc__u __slots__u _POSITIONAL_ONLYu POSITIONAL_ONLYu _POSITIONAL_OR_KEYWORDu POSITIONAL_OR_KEYWORDu _VAR_POSITIONALu VAR_POSITIONALu _KEYWORD_ONLYu KEYWORD_ONLYu _VAR_KEYWORDu VAR_KEYWORDu _emptyu emptyu Falseu __init__u propertyu nameu defaultu annotationu kindu _voidu replaceu __str__u __repr__u __eq__u __ne__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu Parameter� s( u Parameterc B st | Ee Z d Z d Z d d � Z e d d � � Z e d d � � Z e d d � � Z d d � Z d d � Z d S( u BoundArgumentsu Result of `Signature.bind` call. Holds the mapping of arguments to the function's parameters. Has the following public attributes: * arguments : OrderedDict An ordered mutable mapping of parameters' names to arguments' values. Does not contain arguments' default values. * signature : Signature The Signature object that created this instance. * args : tuple Tuple of positional arguments values. * kwargs : dict Dict of keyword arguments values. c C s | | _ | | _ d S( N( u argumentsu _signature( u selfu signatureu arguments( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __init__a s u BoundArguments.__init__c C s | j S( N( u _signature( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu signaturee s u BoundArguments.signaturec C s� g } x� | j j j � D]� \ } } | j t t f k sC | j rG Pn y | j | } Wn t k rm PYq X| j t k r� | j | � q | j | � q Wt | � S( N( u _signatureu parametersu itemsu kindu _VAR_KEYWORDu _KEYWORD_ONLYu _partial_kwargu argumentsu KeyErroru _VAR_POSITIONALu extendu appendu tuple( u selfu argsu param_nameu paramu arg( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu argsi s u BoundArguments.argsc C s� i } d } x� | j j j � D]� \ } } | sv | j t t f k sO | j rX d } qv | | j k rv d } q qv n | s� q n y | j | } Wn t k r� Yq X| j t k r� | j | � q | | | <q W| S( NFT( u Falseu _signatureu parametersu itemsu kindu _VAR_KEYWORDu _KEYWORD_ONLYu _partial_kwargu Trueu argumentsu KeyErroru update( u selfu kwargsu kwargs_startedu param_nameu paramu arg( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu kwargs� s( u BoundArguments.kwargsc C s4 t | j t � o3 | j | j k o3 | j | j k S( N( u issubclassu __class__u BoundArgumentsu signatureu arguments( u selfu other( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __eq__� s u BoundArguments.__eq__c C s | j | � S( N( u __eq__( u selfu other( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __ne__� s u BoundArguments.__ne__N( u __name__u __module__u __qualname__u __doc__u __init__u propertyu signatureu argsu kwargsu __eq__u __ne__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu BoundArgumentsP s u BoundArgumentsc B s� | Ee Z d Z d Z d Z e Z e Z e Z d e d d d d d �Z e d d � � Z e d d � � Z e d d � � Z d e d e d d � Z d d � Z d d � Z d d! d d � Z d d � Z d d � Z d d � Z d S(" u Signatureu A Signature object represents the overall signature of a function. It stores a Parameter object for each parameter accepted by the function, as well as information specific to the function itself. A Signature object has the following public attributes and methods: * parameters : OrderedDict An ordered mapping of parameters' names to the corresponding Parameter objects (keyword-only arguments are in the same order as listed in `code.co_varnames`). * return_annotation : object The annotation for the return type of the function if specified. If the function has no annotation for its return type, this attribute is not set. * bind(*args, **kwargs) -> BoundArguments Creates a mapping from positional and keyword arguments to parameters. * bind_partial(*args, **kwargs) -> BoundArguments Creates a partial mapping from positional and keyword arguments to parameters (simulating 'functools.partial' behavior.) u _return_annotationu _parametersu return_annotationu __validate_parameters__c C s4 | d k r t � } n� | r� t � } t } x� t | � D]� \ } } | j } | | k r� d } | j | | j � } t | � � n | } | j } | d k r� t | � } | j d | � } n | | k r� d j | � } t | � � n | | | <q: Wn t d d � | D� � } t j | � | _ | | _ d S( u� Constructs Signature from the given list of Parameter objects and 'return_annotation'. All arguments are optional. u# wrong parameter order: {} before {}u nameu duplicate parameter name: {!r}c s s | ] } | j | f Vq d S( N( u name( u .0u param( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <genexpr>� s u% Signature.__init__.<locals>.<genexpr>N( u Noneu OrderedDictu _POSITIONAL_ONLYu enumerateu kindu formatu ValueErroru nameu stru replaceu typesu MappingProxyTypeu _parametersu _return_annotation( u selfu parametersu return_annotationu __validate_parameters__u paramsu top_kindu idxu paramu kindu msgu name( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __init__� s0 u Signature.__init__c C s� t | t j � s* t d j | � � � n | j } | j } | j } | j } t | d | � � } | j } | | | | � } | j } | j } | j } | r� t | � } n d } g } | | } xI | d | � D]7 } | j | t � } | j | | d | d t �� q� Wx_ t | | d � � D]G \ } } | j | t � } | j | | d | d t d | | �� q*W| j d @r�| | | } | j | t � } | j | | d | d t �� n xl | D]d } t } | d k r�| j | t � } n | j | t � } | j | | d | d t d | �� q�W| j d @r�| | } | j d @rd| d 7} n | | } | j | t � } | j | | d | d t �� n | | d | j d t � d d �S( u2 Constructs Signature for the given python functionu {!r} is not a Python functionNi u annotationu kindu defaulti i i u return_annotationu returnu __validate_parameters__F( u isinstanceu typesu FunctionTypeu TypeErroru formatu _parameter_clsu __code__u co_argcountu co_varnamesu tupleu co_kwonlyargcountu __annotations__u __defaults__u __kwdefaults__u lenu getu _emptyu appendu _POSITIONAL_OR_KEYWORDu enumerateu co_flagsu _VAR_POSITIONALu Noneu _KEYWORD_ONLYu _VAR_KEYWORDu False( u clsu funcu Parameteru func_codeu pos_countu arg_namesu positionalu keyword_only_countu keyword_onlyu annotationsu defaultsu kwdefaultsu pos_default_countu parametersu non_default_countu nameu annotationu offsetu defaultu index( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu from_function� sd # u Signature.from_functionc C s | j S( N( u _parameters( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu parameters: s u Signature.parametersc C s | j S( N( u _return_annotation( u self( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu return_annotation> s u Signature.return_annotationu parametersc C sL | t k r | j j � } n | t k r6 | j } n t | � | d | �S( u� Creates a customized copy of the Signature. Pass 'parameters' and/or 'return_annotation' arguments to override them in the new copy. u return_annotation( u _voidu parametersu valuesu _return_annotationu type( u selfu parametersu return_annotation( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu replaceB s u Signature.replacec C s2 t t | � t � sF | j | j k sF t | j � t | j � k rJ d Sd d � t | j j � � D� } x� t | j j � � D]� \ } \ } } | j t k r� y | j | } Wn t k r� d SYq*X| | k r*d Sq� y | | } Wn t k rd SYq� X| | k s&| | j | k r� d Sq� Wd S( Nc S s i | ] \ } } | | � q S( ( ( u .0u idxu param( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <dictcomp>W s u$ Signature.__eq__.<locals>.<dictcomp>FT( u issubclassu typeu Signatureu return_annotationu lenu parametersu Falseu enumerateu keysu itemsu kindu _KEYWORD_ONLYu KeyErroru True( u selfu otheru other_positionsu idxu param_nameu paramu other_paramu other_idx( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __eq__Q s, ( u Signature.__eq__c C s | j | � S( N( u __eq__( u selfu other( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __ne__o s u Signature.__ne__u partialc C s� t � } t | j j � � } f } t | � } | r~ xE | j j � D]1 \ } } | j rF | | k rF | j | | <qF qF Wn x�y t | � } Wn t k r�y t | � } Wn t k r� PYn� X| j t k r� Pn� | j | k r2| j t k r%d } | j d | j � } t | � d � n | f } Pnh | j t k sP| j t k r]| f } Pn= | rp| f } Pn* d } | j d | j � } t | � d � Yq� Xy t | � } Wn! t k r�t d � d � Yq� X| j t t f k r�t d � � n | j t k r3| g } | j | � t | � | | j <Pn | j | k r`t d j d | j � � � n | | | j <q� d } x� t j | | � D]� } | j t k r�t d j d | j � � � n | j t k r�| } q�n | j } y | j | � } WnU t k rJ| rF| j t k rF| j t k rFt d j d | � � d � n Yq�X| | | <q�W| r�| d k r{| | | j <q�t d � � n | j | | � S( u$ Private method. Don't use directly.uA {arg!r} parameter is positional only, but was passed as a keywordu argu' {arg!r} parameter lacking default valueu too many positional argumentsu$ multiple values for argument {arg!r}u too many keyword argumentsN( u OrderedDictu iteru parametersu valuesu itemsu _partial_kwargu defaultu nextu StopIterationu kindu _VAR_POSITIONALu nameu _POSITIONAL_ONLYu formatu TypeErroru Noneu _VAR_KEYWORDu _emptyu _KEYWORD_ONLYu extendu tupleu itertoolsu chainu popu KeyErroru _bound_arguments_cls( u selfu argsu kwargsu partialu argumentsu parametersu parameters_exu arg_valsu param_nameu paramu arg_valu msgu valuesu kwargs_param( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu _bindr s� u Signature._bindc O s | j | | � S( u� Get a BoundArguments object, that maps the passed `args` and `kwargs` to the function's signature. Raises `TypeError` if the passed arguments can not be bound. ( u _bind( u _Signature__bind_selfu argsu kwargs( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu bind� s u Signature.bindc O s | j | | d d �S( u� Get a BoundArguments object, that partially maps the passed `args` and `kwargs` to the function's signature. Raises `TypeError` if the passed arguments can not be bound. u partialT( u _bindu True( u _Signature__bind_selfu argsu kwargs( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu bind_partial� s u Signature.bind_partialc C s� g } d } x� t | j j � � D]k \ } } t | � } | j } | t k rX d } n( | t k r� | r� | j d � d } n | j | � q" Wd j d j | � � } | j t k r� t | j � } | d j | � 7} n | S( Nu *u ({})u , u -> {}TF( u Trueu enumerateu parametersu valuesu stru kindu _VAR_POSITIONALu Falseu _KEYWORD_ONLYu appendu formatu joinu return_annotationu _emptyu formatannotation( u selfu resultu render_kw_only_separatoru idxu paramu formattedu kindu renderedu anno( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu __str__ s " u Signature.__str__N( u _return_annotationu _parametersTF( u __name__u __module__u __qualname__u __doc__u __slots__u Parameteru _parameter_clsu BoundArgumentsu _bound_arguments_clsu _emptyu emptyu Trueu Noneu __init__u classmethodu from_functionu propertyu parametersu return_annotationu _voidu replaceu __eq__u __ne__u Falseu _bindu bindu bind_partialu __str__( u __locals__( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu Signature� s" %I � u Signature( u Ka-Ping Yee <ping@lfw.org>u' Yury Selivanov <yselivanov@sprymix.com>( i i ( i i ( i i i@ i F(� u __doc__u __author__u impu importlib.machineryu importlibu itertoolsu linecacheu osu reu sysu tokenizeu typesu warningsu functoolsu builtinsu operatoru attrgetteru collectionsu namedtupleu OrderedDictu disu COMPILER_FLAG_NAMESu _flag_namesu ImportErroru CO_OPTIMIZEDu CO_NEWLOCALSu CO_VARARGSu CO_VARKEYWORDSu CO_NESTEDu CO_GENERATORu CO_NOFREEu globalsu mod_dictu itemsu ku vu TPFLAGS_IS_ABSTRACTu ismoduleu isclassu ismethodu ismethoddescriptoru isdatadescriptoru hasattru ismemberdescriptoru isgetsetdescriptoru isfunctionu isgeneratorfunctionu isgeneratoru istracebacku isframeu iscodeu isbuiltinu isroutineu isabstractu Noneu getmembersu Attributeu classify_class_attrsu getmrou indentsizeu getdocu cleandocu getfileu ModuleInfou getmoduleinfou getmodulenameu getsourcefileu getabsfileu modulesbyfileu _filesbymodnameu getmoduleu findsourceu getcommentsu Exceptionu EndOfBlocku BlockFinderu getblocku getsourcelinesu getsourceu walktreeu Falseu getclasstreeu Argumentsu getargsu _getfullargsu ArgSpecu getargspecu FullArgSpecu getfullargspecu ArgInfou getargvaluesu formatannotationu formatannotationrelativetou stru formatargspecu formatargvaluesu _missing_argumentsu _too_manyu getcallargsu ClosureVarsu getclosurevarsu Tracebacku getframeinfou getlinenou getouterframesu getinnerframesu currentframeu stacku traceu objectu _sentinelu _static_getmrou _check_instanceu _check_classu _is_typeu _shadowed_dictu getattr_staticu GEN_CREATEDu GEN_RUNNINGu GEN_SUSPENDEDu GEN_CLOSEDu getgeneratorstateu getgeneratorlocalsu typeu __call__u _WrapperDescriptoru allu _MethodWrapperu BuiltinFunctionTypeu _NonUserDefinedCallablesu _get_user_defined_methodu signatureu _voidu _emptyu intu _ParameterKindu _POSITIONAL_ONLYu _POSITIONAL_OR_KEYWORDu _VAR_POSITIONALu _KEYWORD_ONLYu _VAR_KEYWORDu Parameteru BoundArgumentsu Signature( ( ( u, /opt/alt/python33/lib64/python3.3/inspect.pyu <module> s F . C -' ) > 5! 0 r �]
Save File
Cancel