a W%bv@sVdZddlmZmZmZddlZddlZddlZddlZzddl m Z Wne yfddl m Z Yn0ddl mZgdZeejZeejZeeejfZd#ddZd d Zd d ZGd ddeZGdddeZGdddeZedddZedddZ edddZ!edddZ"edddZ#GdddeZ$Gdd d eZ%Gd!d"d"eZ&dS)$zFunction 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+. )absolute_importdivisionprint_functionN) OrderedDict) __version__)BoundArguments Parameter Signature signaturecCs8t|tr0|jdd|fvr |jS|jd|jSt|S)Nbuiltins __builtin__.) isinstancetype __module____name__repr) annotation base_modulera/Users/vegardjervell/Documents/master/model/venv/lib/python3.9/site-packages/funcsigs/__init__.pyformatannotations  rcGsZz2|turWdSt||}|D]}t|||}qWntyFYdS0t|tsV|SdSN)rgetattrAttributeErrorr_NonUserDefinedCallables)cls method_namenestedmethnamerrr_get_user_defined_method's   r!c Cst|std|t|tjrt|j}|jdur:|St |j }|r^|dj t tfvrftd|dj }|ttfvr|dd}n|turtd|j|dSz |j}WntyYn0|dur|Sz |j}WntyYn 0t|St|tjrt|St|tjrt|j}t|j }|jp>d}|j pJi}z|j!|i|}Wn8ty} zd |} t| WYd} ~ n d} ~ 00|j"D]R\} } || } | |vr| j| d d || <n"| j t tfvr| j#s|$| q|j| dSd}t|t%rvt&t%|d }|dur:t|}n:t&|d }|durXt|}nt&|d}|durt|}n.t|t'st&t%|d d}|durt|}|dur|jt |j dddSt|tj(rd|} t| td|dS)z/Get a signature object for the passed callable.z{0!r} is not a callable objectNrzinvalid method signaturezinvalid argument type) parametersrz,partial object {0!r} has incorrect argumentsT)default_partial_kwarg__call____new____init__Zim_funcz-no signature found for builtin function {0!r}z,callable {0!r} is not supported by signature))callable TypeErrorformatrtypes MethodTyper __func____self__tupler#valueskind _VAR_KEYWORD _KEYWORD_ONLY ValueError_POSITIONAL_OR_KEYWORD_POSITIONAL_ONLY_VAR_POSITIONALreplace __signature__r __wrapped__ FunctionTyper from_function functoolspartialfuncritemsargskeywords bind_partial argumentsr%poprr!rBuiltinFunctionType)objsigparamsr2wrapped new_params partial_argspartial_keywordsbaexmsgZarg_name arg_valueparamcallnewinitrrrr 7s                              r c@seZdZdZdS)_voidz0A private marker - used in Parameter & SignatureN)rr __qualname____doc__rrrrrWsrWc@s eZdZdS)_emptyN)rrrXrrrrrZsrZc@s$eZdZddZddZddZdS)_ParameterKindcOs tj|g|R}|d|_|S)Nr )intr'_name)selfrBkwargsrHrrrr's z_ParameterKind.__new__cCs|jSrr]r^rrr__str__sz_ParameterKind.__str__cCs d|jS)Nz<_ParameterKind: {0!r}>)r+r]rarrr__repr__sz_ParameterKind.__repr__N)rrrXr'rbrcrrrrr[sr[POSITIONAL_ONLYr r"POSITIONAL_OR_KEYWORDVAR_POSITIONAL KEYWORD_ONLY VAR_KEYWORDc@seZdZdZdZeZeZe Z e Z e ZeZeedfddZeddZedd Zed d Zed d ZeeeeefddZddZddZddZddZddZdS)raRepresents 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`. )r]_kind_default _annotationr%FcCs|tttttfvrtd||_|turF|ttfvrFd|}t|||_ ||_ |durr|tkrjtd||_ n8t |}|tkrt d|t jsd|}t|||_ ||_dS)Nz,invalid value for 'Parameter.kind' attributez){0} parameters cannot have default valueszz{0}:{1}z{0}={1}*z**) r2r]r7r+rorZrrnrr8r3)r^r2 formattedrrrrb;s"    zParameter.__str__cCsd|jjt||jS)Nz<{0} at {1:#x} {2!r}>)r+ __class__ridr rarrrrcSs  zParameter.__repr__cCsd|jj}t|dSNzunhashable type: '{0}'r+rwrr*r^rQrrr__hash__WszParameter.__hash__cCs<t|jto:|j|jko:|j|jko:|j|jko:|j|jkSr) issubclassrwrr]rmrnror^otherrrr__eq__[s     zParameter.__eq__cCs || Srrr~rrr__ne__bszParameter.__ne__N)rrrXrY __slots__r7rdr6rfr8rhr4rjr3rlrZemptyr(propertyr r$rr2rWr9rbrcr|rrrrrrrs6      rc@sTeZdZdZddZeddZeddZedd Zd d Z d d Z ddZ dS)raResult 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. cCs||_||_dSr)rE _signature)r^r rErrrr(wszBoundArguments.__init__cCs|jSr)rrarrrr {szBoundArguments.signaturec Csg}|jjD]h\}}|jttfvs,|jr0qzz|j|}WntyVYqzYq0|jt krn| |q| |qt |Sr) rr#rAr2r3r4r%rEKeyErrorr8extendappendr0)r^rB param_namerSargrrrrBs     zBoundArguments.argsc Csi}d}|jjD]|\}}|sJ|jttfvs4|jr:d}n||jvrJd}q|sPqz|j|}WntypYq0|jtkr| |q|||<q|S)NFT) rr#rAr2r3r4r%rErupdate)r^r_kwargs_startedrrSrrrrr_s*     zBoundArguments.kwargscCsd|jj}t|dSryrzr{rrrr|szBoundArguments.__hash__cCs$t|jto"|j|jko"|j|jkSr)r}rwrr rEr~rrrrs    zBoundArguments.__eq__cCs || Srrr~rrrrszBoundArguments.__ne__N) rrrXrYr(rr rBr_r|rrrrrrrfs   rc@seZdZdZdZeZeZe Z de dfddZ e ddZ ed d Zed d Zeefd dZddZddZddZdddZddZddZddZdS)r aA 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.) )_return_annotation _parametersNTc Cs|durt}n|rt}t}t|D]z\}}|j}||krXd} | ||j} t| n|}|j} | dur~t|} |j| d}| |vrd| } t| ||| <q&ntdd|D}||_ ||_ dS)zConstructs Signature from the given list of Parameter objects and 'return_annotation'. All arguments are optional. Nz%wrong parameter order: {0} before {1}rezduplicate parameter name: {0!r}css|]}|j|fVqdSrre).0rSrrr sz%Signature.__init__..) rr7 enumerater2r+r5r rpr9rr) r^r#return_annotation__validate_parameters__rJtop_kindidxrSr2rQr rrrr(s2    zSignature.__init__c Cst|tjstd||j}|j}|j}|j}t |d|}t |dd}||||}t |di} |j } t |dd} | rt | } nd} g} || }|d|D]$}| |t}| |||tdqt||dD].\}}| |t}| |||t| |dq|jd @rD|||}| |t}| |||td|D]B}t}| durf| |t}| |t}| |||t|dqH|jd @r||}|jd @r|d 7}||}| |t}| |||td|| | d td dS)z2Constructs Signature for the given python functionz{0!r} is not a Python functionNco_kwonlyargcountr__annotations____kwdefaults__)rr2)rr2r$rkr"returnF)rr)rr,r<r*r+_parameter_cls__code__ co_argcount co_varnamesr0r __defaults__lengetrZrr6rco_flagsr8r4r3)rr@r func_code pos_count arg_names positionalkeyword_only_count keyword_only annotationsdefaults kwdefaultspos_default_countr#non_default_countr roffsetr$indexrrrr= sp                         zSignature.from_functioncCs4zt|jWSty.t|jYS0dSr)r,MappingProxyTyperrrrArarrrr#Ts zSignature.parameterscCs|jSr)rrarrrr[szSignature.return_annotationcCs0|tur|j}|tur |j}t|||dS)zCreates a customized copy of the Signature. Pass 'parameters' and/or 'return_annotation' arguments to override them in the new copy. )r)rWr#r1rr)r^r#rrrrr9_s zSignature.replacecCsd|jj}t|dSryrzr{rrrr|nszSignature.__hash__c Cstt|tr.|j|jks.t|jt|jkr2dStddt|jD}t|j D]\}\}}|j t krz|j|}Wnt yYdS0||krdSq\z ||}Wnt yYdS0||ks||j|kr\dSq\dS)NFcss|]\}}||fVqdSrr)rrrSrrrrxsz#Signature.__eq__..T) r}rr rrr#dictrkeysrAr2r4r)r^rZother_positionsrrrSZ other_paramZ other_idxrrrrrs4         zSignature.__eq__cCs || Srrr~rrrrszSignature.__ne__Fc Cst}t|j}d}t|}|rP|jD] \}} | jr.||vr.| j||<q.z t|} Wnty8z t|} WntyYYqYn0| j t krYqn| j |vr| j t krd} | j | j d} t| | f}YqnR| j tks| jtur| f}Yqn.|r| f}Yqnd} | j | j d} t| YqP0z t|} WntybtdYqP0| j ttfvr|td| j t kr| g} | |t| || j <q| j |vrtdj | j d| || j <qPd} t||D]} | j t krtdj | j d| j tkr| } q| j }z||} WnBtyp|sl| j t krl| jturltdj |dYn 0| ||<q|r| dur||| j <n td||||S) z$Private method. Don't use directly.rzA{arg!r} parameter is positional only, but was passed as a keyword)rz'{arg!r} parameter lacking default valueztoo many positional argumentsz$multiple values for argument {arg!r}Nztoo many keyword arguments %r)riterr#r1rAr%r$next StopIterationr2r8r r7r+r*r3rZr4rr0 itertoolschainrFr_bound_arguments_cls)r^rBr_r?rEr# parameters_exarg_valsrrSarg_valrQr1 kwargs_paramrrr_binds                   zSignature._bindcOs|d|dd|S)zGet 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. rr"Nr)rBr_rrrbindszSignature.bindcOs|j||ddS)zGet 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. T)r?r)r^rBr_rrrrDszSignature.bind_partialc Csg}d}t|jD]H\}}t|}|j}|tkr:d}n|tkrT|rT|dd}||qdd |}|j t urt |j }|d|7}|S)NTFruz({0})z, z -> {0}) rr#r1rpr2r8r4rr+joinrrZr) r^resultrender_kw_only_separatorrrSrvr2renderedannorrrrb!s      zSignature.__str__)F)rrrXrYrrrrrrZrr( classmethodr=rr#rrWr9r|rrrrrDrbrrrrr s. & H   r )N)'rY __future__rrrrr>rqr, collectionsr ImportErrorZ ordereddictZfuncsigs.versionr__all__rr&_WrapperDescriptorall_MethodWrapperrGrrr!r objectrWrZr\r[r7r6r8r4r3rrr rrrrsB           a