a
    ö£Be�-  ã                   @   sh  d dl Z d dl mZ d dlmZ d dlmZmZmZmZm	Z	m
Z
mZmZ ddlmZmZ e
deeef d�Ze
d	eeef d�Ze	ed
œdd„Zdd„ Zee dœdd„Zeeedœdd„Zd+eeeddœdd„Zeedœdd„Ze je jeeeedœdd„Ze je jeeeeedœd d!„Zeeee je jed"œd#d$„Ze je jeedd%œd&d'„Zeeed(œd)d*„ZdS ),é    N)Ú	Parameter)ÚFunctionType)ÚCallableÚDictÚOptionalÚTupleÚTypeÚTypeVarÚUnionÚget_type_hintsé   )Úget_argsÚ	issubtypeÚ_WrappedMethod)ÚboundÚ_WrappedMethod2)ÚtÚreturnc                 C   s.   t | tƒrdS t| ƒD ]}t|ƒr dS qdS )a_  Recursively check if `t` or any types contained by `t` is a `TypeVar`.

    Examples where we return `True`: `T`, `Optional[T]`, `Tuple[Optional[T], ...]`, ...
    Examples where we return `False`: `int`, `Optional[str]`, ...

    :param t: Type to evaluate.
    :return: `True` if the input type contains an unbound `TypeVar`, `False` otherwise.
    TF)Ú
isinstancer	   r   Ú_contains_unbound_typevar)r   Úarg© r   úV/home/yuhw/wc/wire-cell-python/wcpy/lib/python3.9/site-packages/overrides/signature.pyr      s    
r   c                 C   sJ   t | ƒrdS |d u rdS t |ƒr$dS zt| |ƒW S  tyD   Y dS 0 d S )NT)r   r   Ú	TypeError)ÚleftÚrightr   r   r   Ú
_issubtype"   s    r   )r   c              	   C   s(   z
t | ƒW S  ttfy"   Y d S 0 d S ©N)r   Ú	NameErrorr   ©Úcallabler   r   r   Ú_get_type_hints0   s    
r!   )Ú	callable1Ú	callable2r   c                 C   sF   | j  d¡d }z
|j }W n ty.   Y dS 0 | d¡d }||kS )NÚ.r   F)Ú
__module__ÚsplitÚAttributeError)r"   r#   Zmod1Zmod2r   r   r   Ú_is_same_module7   s    
r(   F)Úsuper_callableÚsub_callableÚ	is_staticr   c           	      C   s²   t | ƒ} t |ƒ}zt | ¡}W n ty2   Y dS 0 t| ƒ}t |¡}t|ƒ}|j}t|| ƒ}|dur |dur t|||ƒ t||||||ƒ t	|||||||ƒ t
||||ƒ dS )aå  Ensure that the signature of `sub_callable` is compatible with the signature of `super_callable`.

    Guarantees that any call to `super_callable` will work on `sub_callable` by checking the following criteria:

    1. The return type of `sub_callable` is a subtype of the return type of `super_callable`.
    2. All parameters of `super_callable` are present in `sub_callable`, unless `sub_callable`
       declares `*args` or `**kwargs`.
    3. All positional parameters of `super_callable` appear in the same order in `sub_callable`.
    4. All parameters of `super_callable` are a subtype of the corresponding parameters of `sub_callable`.
    5. All required parameters of `sub_callable` are present in `super_callable`, unless `super_callable`
       declares `*args` or `**kwargs`.

    :param super_callable: Function to check compatibility with.
    :param sub_callable: Function to check compatibility of.
    :param is_static: True if staticmethod and should check first argument.
    N)Ú_unbound_funcÚinspectÚ	signatureÚ
ValueErrorr!   Ú__qualname__r(   Ú ensure_return_type_compatibilityÚ ensure_all_kwargs_defined_in_subÚ)ensure_all_positional_args_defined_in_subÚensure_no_extra_args_in_sub)	r)   r*   r+   Ú	super_sigÚsuper_type_hintsÚsub_sigÚsub_type_hintsÚmethod_nameZsame_main_moduler   r   r   Úensure_signature_is_compatibleA   s4    

ÿù	r:   )r    r   c                 C   s   t | dƒrt | dƒr| jS | S )NÚ__self__Ú__func__)Úhasattrr<   r   r   r   r   r,   v   s    r,   )r5   r7   r6   r8   Úcheck_first_parameterr9   c                 C   s|  t dd„ |j ¡ D ƒƒ}t| j ¡ ƒD �]N\}\}}	|dkrB|sBq&|	jtjkrPq&|	jtjkr^q&t	|d|||	ƒs„t
|› d|› d�ƒ‚q&||jv r&|	jtjkr&t|j ¡ ƒ |¡}
|j| }|	j|jkrú|	jtjkrÜ|jtjksút
|› d|› d|	j› d�ƒ‚q&||
k�r.|	jtjk�r.t
|› d|› d	|› d�ƒ‚q&||v r&||v r&t|| || ƒs&t
d|› d
|› d|	j› d|j› d�	ƒ‚q&d S )Nc                 s   s   | ]}|j tjkV  qd S r   ©Úkindr   ÚVAR_KEYWORD©Ú.0Úpr   r   r   Ú	<genexpr>„   s   z3ensure_all_kwargs_defined_in_sub.<locals>.<genexpr>r   Tú: `z` is not present.ú
` is not `ú`z` is not parameter at index `ú: z must be a supertype of `ú
` but is `)ÚanyÚ
parametersÚvaluesÚ	enumerateÚitemsr@   r   ÚVAR_POSITIONALÚPOSITIONAL_ONLYÚis_param_defined_in_subr   rA   ÚlistÚkeysÚindexÚKEYWORD_ONLYÚPOSITIONAL_OR_KEYWORDr   Ú
annotation)r5   r7   r6   r8   r>   r9   Úsub_has_var_kwargsZsuper_indexÚnameÚsuper_paramÚ	sub_indexÚ	sub_paramr   r   r   r2   |   sH    ÿ
ÿ

ÿ
þÿÿþý ÿr2   )r5   r7   r6   r8   r>   Úis_same_main_moduler9   c                 C   s  dd„ |j  ¡ D ƒ}dd„ | j  ¡ D ƒ}tdd„ |D ƒƒ}	tdd„ |D ƒƒ}
|	snt|ƒt|ƒk rnt|› d�ƒ‚d}t|ƒD �]Ž\}}|dkr’|s’qz|| t|ƒkrî|jtjkr°qz|jtj	krÊ|j
tjkrÊqz|jtjkrØqzt|› d	|j› d
�ƒ‚|jtjk�r d S |||  }|jtjk�r$|d8 }|jtjk�rN|	szt|› d	|j› d�ƒ‚qz|j|jk�r´|jtj	k�rx|jtjk�s´|jtj	k�rŒ|
�s´t|› d	|j› d|j› d|j› d�ƒ‚qz|j|v �sÄ|rzt| |jd ¡| |jd ¡ƒsztd|› d|j› d|j› d|j› d�	ƒ‚qzd S )Nc                 S   s"   g | ]}|j tjtjfvr|‘qS r   ©r@   r   rV   rA   ©rC   Úvr   r   r   Ú
<listcomp>²   s   þz=ensure_all_positional_args_defined_in_sub.<locals>.<listcomp>c                 S   s"   g | ]}|j tjtjfvr|‘qS r   r_   r`   r   r   r   rb   ·   s   þc                 s   s   | ]}|j tjkV  qd S r   ©r@   r   rP   rB   r   r   r   rE   ¼   s   z<ensure_all_positional_args_defined_in_sub.<locals>.<genexpr>c                 s   s   | ]}|j tjkV  qd S r   rc   rB   r   r   r   rE   ¿   s   z: parameter list too shortr   rF   z8` positionally required in subclass but not in supertyper   z` must be presentrG   z
` and is `rH   rI   z$ overriding must be a supertype of `rJ   )rL   rM   rK   Úlenr   rN   r@   r   rP   rQ   ÚdefaultÚemptyrW   rZ   r   ÚgetrX   )r5   r7   r6   r8   r>   r^   r9   Zsub_parameter_valuesZsuper_parameter_valuesÚsub_has_var_argsZsuper_has_var_argsZsuper_shiftrU   r]   r[   r   r   r   r3   ©   s‚    	þþÿÿ
ÿ
þÿ
ÿ
ý
ü
úú ÿÿÿþþ"ÿr3   )rZ   rh   rY   r7   r[   r   c                 C   s^   | |j v p\|jtjkr|p\|jtjkr*|p\|jtjkr:|p\|jtjkrN|rN|p\|jtjko\|S r   )rL   r@   r   rP   rA   rQ   rW   rV   )rZ   rh   rY   r7   r[   r   r   r   rR   ô   s    
ÿþýÿù	örR   )r5   r7   r>   r9   r   c           
      C   sú   | j  ¡ }tdd„ |D ƒƒ}tdd„ |D ƒƒ}t|j  ¡ ƒD ]¸\}\}}	|	jtjkrvt|ƒ|krvt	|ƒ| jtjkrvq<|| j vr<|	j
tjkr<|	jtjkr<|	jtjkr<|	jtjkr´|s<|	jtjkrÄ|s<|	jtjkrÔ|s<|dksà|r<t|› d|› d�ƒ‚q<d S )Nc                 s   s   | ]}|j tjkV  qd S r   rc   rB   r   r   r   rE     ó    z.ensure_no_extra_args_in_sub.<locals>.<genexpr>c                 s   s   | ]}|j tjkV  qd S r   r?   rB   r   r   r   rE     ri   r   rF   z` is not a valid parameter.)rL   rM   rK   rN   rO   r@   r   rQ   rd   rS   re   rf   rP   rA   rV   rW   r   )
r5   r7   r>   r9   Zsuper_paramsZsuper_var_argsZsuper_var_kwargsr\   rZ   r]   r   r   r   r4   	  sH    

ÿ
þýÿ
þ
ý
ü
ûû
úú
øø
ö
ör4   )r6   r8   r9   c                 C   sH   |   dd ¡}|  dd ¡}t||ƒsD|d urDt|› d|› d|› d�ƒ‚d S )Nr   z: return type `z` is not a `z`.)rg   r   r   )r6   r8   r9   Zsuper_returnZ
sub_returnr   r   r   r1   (  s    ÿr1   )F) r-   r   Útypesr   Útypingr   r   r   r   r   r	   r
   r   Ztyping_utilsr   r   r   r   Úboolr   r   r!   r(   r:   r,   Ú	SignatureÚstrr2   r3   rR   r4   r1   r   r   r   r   Ú<module>   s`   ( ýü5ú.ùLúû ÿ