B
    	\t                 @   s.  d Z ddlmZmZmZ ddlZddlZddlZddlZddl	m
Z
 dZdddd	gZeejZeejZeeejfZd"d
dZdd Zdd	 ZG dd deZG dd deZG d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 G dd deZ!G d d deZ"G d!d deZ#dS )#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.7 and 3.2+.
    )absolute_importdivisionprint_functionN)OrderedDictz0.4BoundArguments	Parameter	Signature	signaturec             C   s8   t | tr0| jdd|fkr | jS | jd | j S t| S )NbuiltinsZ__builtin__.)
isinstancetype
__module____name__repr)
annotationZbase_module r   9lib/python3.7/site-packages/sklearn/externals/funcsigs.pyformatannotation   s
    
r   c             G   s\   y4| t krd S t| |}x|D ]}t|||}qW W n tk
rH   d S X t|tsX|S d S )N)r   getattrAttributeErrorr   _NonUserDefinedCallables)clsZmethod_namenestedmethnamer   r   r   _get_user_defined_method$   s    


r   c          
   C   s  t | std| t| tjrt| j}| jdkr||j	rv|j	
 d jtd}|j|ft|j	
 dd  dS |S n|jt|j	
 dd dS y
| j}W n tk
r   Y nX |dk	r|S y
| j}W n tk
r   Y n
X t|S t| tjrt| S t| tjrt| j}t|j	 }| jp6d}| jpBi }y|j||}W n6 tk
r } zd| }	t|	W dd}~X Y nX x`|j D ]R\}
}||
 }|
|kr|j|d	d
||
< n"|jtt fkr|j!s|"|
 qW |j|
 dS d}t| t#rlt$t#| d}|dk	r0t|}n:t$| d}|dk	rNt|}nt$| d}|dk	rt|}n.t| t%st$t#| dd}|dk	rt|}|dk	r|jt|j	
 dd dS t| tj&rd| }	t|	td| dS )z/Get a signature object for the passed callable.z{0!r} is not a callable objectNr   )kind   )
parametersr   z,partial object {0!r} has incorrect argumentsT)default_partial_kwarg__call____new____init__Zim_funcz-no signature found for builtin function {0!r}z,callable {0!r} is not supported by signature)'callable	TypeErrorformatr   types
MethodTyper	   __func____self__r   valuesreplace_POSITIONAL_ONLYtupleZ__signature__r   __wrapped__FunctionTyper   from_function	functoolspartialfuncr   itemsargskeywordsbind_partial
ValueError	argumentsr   _VAR_KEYWORD_VAR_POSITIONALr!   popr   r   r   BuiltinFunctionType)objZsigfirstwrappedZ
new_paramsZpartial_argsZpartial_keywordsZbaexmsgZarg_nameZ	arg_valueparamZcallnewZinitr   r   r   r	   4   s    

 
















c               @   s   e Zd ZdZdS )_voidz0A private marker - used in Parameter & SignatureN)r   r   __qualname____doc__r   r   r   r   rG      s   rG   c               @   s   e Zd ZdS )_emptyN)r   r   rH   r   r   r   r   rJ      s   rJ   c               @   s$   e Zd Zdd Zdd Zdd ZdS )_ParameterKindc             O   s   t j| f| }|d |_|S )Nr   )intr#   _name)selfr7   kwargsr@   r   r   r   r#      s    
z_ParameterKind.__new__c             C   s   | j S )N)rM   )rN   r   r   r   __str__   s    z_ParameterKind.__str__c             C   s   d | jS )Nz<_ParameterKind: {0!r}>)r'   rM   )rN   r   r   r   __repr__   s    z_ParameterKind.__repr__N)r   r   rH   r#   rP   rQ   r   r   r   r   rK      s   rK   POSITIONAL_ONLY)r   r   POSITIONAL_OR_KEYWORD   VAR_POSITIONAL   KEYWORD_ONLY   VAR_KEYWORDc               @   s   e Zd ZdZdZeZeZe	Z
eZeZeZeedfddZedd Zedd	 Zed
d Zedd ZeeeeefddZdd Zdd Zdd Zdd Zdd ZdS )r   a  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`.
    )rM   _kind_default_annotationr!   Fc             C   s   |t ttttfkrtd|| _|tk	rF|ttfkrFd|}t||| _	|| _
|d krr|t krjtd|| _n8t|}|t krtd|tjsd|}t||| _|| _d S )Nz,invalid value for 'Parameter.kind' attributez){0} parameters cannot have default valuesz<None is not a valid name for a non-positional-only parameterz
[a-z_]\w*$z#{0!r} is not a valid parameter name)r.   _POSITIONAL_OR_KEYWORDr=   _KEYWORD_ONLYr<   r:   rZ   rJ   r'   r[   r\   rM   strrematchIr!   )rN   r   r   r    r   r!   rD   r   r   r   r$      s(    

zParameter.__init__c             C   s   | j S )N)rM   )rN   r   r   r   r     s    zParameter.namec             C   s   | j S )N)r[   )rN   r   r   r   r      s    zParameter.defaultc             C   s   | j S )N)r\   )rN   r   r   r   r     s    zParameter.annotationc             C   s   | j S )N)rZ   )rN   r   r   r   r     s    zParameter.kindc             C   s\   |t kr| j}|t kr| j}|t kr*| j}|t kr8| j}|t krF| j}t| |||||dS )z+Creates a customized copy of the Parameter.)r    r   r!   )rG   rM   rZ   r\   r[   r!   r   )rN   r   r   r   r    r!   r   r   r   r-     s    zParameter.replacec             C   s   | j }| j}|tkr*|d kr d}d|}| jtk	rFd|t| j}| jtk	rbd|t| j}|t	krtd| }n|t
krd| }|S )N z<{0}>z{0}:{1}z{0}={1}*z**)r   rM   r.   r'   r\   rJ   r   r[   r   r=   r<   )rN   r   	formattedr   r   r   rP   -  s     



zParameter.__str__c             C   s   d | jjt| | jS )Nz<{0} at {1:#x} {2!r}>)r'   	__class__r   idr   )rN   r   r   r   rQ   E  s    
zParameter.__repr__c             C   s   d | jj}t|d S )Nzunhashable type: '{0}')r'   rf   r   r&   )rN   rD   r   r   r   __hash__I  s    zParameter.__hash__c             C   s<   t |jto:| j|jko:| j|jko:| j|jko:| j|jkS )N)
issubclassrf   r   rM   rZ   r[   r\   )rN   otherr   r   r   __eq__M  s
    zParameter.__eq__c             C   s   |  | S )N)rk   )rN   rj   r   r   r   __ne__T  s    zParameter.__ne__N)r   r   rH   rI   	__slots__r.   rR   r]   rS   r=   rU   r^   rW   r<   rY   rJ   emptyr$   propertyr   r    r   r   rG   r-   rP   rQ   rh   rk   rl   r   r   r   r   r      s*   c               @   sT   e 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d ZdS )r   a  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)r;   
_signature)rN   r	   r;   r   r   r   r$   i  s    zBoundArguments.__init__c             C   s   | j S )N)rp   )rN   r   r   r   r	   m  s    zBoundArguments.signaturec          	   C   s   g }xt| j j D ]d\}}|jttfks.|jr0P y| j| }W n tk
rT   P Y qX |jt	krl|
| q|| qW t|S )N)rp   r   r6   r   r<   r^   r!   r;   KeyErrorr=   extendappendr/   )rN   r7   
param_namerE   argr   r   r   r7   q  s    
zBoundArguments.argsc          	   C   s   i }d}x| j j D ]~\}}|sL|jttfks6|jr<d}n|| jkrLd}q|sRqy| j| }W n tk
rt   Y qX |jtkr|	| q|||< qW |S )NFT)
rp   r   r6   r   r<   r^   r!   r;   rq   update)rN   rO   Zkwargs_startedrt   rE   ru   r   r   r   rO     s(    

zBoundArguments.kwargsc             C   s   d | jj}t|d S )Nzunhashable type: '{0}')r'   rf   r   r&   )rN   rD   r   r   r   rh     s    zBoundArguments.__hash__c             C   s$   t |jto"| j|jko"| j|jkS )N)ri   rf   r   r	   r;   )rN   rj   r   r   r   rk     s    zBoundArguments.__eq__c             C   s   |  | S )N)rk   )rN   rj   r   r   r   rl     s    zBoundArguments.__ne__N)r   r   rH   rI   r$   ro   r	   r7   rO   rh   rk   rl   r   r   r   r   r   X  s   c               @   s   e Zd ZdZdZeZeZe	Z
de	dfddZedd Zed	d
 Zedd ZeefddZdd Zdd Zdd ZdddZdd Zdd Zdd ZdS )r   a  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.)
    )_return_annotation_parametersNTc             C   s   |dkrt  }n|rt  }t}xt|D ]z\}}|j}||k rZd}	|	||j}	t|	n|}|j}
|
dkrt|}
|j|
d}|
|krd|
}	t|	|||
< q(W nt dd |D }|| _	|| _
dS )zConstructs Signature from the given list of Parameter
        objects and 'return_annotation'.  All arguments are optional.
        Nz%wrong parameter order: {0} before {1})r   zduplicate parameter name: {0!r}c             s   s   | ]}|j |fV  qd S )N)r   ).0rE   r   r   r   	<genexpr>  s   z%Signature.__init__.<locals>.<genexpr>)r   r.   	enumerater   r'   r:   r   r_   r-   rx   rw   )rN   r   return_annotation__validate_parameters__ZparamsZtop_kindidxrE   r   rD   r   r   r   r   r$     s0    


zSignature.__init__c          	   C   s  t |tjstd|| j}|j}|j}|j}t	|d| }t
|dd}||||  }t
|di }	|j}
t
|dd}|
rt|
}nd}g }|| }x4|d| D ]$}|	|t}||||td qW xBt||d D ].\}}|	|t}||||t|
| d qW |jd	@ rL|||  }|	|t}||||td xJ|D ]B}t}|dk	rp||t}|	|t}||||t|d qRW |jd
@ r|| }|jd	@ r|d7 }|| }|	|t}||||td | ||	dtddS )z2Constructs Signature for the given python functionz{0!r} is not a Python functionNco_kwonlyargcountr   __annotations____kwdefaults__)r   r   )r   r   r    rX      r   returnF)r|   r}   )r   r(   r1   r&   r'   _parameter_cls__code__co_argcountco_varnamesr/   r   __defaults__lengetrJ   rs   r]   r{   co_flagsr=   r^   r<   )r   r5   r   Z	func_codeZ	pos_countZ	arg_namesZ
positionalZkeyword_only_countZkeyword_onlyZannotationsdefaultsZ
kwdefaultsZpos_default_countr   Znon_default_countr   r   offsetr    indexr   r   r   r2     sd    










zSignature.from_functionc             C   s0   yt | jS  tk
r*   t| j S X d S )N)r(   MappingProxyTyperx   r   r   r6   )rN   r   r   r   r   F  s    zSignature.parametersc             C   s   | j S )N)rw   )rN   r   r   r   r|   M  s    zSignature.return_annotationc             C   s0   |t kr| j }|t kr | j}t| ||dS )zCreates a customized copy of the Signature.
        Pass 'parameters' and/or 'return_annotation' arguments
        to override them in the new copy.
        )r|   )rG   r   r,   rw   r   )rN   r   r|   r   r   r   r-   Q  s    
zSignature.replacec             C   s   d | jj}t|d S )Nzunhashable type: '{0}')r'   rf   r   r&   )rN   rD   r   r   r   rh   `  s    zSignature.__hash__c          	   C   s   t t|tr.| j|jks.t| jt|jkr2dS tdd t|j D }xt| j	 D ]\}\}}|j
tkry|j| }W n tk
r   dS X ||krdS q^y|| }W n tk
r   dS X ||ks||j| kr^dS q^W dS )NFc             s   s   | ]\}}||fV  qd S )Nr   )ry   r~   rE   r   r   r   rz   j  s   z#Signature.__eq__.<locals>.<genexpr>T)ri   r   r   r|   r   r   dictr{   keysr6   r   r^   rq   )rN   rj   Zother_positionsr~   rt   rE   Zother_paramZ	other_idxr   r   r   rk   d  s,    
zSignature.__eq__c             C   s   |  | S )N)rk   )rN   rj   r   r   r   rl     s    zSignature.__ne__Fc             C   s  t  }t| j }d}t|}|rTx.| j D ] \}}	|	jr0||kr0|	j||< q0W xryt|}
W n tk
r,   yt|}	W n tk
r   P Y nX |	j	t
krP n|	j|kr|	j	tkrd}|j|	jd}t||	f}P nH|	j	tks|	jtk	r|	f}P n*|r|	f}P nd}|j|	jd}t|Y qXX yt|}	W n tk
rX   tdY qXX |	j	ttfkrrtd|	j	t
kr|
g}|| t|||	j< P |	j|krtdj|	jd|
||	j< qXW d}xt||D ]}	|	j	tkrtdj|	jd|	j	tkr|	}q|	j}y||}
W nD tk
rj   |sf|	j	t
krf|	jtkrftdj|dY n
X |
||< qW |r|dk	r|||j< ntd| | |S )	z$Private method.  Don't use directly.r   zA{arg!r} parameter is positional only, but was passed as a keyword)ru   z'{arg!r} parameter lacking default valueztoo many positional argumentsz$multiple values for argument {arg!r}Nztoo many keyword arguments)r   iterr   r,   r6   r!   r    nextStopIterationr   r=   r   r.   r'   r&   r<   rJ   r^   rr   r/   	itertoolschainr>   rq   _bound_arguments_cls)rN   r7   rO   r4   r;   r   Zparameters_exZarg_valsrt   rE   Zarg_valrD   r,   Zkwargs_paramr   r   r   _bind  s    






zSignature._bindc             O   s   |  ||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.
        )r   )rN   r7   rO   r   r   r   bind  s    zSignature.bindc             O   s   | j ||ddS )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)r4   )r   )rN   r7   rO   r   r   r   r9     s    zSignature.bind_partialc       	      C   s   g }d}xZt | j D ]H\}}t|}|j}|tkr<d}n|tkrV|rV|d d}|| qW dd	|}| j
tk	rt| j
}|d|7 }|S )NTFrd   z({0})z, z -> {0})r{   r   r,   r_   r   r=   r^   rs   r'   joinr|   rJ   r   )	rN   resultZrender_kw_only_separatorr~   rE   re   r   ZrenderedZannor   r   r   rP     s     


zSignature.__str__)F)r   r   rH   rI   rm   r   r   r   r   rJ   rn   r$   classmethodr2   ro   r   r|   rG   r-   rh   rk   rl   r   r   r9   rP   r   r   r   r   r     s&   %I
 )N)$rI   Z
__future__r   r   r   r   r3   r`   r(   collectionsr   __version____all__r   r"   Z_WrapperDescriptorallZ_MethodWrapperr?   r   r   r   r	   objectrG   rJ   rL   rK   r.   r]   r=   r^   r<   r   r   r   r   r   r   r   <module>   s8   


| a