a
    •˜ëj—;  ã                   @  sî  U 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 ddlm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 e e¡Z de!d< dddœd d!„Z"G d"d#„ d#ƒZ#G d$d%„ d%ee ƒZ$G d&d'„ d'e$e ƒZ%d(d)d*œd+d,„Z&G d-d.„ d.ee ƒZ'G d/d0„ d0e$e ƒZ(G d1d2„ d2e'e ƒZ)G d3d4„ d4ee ƒZ*G d5d6„ d6e*e ƒZ+dS )7aµ  Base implementation classes.

The public-facing ``Events`` serves as the base class for an event interface;
its public attributes represent different kinds of events.   These attributes
are mirrored onto a ``_Dispatch`` class, which serves as a container for
collections of listener functions.   These collections are represented both
at the class level of a particular ``_Dispatch`` class as well as within
instances of ``_Dispatch``.

é    )ÚannotationsN)ÚAny)Úcast)ÚDict)ÚGeneric)ÚIterator)ÚList)ÚMapping)ÚMutableMapping)ÚOptional)Úoverload)ÚTuple)ÚType)ÚUnioné   )Ú_ClsLevelDispatch)Ú_EmptyListener)Ú_InstanceLevelDispatch)Ú_JoinedListener)Ú_ET)Ú	_EventKeyé   )Úutil)ÚLiteralz8MutableMapping[str, List[Type[_HasEventsDispatch[Any]]]]Ú_registrarsÚstrÚbool©ÚnameÚreturnc                 C  s   |   d¡ r| dkp|   d¡S )NÚ_ÚdispatchZ	_sa_event)Ú
startswith)r   © r#   úT/mnt/bigstor/www/usecases/.venv/lib/python3.9/site-packages/sqlalchemy/event/base.pyÚ_is_event_name3   s    ÿþr%   c                   @  s    e Zd ZdZdddœdd„ZdS )Ú_UnpickleDispatchz�Serializable callable that re-generates an instance of
    :class:`_Dispatch` given a particular :class:`.Events` subclass.

    ú	Type[_ET]ú_Dispatch[_ET])Ú_instance_clsr   c                 C  s>   |j D ]*}d|jv rtd|jd jƒ |¡  S qtdƒ‚d S )Nr!   r(   z*No class with a 'dispatch' member present.)Ú__mro__Ú__dict__r   r!   Ú
_for_classÚAttributeError)Úselfr)   Úclsr#   r#   r$   Ú__call__C   s    

ÿþ
z_UnpickleDispatch.__call__N)Ú__name__Ú
__module__Ú__qualname__Ú__doc__r0   r#   r#   r#   r$   r&   =   s   r&   c                   @  sL   e Zd ZU dZded< dddœdd„Zd	d
dœdd„Zeddœdd„ƒZdS )Ú_DispatchCommonr#   úOptional[Type[_ET]]r)   ú_DispatchCommon[_ET]ú_JoinedDispatcher[_ET]©Úotherr   c                 C  s
   t ƒ ‚d S ©N©ÚNotImplementedError©r.   r:   r#   r#   r$   Ú_joinR   s    z_DispatchCommon._joinr   ú_InstanceLevelDispatch[_ET]r   c                 C  s
   t ƒ ‚d S r;   r<   ©r.   r   r#   r#   r$   Ú__getattr__U   s    z_DispatchCommon.__getattr__úType[_HasEventsDispatch[_ET]]©r   c                 C  s
   t ƒ ‚d S r;   r<   ©r.   r#   r#   r$   Ú_eventsX   s    z_DispatchCommon._eventsN)	r1   r2   r3   Ú	__slots__Ú__annotations__r?   rB   ÚpropertyrF   r#   r#   r#   r$   r5   M   s   
r5   c                   @  sü   e Zd ZU dZdZded< e ¡ Zded< ded< d	ed
< ded< ded< ded< d<dddœdd„Z	dddœdd„Z
eddœdd„ƒZdd d!d"œd#d$„Zd%d&d'œd(d)„Zd*d&d+œd,d-„Zd.d/d0œd1d2„Zd3dœd4d5„Zd=d&dd!d7œd8d9„Zd!dœd:d;„ZdS )>Ú	_DispatchaM  Mirror the event listening definitions of an Events class with
    listener collections.

    Classes which define a "dispatch" member will return a
    non-instantiated :class:`._Dispatch` subclass when the member
    is accessed at the class level.  When the "dispatch" member is
    accessed at the instance level of its owner, an instance
    of the :class:`._Dispatch` class is returned.

    A :class:`._Dispatch` class is generated for each :class:`.Events`
    class defined, by the :meth:`._HasEventsDispatch._create_dispatcher_class`
    method.  The original :class:`.Events` classes remain untouched.
    This decouples the construction of :class:`.Events` subclasses from
    the implementation used by the event internals, and allows
    inspecting tools like Sphinx to work in an unsurprising
    way against the public API.

    )Ú_parentr)   r+   Ú_empty_listenersr   Z_active_historyz9MutableMapping[Type[_ET], Dict[str, _EmptyListener[_ET]]]Ú_empty_listener_regzDict[str, _EmptyListener[_ET]]rL   z	List[str]Ú_event_namesr6   r)   zType[_JoinedDispatcher[_ET]]Ú_joined_dispatch_clsrC   rF   NzOptional[_Dispatch[_ET]])ÚparentÚinstance_clsc                   sl   || _ ˆ | _ˆ rb|d usJ ‚z| jˆ  | _W qh ty^   ‡ fdd„|jD ƒ | _| jˆ < Y qh0 ni | _d S )Nc                   s   i | ]}|j t|ˆ ƒ“qS r#   )r   r   )Ú.0Úls©rQ   r#   r$   Ú
<dictcomp>™   s   ÿz&_Dispatch.__init__.<locals>.<dictcomp>)rK   r)   rM   rL   ÚKeyErrorÚ_event_descriptors)r.   rP   rQ   r#   rT   r$   Ú__init__Š   s    
þþ
ÿ
z_Dispatch.__init__r   r@   r   c                 C  s@   z| j | }W n ty(   t|ƒ‚Y n0 t| |j|ƒ |S d S r;   )rL   rV   r-   Úsetattrr   )r.   r   rS   r#   r#   r$   rB       s    z_Dispatch.__getattr__z Iterator[_ClsLevelDispatch[_ET]]rD   c                 c  s   | j D ]}t| |ƒV  qd S r;   )rN   Úgetattr)r.   Úkr#   r#   r$   rW   «   s    
z_Dispatch._event_descriptorsú_EventKey[_ET]r   ÚNone©Ú	event_keyÚkwr   c                 K  s   | j j|fi |¤ŽS r;   )rF   Ú_listen©r.   r_   r`   r#   r#   r$   ra   ²   s    z_Dispatch._listenr'   r(   )rQ   r   c                 C  s   |   | |¡S r;   )Ú	__class__)r.   rQ   r#   r#   r$   r,   µ   s    z_Dispatch._for_classr   )Úinstancer   c                 C  s   |j }|  |¡S r;   )rc   r,   )r.   rd   rQ   r#   r#   r$   Ú_for_instance¸   s    z_Dispatch._for_instancer7   r8   r9   c                 C  s   d| j jv sJ ‚|  | |¡S )z¡Create a 'join' of this :class:`._Dispatch` and another.

        This new dispatcher will dispatch events to both
        :class:`._Dispatch` objects.

        rO   )rc   r+   rO   r>   r#   r#   r$   r?   ¼   s    z_Dispatch._joinzUnion[str, Tuple[Any, ...]]c                 C  s   t ƒ | jffS r;   )r&   r)   rE   r#   r#   r$   Ú
__reduce__Ç   s    z_Dispatch.__reduce__T)r:   Úonly_propagater   c                 C  s8   |j D ],}t|tƒrqt| |jƒ | ¡j||d� qdS )zIPopulate from the listeners in another :class:`_Dispatch`
        object.)rg   N)rW   Ú
isinstancer   rZ   r   Ú
for_modifyÚ_update)r.   r:   rg   rS   r#   r#   r$   rj   Ê   s    

ÿz_Dispatch._updatec                 C  s   | j D ]}| | ¡ ¡  qd S r;   )rW   ri   Úclear)r.   rS   r#   r#   r$   Ú_clearÖ   s    
z_Dispatch._clear)N)T)r1   r2   r3   r4   rG   rH   ÚweakrefÚWeakKeyDictionaryrM   rX   rB   rI   rW   ra   r,   re   r?   rf   rj   rl   r#   r#   r#   r$   rJ   ]   s.   
þ

 ý ÿrJ   rC   r]   )r/   r   c                 C  s.   | j jD ] }t|  | ¡ t| st|= qd S r;   )r!   rN   r   Úremove)r/   r[   r#   r#   r$   Ú_remove_dispatcherÛ   s    rp   c                	   @  s®   e Zd ZU ded< ded< ejr0dddœdd	„Zd
dœdd„Zeddddœdd„ƒZ	edddddœdddddd
dœdd„ƒZ
eddddœdd„ƒZeddd d
d!œd"d#„ƒZd$S )%Ú_HasEventsDispatchr6   Ú_dispatch_targetr(   r!   r   r@   r   c                 C  s   d S r;   r#   rA   r#   r#   r$   rB   ï   ó    z_HasEventsDispatch.__getattr__r]   rD   c                 C  s   |   | j| j| j¡ dS )zOIntercept new Event subclasses and create associated _Dispatch
        classes.N)Ú_create_dispatcher_classr1   Ú	__bases__r+   ©r/   r#   r#   r$   Ú__init_subclass__ñ   s    z$_HasEventsDispatch.__init_subclass__úUnion[_ET, Type[_ET]]úOptional[Union[_ET, Type[_ET]]]©ÚtargetÚ
identifierr   c                 C  s
   t ƒ ‚d S r;   r<   )r/   r{   r|   r#   r#   r$   Ú_accept_with÷   s    z_HasEventsDispatch._accept_withF©Ú	propagateÚinsertÚnamedÚasyncior\   r   ©r_   r   r€   r�   r‚   r   c                C  s
   t ƒ ‚d S r;   r<   ©r/   r_   r   r€   r�   r‚   r#   r#   r$   ra   ý   s    
z_HasEventsDispatch._listenrC   úType[_Dispatch[_ET]])ÚklassÚdispatch_clsr   c                 C  s   |d ƒ| _ | |_| j S r;   )r!   rF   )r†   r‡   r#   r#   r$   Ú_set_dispatch	  s    

z _HasEventsDispatch._set_dispatchzTuple[type, ...]zMapping[str, Any])Ú	classnameÚbasesÚdict_r   c                 C  sJ  t | dƒr| jj}nt}dd„ |D ƒ}tdtd| |fd|iƒƒ}||_|  | |¡}|jD ](}t||t	| || ƒƒ t
|  | ¡ qZ|jD ]B}	t|	tƒrŠ|	turŠ|	jjjD ] }
t||
j|
ƒ |j |
j¡ qªqŠt| ddƒ�r| j}|dusîJ ‚t |dƒ�rd	|jv �rt| ƒ|_n
t| ƒ|_td
|j tfd|iƒ}||_|tƒ |j< dS )zVCreate a :class:`._Dispatch` class corresponding to an
        :class:`.Events` class.r!   c                 S  s   g | ]}t |ƒr|‘qS r#   )r%   )rR   r[   r#   r#   r$   Ú
<listcomp>&  rs   z?_HasEventsDispatch._create_dispatcher_class.<locals>.<listcomp>r…   z
%sDispatchrG   rr   NÚ_slots_dispatchzJoined%s)Úhasattrr!   rc   rJ   r   ÚtyperN   rˆ   rY   r   r   Úappendru   Ú
issubclassrF   rW   r   rZ   rr   rG   Úslots_dispatcherÚ
dispatcherr1   Ú_JoinedDispatcherrO   Úglobals)r/   r‰   rŠ   r‹   Zdispatch_baseZevent_namesr‡   Zdispatch_instr[   Zsuper_rS   Zdispatch_target_clsr†   r#   r#   r$   rt     sL    


ýþ	

ÿþ
ýz+_HasEventsDispatch._create_dispatcher_classN)r1   r2   r3   rH   ÚtypingÚTYPE_CHECKINGrB   rw   Úclassmethodr}   ra   Ústaticmethodrˆ   rt   r#   r#   r#   r$   rq   â   s"   
ùrq   c                   @  s€   e Zd ZU dZdZded< ded< ded< dddœd	d
„Zddœdd„Zdddœdd„Zddddœdd„Z	e
ddœdd„ƒZdS )r”   z5Represent a connection between two _Dispatch objects.©ÚlocalrP   r)   r7   r›   rP   r6   r)   )r›   rP   c                 C  s   || _ || _| j j| _d S r;   rš   )r.   r›   rP   r#   r#   r$   rX   [  s    z_JoinedDispatcher.__init__r   rD   c                 C  s   | j | j| jffS r;   )rc   r›   rP   rE   r#   r#   r$   rf   b  s    z_JoinedDispatcher.__reduce__r   z_JoinedListener[_ET]r   c                 C  s.   t | j|ƒ}t| j|j|ƒ}t| |j|ƒ |S r;   )rZ   r›   r   rP   r   rY   )r.   r   rS   Zjlr#   r#   r$   rB   e  s    z_JoinedDispatcher.__getattr__r\   r]   r^   c                 K  s   | j j|fi |¤ŽS r;   )rP   ra   rb   r#   r#   r$   ra   m  s    z_JoinedDispatcher._listenrC   c                 C  s   | j jS r;   )rP   rF   rE   r#   r#   r$   rF   p  s    z_JoinedDispatcher._eventsN)r1   r2   r3   r4   rG   rH   rX   rf   rB   ra   rI   rF   r#   r#   r#   r$   r”   R  s   
r”   c                	   @  st   e Zd ZdZeddddœdd„ƒZeddddd	œd
ddddddœdd„ƒZed
ddœdd„ƒZeddœdd„ƒZdS )ÚEventsz>Define event listening functions for a particular target type.rx   r   ry   rz   c                   sh   dddœ‡ fdd„}dddœ‡ fdd„}t ˆ d	ƒrd|| jjƒs`|t| jjƒs`|tƒrd|| jjƒrdˆ S d S )
Nú	Type[Any]r   )Útypesr   c                    s   t ‡ fdd„| D ƒƒS )Nc                 3  s   | ]}t ˆ j|ƒV  qd S r;   )rh   r!   )rR   Út©r{   r#   r$   Ú	<genexpr>}  rs   z;Events._accept_with.<locals>.dispatch_is.<locals>.<genexpr>)Úall)rž   r    r#   r$   Údispatch_is|  s    z(Events._accept_with.<locals>.dispatch_is)rŸ   r   c                   s0   t dˆ jƒj}t|tƒr&t d|ƒj}qt|| ƒS )Nr8   )r   r!   rP   rh   r”   )rŸ   rP   r    r#   r$   Údispatch_parent_is  s    
z/Events._accept_with.<locals>.dispatch_parent_isr!   )rŽ   r!   rc   r�   r”   )r/   r{   r|   r£   r¤   r#   r    r$   r}   x  s    	

ÿþü
ûzEvents._accept_withFr~   r\   r   r]   rƒ   c                C  s   |j ||||d� d S )Nr~   )Zbase_listenr„   r#   r#   r$   ra   •  s    
ÿzEvents._listen)r_   r   c                 C  s   |  ¡  d S r;   )ro   )r/   r_   r#   r#   r$   Ú_remove£  s    zEvents._removerD   c                 C  s   | j  ¡  d S r;   )r!   rl   rv   r#   r#   r$   rl   §  s    zEvents._clearN)	r1   r2   r3   r4   r˜   r}   ra   r¥   rl   r#   r#   r#   r$   rœ   u  s   ùrœ   c                   @  s\   e Zd ZdZddœdd„Zedddd	œd
d„ƒZedddd	œdd„ƒZdddd	œdd„ZdS )r“   zŸDescriptor used by target classes to
    deliver the _Dispatch class at the class level
    and produce new _Dispatch instances for target
    instances.

    rC   )Úeventsc                 C  s   |j | _ || _d S r;   )r!   r¦   )r.   r¦   r#   r#   r$   rX   ´  s    zdispatcher.__init__zLiteral[None]r�   r…   ©Úobjr/   r   c                 C  s   d S r;   r#   ©r.   r¨   r/   r#   r#   r$   Ú__get__¸  s    zdispatcher.__get__r   r7   c                 C  s   d S r;   r#   r©   r#   r#   r$   rª   ½  s    c              
   C  sb   |d u r| j S | j  |¡}z||jd< W n4 ty\ } ztd|f ƒ|‚W Y d }~n
d }~0 0 |S )Nr!   zGtarget %r doesn't have __dict__, should it be defining _slots_dispatch?)r!   re   r+   r-   Ú	TypeError)r.   r¨   r/   ÚdispZaer#   r#   r$   rª   À  s    ÿÿýN)r1   r2   r3   r4   rX   r   rª   r#   r#   r#   r$   r“   ¬  s   r“   c                   @  s   e Zd Zddddœdd„ZdS )r’   r   r�   r§   c                 C  s4   |d u r| j S t|dƒr|jS | j  |¡}||_|S )Nr�   )r!   rŽ   r�   re   )r.   r¨   r/   r¬   r#   r#   r$   rª   Ð  s    
zslots_dispatcher.__get__N)r1   r2   r3   rª   r#   r#   r#   r$   r’   Ï  s   r’   ),r4   Ú
__future__r   r–   r   r   r   r   r   r   r	   r
   r   r   r   r   r   rm   Úattrr   r   r   r   Úregistryr   r   Ú r   Zutil.typingr   ÚdefaultdictÚlistr   rH   r%   r&   r5   rJ   rp   rq   r”   rœ   r“   r’   r#   r#   r#   r$   Ú<module>   sH   ÿ

~p#7#