a
    •˜ëj
!  ã                   @  s†  d Z ddlmZ ddlZddlmZ ddlmZ ddlmZ ddlmZ ddlmZ dd	lm	Z	 dd
lm
Z
 ddlmZ ddlmZ ddlmZ ddlmZ ejrºddlmZ ddlmZ e
dedef d�Zeeee edef f Zd6dddddœdd„Zdddœdd„Zd d!d"d!d#œd$d%„Zdddd&œd'd(„Zd d)d!dd*œd+d,„Zd dd!dd*œd-d.„Zd/d dd0œd1d2„Z d d/d!dd3œd4d5„Z!dS )7zhRoutines to handle adaption of legacy call signatures,
generation of deprecation notes and docstrings.

é    )ÚannotationsN)ÚAny)ÚCallable)ÚList)ÚOptional)ÚTuple)ÚType)ÚTypeVaré   )Ú_ET)Ú_ListenerFnTypeé   )Úutil)ÚFullArgSpec)Ú_ClsLevelDispatch)Ú_HasEventsDispatchÚ_F.)ÚboundÚstrz	List[str]zOptional[Callable[..., Any]]zCallable[[_F], _F])ÚsinceÚargnamesÚ	converterÚreturnc                   s   dddœ‡ ‡‡fdd„}|S )a_  legacy sig decorator


    :param since: string version for deprecation warning
    :param argnames: list of strings, which is *all* arguments that the legacy
     version accepted, including arguments that are still there
    :param converter: lambda that will accept tuple of this full arg signature
     and return tuple of new arg signature.

    r   ©Úfnr   c                   s&   t | dƒsg | _| j ˆˆ ˆf¡ | S )NÚ_legacy_signatures)Úhasattrr   Úappend©r   ©r   r   r   © úV/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/sqlalchemy/event/legacy.pyÚleg7   s    
z_legacy_signature.<locals>.legr    )r   r   r   r"   r    r   r!   Ú_legacy_signature'   s    r#   r   c                 C  s
   d| _ | S )NT)Ú_omit_standard_exampler   r    r    r!   r$   @   s    r$   z_ClsLevelDispatch[_ET]r   r   )Údispatch_collectionr   Úargspecr   c                   sâ   ˆj D ]Ö\‰‰ ‰ˆ d dkr.d‰ˆ dd… ‰ nd‰tˆ ƒt|jƒkrˆt|jƒu rdˆjd ˆj¡ˆrjdnd	f }d
ˆjˆjˆ|f ‰ˆd ur´ˆr–J ‚ddddœ‡‡‡‡fdd„}n ddddœ‡ ‡‡‡‡‡fdd„}|  S qˆS )Néÿÿÿÿz**kwTr   Fzdef %s(%s%s)ú, ú, **kwÚ zÁThe argument signature for the "%s.%s" event listener has changed as of version %s, and conversion for the old argument signature will be removed in a future release.  The new signature is "%s"r   )ÚargsÚkwr   c                    s&   t jˆˆd� ˆ d usJ ‚ˆˆ | Ž Ž S )N©Úversion)r   Úwarn_deprecated)r+   r,   )Úconvr   r   Úwarning_txtr    r!   Úwrap_legi   s    z%_wrap_fn_for_legacy.<locals>.wrap_legc                    sN   t jˆˆd� ttˆj| ƒƒ‰ ‡ fdd„ˆD ƒ}ˆrBˆ|i |¤ŽS ˆ|Ž S d S )Nr-   c                   s   g | ]}ˆ | ‘qS r    r    )Ú.0Úname©Zargdictr    r!   Ú
<listcomp>s   ó    z9_wrap_fn_for_legacy.<locals>.wrap_leg.<locals>.<listcomp>)r   r/   ÚdictÚzipÚ	arg_names)r+   r,   Zargs_from_dict)r   r%   r   Úhas_kwr   r1   r5   r!   r2   p   s    )	Úlegacy_signaturesÚlenr+   ÚboolÚvarkwr4   Újoinr:   Úclsname)r%   r   r&   Zformatted_defr2   r    )r   r0   r%   r   r;   r   r1   r!   Ú_wrap_fn_for_legacyE   s6    ÿ

ýüüÿ 	
rB   )ÚtextÚindentr   c                   s   d  ‡ fdd„|  d¡D ƒ¡S )NÚ
c                 3  s   | ]}ˆ | V  qd S ©Nr    )r3   Úline©rD   r    r!   Ú	<genexpr>   r7   z_indent.<locals>.<genexpr>)r@   Úsplit)rC   rD   r    rH   r!   Ú_indent~   s    rK   r   )r%   Úsample_targetr   r   c                 C  s‚   t d dd„ | jdd… D ƒ¡dƒ}| jr@tdd„ | jD ƒƒ}nd }d}||rVd	| nd
|j| jrfdnd
d | j¡||dœ; }|S )NrE   c                 s  s   | ]}d d|i V  qdS )z%(arg)s = kw['%(arg)s']ÚargNr    )r3   rM   r    r    r!   rI   ˆ   s   ÿz+_standard_listen_example.<locals>.<genexpr>r   r   z    c                 s  s   | ]\}}}|V  qd S rF   r    )r3   r   r+   r0   r    r    r!   rI   �   s   ÿzôfrom sqlalchemy import event


@event.listens_for(%(sample_target)s, '%(event_name)s')
def receive_%(event_name)s(%(named_event_arguments)s%(has_kw_arguments)s):
    "listen for the '%(event_name)s' event"

    # ... (event handling logic) ...
z (arguments as of %s)r*   r)   r(   )Úcurrent_sinceÚ
event_nameÚhas_kw_argumentsÚnamed_event_argumentsÚexample_kw_argrL   )rK   r@   r:   r<   ÚmaxÚ__name__r;   )r%   rL   r   rR   rN   rC   r    r    r!   Ú_standard_listen_example‚   s,    
þûþ
ÿ	
ø
rU   c              	   C  sD   d}| j D ]4\}}}|d||j| jr(dndd |¡|dœ 7 }q
|S )Nr*   a&  
# DEPRECATED calling style (pre-%(since)s, will be removed in a future release)
@event.listens_for(%(sample_target)s, '%(event_name)s')
def receive_%(event_name)s(%(named_event_arguments)s%(has_kw_arguments)s):
    "listen for the '%(event_name)s' event"

    # ... (event handling logic) ...
z **kwr(   )r   rO   rP   rQ   rL   )r<   rT   r;   r@   )r%   rL   r   rC   r   r+   r0   r    r    r!   Ú_legacy_listen_examples«   s    ùùÿrV   zType[_HasEventsDispatch[_ET]])Úparent_dispatch_clsr%   r   c              	     sJ   ˆ j d \}}}d|ˆjˆ jd ‡ ‡fdd„ˆ jD ƒ¡ˆ jr@dnddœ S )	Nr   a=  
.. versionchanged:: %(since)s
    The :meth:`.%(clsname)s.%(event_name)s` event now accepts the 
    arguments %(named_event_arguments)s%(has_kw_arguments)s.
    Support for listener functions which accept the previous 
    argument signature(s) listed above as "deprecated" will be 
    removed in a future release.r(   c                 3  s"   | ]}d ˆj ˆ j|dœ V  qdS )z6:paramref:`.%(clsname)s.%(event_name)s.%(param_name)s`)rA   rO   Ú
param_nameN)rT   r4   )r3   rX   ©r%   rW   r    r!   rI   ×   s   úýÿz-_version_signature_changes.<locals>.<genexpr>r)   r*   )r   rA   rO   rQ   rP   )r<   rT   r4   r@   r:   r;   )rW   r%   r   r+   r0   r    rY   r!   Ú_version_signature_changesÇ   s    ù	óúÿrZ   )r%   rW   r   r   c                 C  s|   t |ddƒr|jsJ ‚|jS d}t |ddƒ}|tt| ||ƒdƒ }| jrl|tt| ||ƒdƒ7 }|t|| ƒ7 }t |j|d¡S )Nr$   Fz@.. container:: event_signatures

     Example argument forms::

Z_target_class_docÚobjz        r
   )	ÚgetattrÚ__doc__rK   rU   r<   rV   rZ   r   Zinject_docstring_text)r%   rW   r   ÚheaderrL   rC   r    r    r!   Ú_augment_fn_docså   s&    
ÿ
þ
þÿr_   )N)"r]   Ú
__future__r   Útypingr   r   r   r   r   r   r	   Úregistryr   r   r*   r   Zutil.compatr   ÚTYPE_CHECKINGÚattrr   Úbaser   r   r   Z_LegacySignatureTyper#   r$   rB   rK   rU   rV   rZ   r_   r    r    r    r!   Ú<module>   s6    ý9)