­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ ­ U .Wv@s\dZddlmZmZmZddlZddlZddlZddlZzddl m Z Wn e k rhddl m Z YnXddl mZdddd gZeejZeejZeeejfZd"d d Zd d Zdd ZGdddeZGdddeZGdddeZedddZedddZ edddZ!edddZ"edddZ#GdddeZ$Gd ddeZ%Gd!ddeZ&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|fkr |jS|jd|jSt|S)NbuiltinsZ __builtin__.) isinstancetype __module____name__repr) annotation base_modulerB/opt/alt/python38/lib/python3.8/site-packages/funcsigs/__init__.pyformatannotations  rcGs\z2|tkrWdSt||}|D]}t|||}qWntk rHYdSXt|tsX|SdSN)rgetattrAttributeErrorr _NonUserDefinedCallables)cls method_namenestedmethnamerrr_get_user_defined_method's  r c Cst|std|t|tjrt|j}|jdkr:|St |j }|r^|dj t tfkrftd|dj }|ttfkr|dd}n|tk rtd|j|dSz |j}Wntk rYnX|dk r|Sz |j}Wntk rYn Xt|St|tjrt|St|tjrt|j}t|j }|jpBd}|j pNi}z|j!||}Wn6tk r} zd |} t| W5d} ~ XYnX|j"D]R\} } || } | |kr| j| d d || <n"| j t tfkr| j#s|$| q|j| dSd}t|t%rtt&t%|d }|dk r8t|}n:t&|d }|dk rVt|}nt&|d}|dk rt|}n.t|t'st&t%|d d}|dk rt|}|dk r|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 TypeErrorformatr types 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)objsigparamsr1wrapped new_params partial_argspartial_keywordsbaexmsgZarg_name arg_valueparamcallnewinitrrrr 7s                            c@seZdZdZdS)_voidz0A private marker - used in Parameter & SignatureN)rr __qualname____doc__rrrrrVsrVc@s eZdZdS)_emptyN)rrrWrrrrrYsrYc@s$eZdZddZddZddZdS)_ParameterKindcOstj|f|}|d|_|S)Nr)intr&_name)selfrAkwargsrGrrrr&s z_ParameterKind.__new__cCs|jSrr\r]rrr__str__sz_ParameterKind.__str__cCs d|jS)Nz<_ParameterKind: {0!r}>)r*r\r`rrr__repr__sz_ParameterKind.__repr__N)rrrWr&rarbrrrrrZsrZPOSITIONAL_ONLYrr!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|tttttfkrtd||_|tk rF|ttfkrFd|}t|||_ ||_ |dkrr|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**) r1r\r6r*rnrYrrmrr7r2)r]r1 formattedrrrra;s"    zParameter.__str__cCsd|jjt||jS)Nz<{0} at {1:#x} {2!r}>)r* __class__ridrr`rrrrbSs zParameter.__repr__cCsd|jj}t|dSNzunhashable type: '{0}'r*rvrr)r]rPrrr__hash__WszParameter.__hash__cCs<t|jto:|j|jko:|j|jko:|j|jko:|j|jkSr) issubclassrvrr\rlrmrnr]otherrrr__eq__[s     zParameter.__eq__cCs || Srrr}rrr__ne__bszParameter.__ne__N)rrrWrX __slots__r6rcr5rer7rgr3rir2rkrYemptyr'propertyrr#rr1rVr8rarbr{rrrrrrrs8      c@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)rD _signature)r]r rDrrrr'wszBoundArguments.__init__cCs|jSr)rr`rrrr {szBoundArguments.signaturec Csg}|jjD]j\}}|jttfks,|jr0q|z|j|}Wntk rXYq|YqX|jt krp| |q| |qt |Sr) rr"r@r1r2r3r$rDKeyErrorr7extendappendr/)r]rA param_namerRargrrrrAs    zBoundArguments.argsc Csi}d}|jjD]~\}}|sJ|jttfks4|jr:d}n||jkrJd}q|sPqz|j|}Wntk rrYqX|jtkr| |q|||<q|S)NFT) rr"r@r1r2r3r$rDrupdate)r]r^kwargs_startedrrRrrrrr^s*    zBoundArguments.kwargscCsd|jj}t|dSrxryrzrrrr{szBoundArguments.__hash__cCs$t|jto"|j|jko"|j|jkSr)r|rvrr rDr}rrrrs    zBoundArguments.__eq__cCs || Srrr}rrrrszBoundArguments.__ne__N) rrrWrXr'rr rAr^r{rrrrrrrfs   c@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|dkrt}n|rt}t}t|D]z\}}|j}||krXd} | ||j} t| n|}|j} | dkr~t|} |j| d}| |krd| } 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}rdzduplicate parameter name: {0!r}css|]}|j|fVqdSrrd).0rRrrr sz%Signature.__init__..) rr6 enumerater1r*r4rror8rr) r]r"return_annotation__validate_parameters__rItop_kindidxrRr1rPrrrrr'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}| dk rf| |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__)rr1)rr1r#rjr!returnF)rr)r r+r;r)r*_parameter_cls__code__ co_argcount co_varnamesr/r __defaults__lengetrYrr5rco_flagsr7r3r2)rr?r func_code pos_count arg_names positionalkeyword_only_count keyword_only annotationsdefaults kwdefaultspos_default_countr"non_default_countrroffsetr#indexrrrr< sp                         zSignature.from_functioncCs6zt|jWStk r0t|jYSXdSr)r+MappingProxyTyperrrr@r`rrrr"TszSignature.parameterscCs|jSr)rr`rrrr[szSignature.return_annotationcCs0|tkr|j}|tkr |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)rVr"r0rr)r]r"rrrrr8_s zSignature.replacecCsd|jj}t|dSrxryrzrrrr{nszSignature.__hash__c Cstt|tr.|j|jks.t|jt|jkr2dStddt|jD}t|j D]\}\}}|j t krz|j|}Wnt k rYdSX||krdSq\z ||}Wnt k rYdSX||ks||j|kr\dSq\dS)NFcss|]\}}||fVqdSrr)rrrRrrrrxsz#Signature.__eq__..T) r|rr rrr"dictrkeysr@r1r3r)r]r~Zother_positionsrrrRZ other_paramZ other_idxrrrrrs4       zSignature.__eq__cCs || Srrr}rrrrszSignature.__ne__Fc Cst}t|j}d}t|}|rP|jD] \}} | jr.||kr.| j||<q.z t|} Wntk r<z t|} Wntk rYYqYnX| j t krYqn| j |kr| j t krd} | j | j d} t| | f}YqnR| j tks| jtk r | f}Yqn.|r| f}Yqnd} | j | j d} t| YqPXz t|} Wntk rhtdYqPX| j ttfkrtd| j t kr| g} | |t| || j <q| j |krtdj | j d| || j <qPd} t||D]} | j t kr tdj | j d| j tkr | } q| j }z||} WnDtk rx|st| j t krt| jtkrttdj |dYn X| ||<q|r| dk r||| 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"r0r@r$r#next StopIterationr1r7rr6r*r)r2rYr3rr/ itertoolschainrEr_bound_arguments_cls)r]rAr^r>rDr" parameters_exarg_valsrrRarg_valrPr0 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)rAr^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]rAr^rrrrCszSignature.bind_partialc Csg}d}t|jD]H\}}t|}|j}|tkr:d}n|tkrT|rT|dd}||qdd |}|j t k rt |j }|d|7}|S)NTFrtz({0})z, z -> {0}) rr"r0ror1r7r3rr*joinrrYr) r]resultrender_kw_only_separatorrrRrur1renderedannorrrra!s      zSignature.__str__)F)rrrWrXrrrrrrYrr' classmethodr<rr"rrVr8r{rrrrrCrarrrrr s. & H   )N)'rX __future__rrrrr=rpr+ collectionsr ImportErrorZ ordereddictZfuncsigs.versionr__all__rr%_WrapperDescriptorall_MethodWrapperrFrrr r objectrVrYr[rZr6r5r7r3r2rrr rrrrsB           a