ó Þ.Wc@`sÜdZddlmZmZmZddlZddlZddlZddlZyddl m Z Wn!e k r‰ddl m Z nXddl mZdddd gZeejƒZeejƒZeeejfZdd „Zd „Zd „Zd efd„ƒYZdefd„ƒYZdefd„ƒYZedddƒZ edddƒZ!edddƒZ"edddƒZ#edddƒZ$defd„ƒYZ%defd„ƒYZ&defd„ƒYZ'dS( s¯Function signature objects for callables Back port of Python 3.3's function signature tools from the inspect module, modified to be compatible with Python 2.6, 2.7 and 3.3+. i(tabsolute_importtdivisiontprint_functionN(t OrderedDict(t __version__tBoundArgumentst Parametert Signaturet signaturecC`sJt|tƒr@|jdd|fkr.|jS|jd|jSt|ƒS(Ntbuiltinst __builtin__t.(t isinstancettypet __module__t__name__trepr(t annotationt base_module((s0lib/python2.7/site-packages/funcsigs/__init__.pytformatannotations cG`sryF|tkrdSt||ƒ}x |D]}t|||ƒ}q)WWntk rZdSXt|tƒsn|SdS(N(R tgetattrtAttributeErrorR t_NonUserDefinedCallables(tclst method_nametnestedtmethtname((s0lib/python2.7/site-packages/funcsigs/__init__.pyt_get_user_defined_method's   cC`sÿt|ƒs$tdj|ƒƒ‚nt|tjƒröt|jƒ}|jdkrX|St |j j ƒƒ}| s|dj ttfkrœtdƒ‚n|dj }|ttfkrÈ|d}n|tk rãtdƒ‚n|jd|ƒSny |j}Wntk rnX|dk r'|Sy |j}Wntk rGn Xt|ƒSt|tjƒrqtj|ƒSt|tjƒr¦t|jƒ}t|j jƒƒ}|j p³d}|j!pÂi}y|j"||Ž}Wn.tk r } dj|ƒ} t| ƒ‚nXx|j#jƒD]p\} } || } | |kr]| jd| d t$ƒ|| tkwargsRE((s0lib/python2.7/site-packages/funcsigs/__init__.pyR!Çs cC`s|jS(N(RZ(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyt__str__ÌscC`sdj|jƒS(Ns<_ParameterKind: {0!r}>(R&RZ(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyt__repr__Ïs(RRR!R]R^(((s0lib/python2.7/site-packages/funcsigs/__init__.pyRXÆs  RtPOSITIONAL_ONLYitPOSITIONAL_OR_KEYWORDitVAR_POSITIONALit KEYWORD_ONLYit VAR_KEYWORDcB`sËeZdZdZeZeZeZ e Z e Z eZeeed„Zed„ƒZed„ƒZed „ƒZed „ƒZeeeeed „Zd „Zd „Zd„Zd„Zd„ZRS(sÖ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`. RZt_kindt_defaultt _annotationRcC`s|tttttfkr*tdƒ‚n||_|tk rr|ttfkrrdj|ƒ}t|ƒ‚qrn||_ ||_ |dkr·|tkr«tdƒ‚n||_ nXt |ƒ}|tkrtjd|tjƒ rdj|ƒ}t|ƒ‚n||_ ||_dS(Ns,invalid value for 'Parameter.kind' attributes){0} parameters cannot have default valuess<None is not a valid name for a non-positional-only parameters [a-z_]\w*$s#{0!r} is not a valid parameter name(R3R2R4R0R/R1RdRWR&ReRfR+RZtstrtretmatchtIR(R[RR.RRRRN((s0lib/python2.7/site-packages/funcsigs/__init__.pyR"øs(         % cC`s|jS(N(RZ(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyRscC`s|jS(N(Re(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyRscC`s|jS(N(Rf(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyRscC`s|jS(N(Rd(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyR.!sc C`s|tkr|j}n|tkr0|j}n|tkrH|j}n|tkr`|j}n|tkrx|j}nt|ƒ||d|d|d|ƒS(s+Creates a customized copy of the Parameter.RRR(RURZRdRfReRR (R[RR.RRR((s0lib/python2.7/site-packages/funcsigs/__init__.pyR5%s          cC`sÕ|j}|j}|tkrE|dkr3d}ndj|ƒ}n|jtk rrdj|t|jƒƒ}n|jtk rŸdj|t |jƒƒ}n|t kr¸d|}n|t krÑd|}n|S(Nts<{0}>s{0}:{1}s{0}={1}t*s**( R.RZR3R+R&RfRWRReRR4R/(R[R.t formatted((s0lib/python2.7/site-packages/funcsigs/__init__.pyR];s           cC`s"dj|jjt|ƒ|jƒS(Ns<{0} at {1:#x} {2!r}>(R&t __class__RtidR(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyR^SscC`s%dj|jjƒ}t|ƒ‚dS(Nsunhashable type: '{0}'(R&RnRR%(R[RN((s0lib/python2.7/site-packages/funcsigs/__init__.pyt__hash__WscC`sXt|jtƒoW|j|jkoW|j|jkoW|j|jkoW|j|jkS(N(t issubclassRnRRZRdReRf(R[tother((s0lib/python2.7/site-packages/funcsigs/__init__.pyt__eq__[s cC`s|j|ƒ S(N(Rs(R[Rr((s0lib/python2.7/site-packages/funcsigs/__init__.pyt__ne__bs(RZRdReRfR(RRRVt __slots__R3R_R2R`R4RaR0RbR/RcRWtemptytFalseR"tpropertyRRRR.RUR5R]R^RpRsRt(((s0lib/python2.7/site-packages/funcsigs/__init__.pyRÚs*      cB`s_eZdZd„Zed„ƒZed„ƒZed„ƒZd„Zd„Z d„Z RS(sResult 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. cC`s||_||_dS(N(RAt _signature(R[RRA((s0lib/python2.7/site-packages/funcsigs/__init__.pyR"ws cC`s|jS(N(Ry(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyR{scC`s§g}x”|jjjƒD]€\}}|jttfksC|jrGPny|j|}Wntk rlPqX|jt krŒ|j |ƒq|j |ƒqWt |ƒS(N( RyRR=R.R/R0RRAtKeyErrorR4textendtappendR,(R[R>t param_nameRQtarg((s0lib/python2.7/site-packages/funcsigs/__init__.pyR>s  cC`sØi}t}xÅ|jjjƒD]±\}}|sv|jttfksO|jrXt}qv||j krvt}qqvn|s‚qny|j |}Wnt k r¦qX|jtkrÆ|j |ƒq|||R\RpRsRt(((s0lib/python2.7/site-packages/funcsigs/__init__.pyRfs   cB`s¶eZdZdZeZeZeZ dee d„Z e d„ƒZed„ƒZed„ƒZeed„Zd„Zd „Zd „Zed „Zd „Zd „Zd„ZRS(sA 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.) t_return_annotationt _parametersc C`s(|dkrtƒ}nú|rütƒ}t}xât|ƒD]»\}}|j}||kr…d} | j||jƒ} t| ƒ‚n|}|j} | dkrÁt|ƒ} |j d| ƒ}n| |krëdj| ƒ} t| ƒ‚n||| sN( R+RR3t enumerateR.R&R1RRgR5R‚R( R[Rtreturn_annotationt__validate_parameters__RGttop_kindtidxRQR.RNR((s0lib/python2.7/site-packages/funcsigs/__init__.pyR"ås0            c C`sÊt|tjƒs*tdj|ƒƒ‚n|j}|j}|j}|j}t || ƒ}t |ddƒ}||||!}t |diƒ} |j } t |ddƒ} | rÃt | ƒ} nd} g} || }xC|| D]7}| j|tƒ}| j||d|dtƒƒqäWxYt||ƒD]G\}}| j|tƒ}| j||d|dtd| |ƒƒq0W|jd @rÊ|||}| j|tƒ}| j||d|dtƒƒnxl|D]d}t}| dk rþ| j|tƒ}n| j|tƒ}| j||d|dtd|ƒƒqÑW|jd @r¨||}|jd @rj|d 7}n||}| j|tƒ}| j||d|dtƒƒn|| d | jd tƒdtƒS(s2Constructs Signature for the given python functions{0!r} is not a Python functiontco_kwonlyargcountit__annotations__t__kwdefaults__RR.RiiiR…treturnR†N(R R'R8R%R&t_parameter_clst__code__t co_argcountt co_varnamesR,Rt __defaults__R+tlentgetRWR|R2R„tco_flagsR4R0R/Rw(RR<Rt func_codet pos_countt arg_namest positionaltkeyword_only_countt keyword_onlyt annotationstdefaultst kwdefaultstpos_default_countRtnon_default_countRRtoffsetRtindex((s0lib/python2.7/site-packages/funcsigs/__init__.pyR9 sd                 cC`s<ytj|jƒSWn!tk r7t|jjƒƒSXdS(N(R'tMappingProxyTypeR‚RRR=(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyRTs cC`s|jS(N(R(R[((s0lib/python2.7/site-packages/funcsigs/__init__.pyR…[scC`sL|tkr|jjƒ}n|tkr6|j}nt|ƒ|d|ƒS(sCreates a customized copy of the Signature. Pass 'parameters' and/or 'return_annotation' arguments to override them in the new copy. R…(RURR-RR (R[RR…((s0lib/python2.7/site-packages/funcsigs/__init__.pyR5_s    cC`s%dj|jjƒ}t|ƒ‚dS(Nsunhashable type: '{0}'(R&RnRR%(R[RN((s0lib/python2.7/site-packages/funcsigs/__init__.pyRpnscC`s-tt|ƒtƒ sF|j|jksFt|jƒt|jƒkrJtStd„t|jj ƒƒDƒƒ}x·t|jj ƒƒD] \}\}}|j t krßy|j|}Wnt k rËtSX||kr%tSq…y||}Wnt k rtSX||ks!||j|kr…tSq…WtS(Ncs`s!|]\}}||fVqdS(N((RƒRˆRQ((s0lib/python2.7/site-packages/funcsigs/__init__.pys xs(RqR RR…R’RRwtdictR„tkeysR=R.R0RzRB(R[Rrtother_positionsRˆR}RQt other_paramt other_idx((s0lib/python2.7/site-packages/funcsigs/__init__.pyRsrs, (    cC`s|j|ƒ S(N(Rs(R[Rr((s0lib/python2.7/site-packages/funcsigs/__init__.pyRtscC`s•tƒ}t|jjƒƒ}d}t|ƒ}|r~xE|jjƒD]1\}} | jrF||krF| j||R\R;RARt parameters_extarg_valsR}RQtarg_valRNR-t kwargs_param((s0lib/python2.7/site-packages/funcsigs/__init__.pyt_bind“s                 cO`s|dj|d|ƒS(s¹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. ii(R²(R>R\((s0lib/python2.7/site-packages/funcsigs/__init__.pytbindscO`s|j||dtƒS(sÂ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. R;(R²RB(R[R>R\((s0lib/python2.7/site-packages/funcsigs/__init__.pyR@sc C`ság}t}x‚t|jjƒƒD]k\}}t|ƒ}|j}|tkrXt}n(|tkr€|r€|j dƒt}n|j |ƒq"Wdj dj |ƒƒ}|j t k rÝt|j ƒ}|dj |ƒ7}n|S(NRls({0})s, s -> {0}(RBR„RR-RgR.R4RwR0R|R&tjoinR…RWR( R[tresulttrender_kw_only_separatorRˆRQRmR.trenderedtanno((s0lib/python2.7/site-packages/funcsigs/__init__.pyR]!s "      (RR‚N(RRRVRuRRRR­RWRvR+RBR"t classmethodR9RxRR…RUR5RpRsRtRwR²R³R@R](((s0lib/python2.7/site-packages/funcsigs/__init__.pyRÇs$ %I    €  ((RVt __future__RRRR«R:RhR't collectionsRt ImportErrort ordereddicttfuncsigs.versionRt__all__R R t_WrapperDescriptortallt_MethodWrapperRDRR+RRRtobjectRURWRYRXR3R2R4R0R/RRR(((s0lib/python2.7/site-packages/funcsigs/__init__.pyts<         ‡ Œa