a
    •˜ëj‰+  ã                   @  sÞ  U d Z ddlmZ ddlZddl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 ddl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f Zeeeeef f Zeeeef Zeddd�ZG dd„ dƒZ e
d Z!e "e#¡Z$de%d< e
def Z&e "e#¡Z'de%d< d d!d"œd#d$„Z(d%d&d'd(œd)d*„Z)d%d&d!d(œd+d,„Z*d&d&d-d!d.œd/d0„Z+d&d-d!d1œd2d3„Z,G d4d5„ d5ee ƒZ-dS )6aJ  Provides managed registration services on behalf of :func:`.listen`
arguments.

By "managed registration", we mean that event listening functions and
other objects can be added to various collections in such a way that their
membership in all those collections can be revoked at once, based on
an equivalent :class:`._EventKey`.

é    )ÚannotationsN)ÚAny)ÚCallable)Úcast)ÚDeque)ÚDict)ÚGeneric)ÚIterable)ÚOptional)ÚTuple)ÚTypeVar)ÚUnioné   )Úexc)Úutilé   )ÚRefCollection)Ú
dispatcher.Ú_ETÚEventTarget)Úboundc                   @  s   e Zd ZU dZdZded< dS )r   zírepresents an event target, that is, something we can listen on
    either with that target as a class or as an instance.

    Examples include:  Connection, Mapper, Table, Session,
    InstrumentedAttribute, Engine, Pool, Dialect.

    © zdispatcher[Any]ÚdispatchN)Ú__name__Ú
__module__Ú__qualname__Ú__doc__Ú	__slots__Ú__annotations__r   r   r   úX/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/sqlalchemy/event/registry.pyr   3   s   
)zweakref.ref[RefCollection[Any]]úweakref.ref[_ListenerFnType]z6Dict[_EventKeyTupleType, _RefCollectionToListenerType]Ú_key_to_collectionr    z>Dict[weakref.ref[RefCollection[Any]], _ListenerToEventKeyType]Ú_collection_to_keyzweakref.ref[Any]ÚNone)ÚrefÚreturnc                 C  s^   t r| t vrd S td| ƒ} t  | ¡}| ¡ D ],}|tv r,t| }| | ¡ |s,t |¡ q,d S )Nz'weakref.ref[RefCollection[EventTarget]])r"   r   ÚpopÚvaluesr!   )r$   Úlistener_to_keyÚkeyÚdispatch_regr   r   r   Ú_collection_gcedh   s    


r+   ú_EventKey[_ET]úRefCollection[_ET]Úbool)Ú	event_keyÚownerr%   c                 C  sH   | j }t| }|j}t | j¡}||v r,dS |||< t| }|||< dS )NFT)Ú_keyr!   r$   ÚweakrefÚ
_listen_fnr"   )r/   r0   r)   r*   Ú	owner_refÚ
listen_refr(   r   r   r   Ú_stored_in_collectiony   s    r6   c                 C  sV   | j }t| }t | j¡}|j}| |d ¡ |s6t|= |tv rRt| }| |d ¡ d S ©N)r1   r!   r2   r$   r3   r&   r"   )r/   r0   r)   r*   r5   r4   r(   r   r   r   Ú_removed_from_collectionŽ   s    r8   zIterable[_ListenerFnType])ÚnewownerÚoldownerÚelementsr%   c              	   C  s®   |sd S |j }| j }t| }t| }|D ]€}t  |¡}z|| }	W n tyX   Y q(Y n0 zt|	 }
W n ty|   Y q(Y n0 ||
v r˜|
| |ks J ‚n||
|< |	||< q(d S r7   )r$   r"   r2   ÚKeyErrorr!   )r9   r:   r;   Zoldowner_refZnewowner_refZold_listener_to_keyZnew_listener_to_keyÚ	listen_fnr5   r)   r*   r   r   r   Ú_stored_in_collection_multi¥   s(    


r>   )r0   r;   r%   c                 C  sT   |sd S | j }t| }|D ]4}t  |¡}|| }t| }| |d ¡ |st|= qd S r7   )r$   r"   r2   r!   r&   )r0   r;   r4   r(   r=   r5   r)   r*   r   r   r   Ú_clearÉ   s    
r?   c                   @  s   e Zd ZU dZdZded< ded< ded< d	ed
< ded< ded< d7ddddddœdd„Zeddœdd„ƒZdddœdd„Z	dddœdd„Z
ddddœd d!„Zddœd"d#„Zd$dœd%d&„Zd8d$d$d$d(d$dd)œd*d+„Zeddœd,d-„ƒZd.d/d$d0œd1d2„Zd.d/dd0œd3d4„Zd.d/d$d0œd5d6„ZdS )9Ú	_EventKeyz$Represent :func:`.listen` arguments.)ÚtargetÚ
identifierÚfnÚfn_keyÚfn_wrapÚdispatch_targetr   rA   ÚstrrB   Ú_ListenerFnTyperC   Ú_ListenerFnKeyTyperD   r   rF   zOptional[_ListenerFnType]Ú_fn_wrapN)rA   rB   rC   rF   rJ   c                 C  sP   || _ || _|| _t|tjƒr6t|jƒt|jƒf| _	n
t|ƒ| _	|| _
|| _d S r7   )rA   rB   rC   Ú
isinstanceÚtypesÚ
MethodTypeÚidÚ__func__Ú__self__rD   rE   rF   )ÚselfrA   rB   rC   rF   rJ   r   r   r   Ú__init__ï   s    
z_EventKey.__init__Ú_EventKeyTupleType)r%   c                 C  s   t | jƒ| j| jfS r7   )rN   rA   rB   rD   ©rQ   r   r   r   r1     s    z_EventKey._keyr,   )rE   r%   c                 C  s,   || j u r| S t| j| j| j| j|d�S d S ©N)rJ   )r3   r@   rA   rB   rC   rF   )rQ   rE   r   r   r   Úwith_wrapper  s    
ûz_EventKey.with_wrapper)rF   r%   c                 C  s,   || j u r| S t| j| j| j|| jd�S d S rU   )rF   r@   rA   rB   rC   rE   )rQ   rF   r   r   r   Úwith_dispatch_target  s    
ûz_EventKey.with_dispatch_targetr#   )ÚargsÚkwr%   c                 O  sÌ   |  dd¡}|  dd¡}|  dd¡}| j| j| j  }}}t|j|ƒ}	|	 ||¡}
|  |
¡} t| jjj| jƒ}t	|dƒr€| 
¡  |sˆ|r¬|  tj| j|d�¡j|i |¤Ž n| jjj| g|¢R i |¤Ž d S )NÚonceFZ_once_unless_exceptionÚnamedÚ_sa_warn)Úretry_on_exception)r&   rF   rB   r3   Úgetattrr   Z_adjust_fn_specrV   Z_eventsÚhasattrr\   r   Z	only_onceÚlistenZ_listen)rQ   rX   rY   rZ   Zonce_unless_exceptionr[   rA   rB   rC   Údispatch_collectionZadjusted_fnZstub_functionr   r   r   r`     s4    ý

ÿ
ÿÿüüz_EventKey.listenc                 C  st   | j }|tvr(t d| j| j| jf ¡‚t |¡}| ¡ D ]4\}}|ƒ }|ƒ }|d ur:|d ur:| 	|  
|¡¡ q:d S )Nz*No listeners found for event %s / %r / %s )r1   r!   r   ZInvalidRequestErrorrA   rB   rC   r&   ÚitemsÚremoverV   )rQ   r)   r*   Zcollection_refZlistener_refZ
collectionZlistener_fnr   r   r   rc   =  s    ÿÿ
z_EventKey.remover.   c                 C  s
   | j tv S )z6Return True if this event key is registered to listen.)r1   r!   rT   r   r   r   ÚcontainsN  s    z_EventKey.containsFzOptional[bool])Ú	propagateÚinsertr[   ÚretvalÚasyncior%   c           
      C  sT   | j | j }}t|j|ƒ}| |j¡}	|r2|	 ¡  |rD|	 | |¡ n|	 | |¡ d S r7   )rF   rB   r^   r   Ú
for_modifyZ_set_asynciorf   Úappend)
rQ   re   rf   r[   rg   rh   rA   rB   ra   ri   r   r   r   Úbase_listenR  s    z_EventKey.base_listenc                 C  s   | j p
| jS r7   )rE   rC   rT   r   r   r   r3   g  s    z_EventKey._listen_fnr-   zDeque[_ListenerFnType])r0   Úlist_r%   c                 C  s"   t | |ƒr| | j¡ dS dS d S ©NTF)r6   rj   r3   ©rQ   r0   rl   r   r   r   Úappend_to_listk  s    
z_EventKey.append_to_listc                 C  s   t | |ƒ | | j¡ d S r7   )r8   rc   r3   rn   r   r   r   Úremove_from_listv  s    
z_EventKey.remove_from_listc                 C  s"   t | |ƒr| | j¡ dS dS d S rm   )r6   Ú
appendleftr3   rn   r   r   r   Úprepend_to_list~  s    
z_EventKey.prepend_to_list)N)FFFNF)r   r   r   r   r   r   rR   Úpropertyr1   rV   rW   r`   rc   rd   rk   r3   ro   rp   rr   r   r   r   r   r@   Ü   s8   
	 ú      úr@   ).r   Ú
__future__r   ÚcollectionsrL   Útypingr   r   r   r   r   r   r	   r
   r   r   r   r2   Ú r   r   ÚTYPE_CHECKINGÚattrr   Úbaser   rH   ÚintrI   rG   rS   r   r   Z_RefCollectionToListenerTypeÚdefaultdictÚdictr!   r   Z_ListenerToEventKeyTyper"   r+   r6   r8   r>   r?   r@   r   r   r   r   Ú<module>   sX   
ÿÿ
ÿÿý
$