ó Ý#´Rc@`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.2+. 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((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pytformatannotations cG`sryF|tkrdSt||ƒ}x |D]}t|||ƒ}q)WWntk rZdSXt|tƒsn|SdS(N(R tgetattrtAttributeErrorR t_NonUserDefinedCallables(tclst method_nametnestedtmethtname((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyt_get_user_defined_method's   cC`sÜt|ƒs$tdj|ƒƒ‚nt|tjƒrÓt|jƒ}|jdkr­|j r¦|j j ƒdj dt ƒ}|j d|ft|j j ƒƒdƒS|SqÓ|j dt|j j ƒƒdƒSny |j}Wntk rónX|dk r|Sy |j}Wntk r$n Xt|ƒSt|tjƒrNtj|ƒSt|tjƒrƒt|jƒ}t|j jƒƒ}|jpd}|jpŸi}y|j||Ž}Wn.tk rè}dj|ƒ} t| ƒ‚nXx|jjƒD]p\} } || } | |kr:| j d| dtƒ|| (R'RX(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyt__repr__Äs(RRR"R[R\(((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRV»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`. RXt_kindt_defaultt _annotationR cC`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(R/t_POSITIONAL_OR_KEYWORDR@t _KEYWORD_ONLYR?R<RbRUR'RcRdR,RXtstrtretmatchtIR (RYRRRRR RL((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR#ís(         % cC`s|jS(N(RX(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR scC`s|jS(N(Rc(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRscC`s|jS(N(Rd(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRscC`s|jS(N(Rb(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRsc 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 (RSRXRbRdRcR R (RYRRRRR ((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR.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**( RRXR/R,R'RdRURRcRR@R?(RYRt formatted((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR[0s           cC`s"dj|jjt|ƒ|jƒS(Ns<{0} at {1:#x} {2!r}>(R't __class__RtidR(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR\HscC`s%dj|jjƒ}t|ƒ‚dS(Nsunhashable type: '{0}'(R'RnRR&(RYRL((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyt__hash__LscC`sXt|jtƒoW|j|jkoW|j|jkoW|j|jkoW|j|jkS(N(t issubclassRnRRXRbRcRd(RYtother((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyt__eq__Ps cC`s|j|ƒ S(N(Rs(RYRr((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyt__ne__Ws(s_names_kinds_defaults _annotations_partial_kwarg(RRRTt __slots__R/R]ReR^R@R_RfR`R?RaRUtemptytFalseR#tpropertyRRRRRSR.R[R\RpRsRt(((s5/usr/lib/python2.7/dist-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(R=t _signature(RYRR=((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR#ls cC`s|jS(N(Ry(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRpscC`s§g}x”|jjjƒD]€\}}|jttfksC|jrGPny|j|}Wntk rlPqX|jt krŒ|j |ƒq|j |ƒqWt |ƒS(N( RyRR8RR?RfR R=tKeyErrorR@textendtappendR0(RYR9t param_nameROtarg((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR9ts  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=Rztupdate(RYRZtkwargs_startedR}ROR~((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRZs(    cC`s%dj|jjƒ}t|ƒ‚dS(Nsunhashable type: '{0}'(R'RnRR&(RYRL((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRp¯scC`s4t|jtƒo3|j|jko3|j|jkS(N(RqRnRRR=(RYRr((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRs³scC`s|j|ƒ S(N(Rs(RYRr((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRt¸s( RRRTR#RxRR9RZRpRsRt(((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR[s   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,RR/t enumerateRR'R<RRgR.R‚R( RYRtreturn_annotationt__validate_parameters__tparamsttop_kindtidxRORRLR((s5/usr/lib/python2.7/dist-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__RRRiiiR…treturnR†N(R R(R3R&R't_parameter_clst__code__t co_argcountt co_varnamesR0Rt __defaults__R,tlentgetRUR|ReR„tco_flagsR@RfR?Rw(RR7Rt func_codet pos_countt arg_namest positionaltkeyword_only_countt keyword_onlyt annotationstdefaultst kwdefaultstpos_default_countRtnon_default_countRRtoffsetRtindex((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR4sd                 cC`s<ytj|jƒSWn!tk r7t|jjƒƒSXdS(N(R(tMappingProxyTypeR‚RRR8(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRIs cC`s|jS(N(R(RY((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR…PscC`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…(RSRR-RR (RYRR…((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR.Ts    cC`s%dj|jjƒ}t|ƒ‚dS(Nsunhashable type: '{0}'(R'RnRR&(RYRL((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRpcscC`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‰RO((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pys ms(RqR RR…R“RRwtdictR„tkeysR8RRfRzR>(RYRrtother_positionsR‰R}ROt other_paramt other_idx((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRsgs, (    cC`s|j|ƒ S(N(Rs(RYRr((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyRt…scC`s‘tƒ}t|jjƒƒ}d}t|ƒ}|r~xE|jjƒD]1\}} | jrF||krF| j||tnextt StopIterationRR@RR/R'R&R?RURfR{R0R,t itertoolstchainRARzt_bound_arguments_cls(RYR9RZR6R=Rt parameters_extarg_valsR}ROtarg_valRLR-t kwargs_param((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyt_bindˆs                 cO`s|j||ƒ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. (R³(RYR9RZ((s5/usr/lib/python2.7/dist-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. R6(R³R>(RYR9RZ((s5/usr/lib/python2.7/dist-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}(R>R„RR-RgRR@RwRfR|R'tjoinR…RUR( RYtresulttrender_kw_only_separatorR‰RORmRtrenderedtanno((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR[s "      (s_return_annotations _parametersN(RRRTRuRRŽRR®RURvR,R>R#t classmethodR4RxRR…RSR.RpRsRtRwR³R´R;R[(((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyR¼s$ %I    €  ((RTt __future__RRRR¬R5RhR(t collectionsRt ImportErrortfuncsigs.odicttfuncsigs.versionRt__all__R R!t_WrapperDescriptortallt_MethodWrapperRBRR,RRRtobjectRSRURWRVR/ReR@RfR?RRR(((s5/usr/lib/python2.7/dist-packages/funcsigs/__init__.pyts<         | Œa