관리-도구
편집 파일: attr.cpython-38.pyc
U -?�fQ � @ s� d Z ddlmZ ddlZddlmZ ddlZddlmZ ddl Z ddl m Z ddl m Z ddl m Z dd l m Z dd l mZ dd l mZ dd l mZ dd l mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddl mZ ddlZddl m Z ddl m Z ddl m Z ddl m Z dd l m!Z! d d l m"Z" d d l m#Z# d d l$m%Z% d d!l&m'Z' ed"e d#�Z(e j)�r�dd$l*m+Z+ dd%l*m,Z, dd&l*m-Z- G d'd(� d(e#j.ee �Z/G d)d*� d*e e( �Z0ee e( e0e( f Z1G d+d,� d,e/e �Z2G d-d.� d.e/e e e! �Z3G d/d0� d0e3e �Z4G d1d2� d2e'�Z5G d3d4� d4e3e �Z6G d5d6� d6e6e �Z7G d7d8� d8e6e �Z8dS )9a� Attribute implementation for _Dispatch classes. The various listener targets for a particular event class are represented as attributes, which refer to collections of listeners to be fired off. These collections can exist at the class level as well as at the instance level. An event is fired off using code like this:: some_object.dispatch.first_connect(arg1, arg2) Above, ``some_object.dispatch`` would be an instance of ``_Dispatch`` and ``first_connect`` is typically an instance of ``_ListenerCollection`` if event listeners are present, or ``_EmptyListener`` if none are present. The attribute mechanics here spend effort trying to ensure listener functions are available with a minimum of function call overhead, that unnecessary objects aren't created (i.e. many empty per-instance listener collections), as well as that everything is garbage collectable when owning references are lost. Other features such as "propagation" of listener functions across many ``_Dispatch`` instances, "joining" of multiple ``_Dispatch`` instances, as well as support for subclass propagation (e.g. events assigned to ``Pool`` vs. ``QueuePool``) are all implemented here. � )� annotationsN)�chain)� TracebackType)�Any)�cast)� Collection)�Deque)� FrozenSet)�Generic)�Iterator)�MutableMapping)�MutableSequence)�NoReturn)�Optional)�Sequence)�Set)�Tuple)�Type)�TypeVar)�Union� )�legacy)�registry)�_ET)� _EventKey)�_ListenerFnType� )�exc)�util)�AsyncAdaptedLock)�Protocol�_T)�bound)� _Dispatch)�_DispatchCommon)�_HasEventsDispatchc @ s( e Zd ZU dZded< dd�dd�ZdS )� RefCollection)�refz weakref.ref[RefCollection[_ET]]r' ��returnc C s t �| tj�S �N)�weakrefr' r Z_collection_gced��self� r. �E/opt/hc_python/lib64/python3.8/site-packages/sqlalchemy/event/attr.py�_memoized_attr_refP s z RefCollection._memoized_attr_refN)�__name__� __module__� __qualname__� __slots__�__annotations__r0 r. r. r. r/ r& K s r& c @ s� e Zd Zddd�dd�Zddd�dd�Zddd �d d �Zddd�d d �Zddd�dd�Zdd�dd�Zdd�dd�Z dd�dd�Z dS ) �_empty_collectionr! �None)�elementr) c C s d S r* r. �r- r8 r. r. r/ �appendU s z_empty_collection.appendc C s d S r* r. r9 r. r. r/ � appendleftX s z _empty_collection.appendleftz Sequence[_T])�otherr) c C s d S r* r. )r- r< r. r. r/ �extend[ s z_empty_collection.extendc C s d S r* r. r9 r. r. r/ �remove^ s z_empty_collection.remover �boolc C s dS �NFr. r9 r. r. r/ � __contains__a s z _empty_collection.__contains__z Iterator[_T]r( c C s t g �S r* )�iterr, r. r. r/ �__iter__d s z_empty_collection.__iter__c C s d S r* r. r, r. r. r/ �clearg s z_empty_collection.clear�intc C s dS �Nr r. r, r. r. r/ �__len__j s z_empty_collection.__len__N) r1 r2 r3 r: r; r= r> rA rC rD rG r. r. r. r/ r6 T s r6 c @ s� e Zd ZU dZdZded< ded< ded< ded < d ed < d ed < ddd�dd�Zdddd�dd�Zddd�dd�Zdddd�d d �Z dddd �d d �Z dddd �d!d"�Z d#dd$�d%d&�Z ddd'�d(d)�Z dd*�d+d,�Zd-d.d/�d0d1�Zd2S )3�_ClsLevelDispatchz2Class-level events on :class:`._Dispatch` classes.)�clsname�name� arg_names�has_kw�legacy_signatures� _clslevel� __weakref__�strrI rJ z Sequence[str]rK r? rL z,MutableSequence[legacy._LegacySignatureType]rM zCMutableMapping[Type[_ET], _ListenerFnSequenceType[_ListenerFnType]]rN z Type[_HasEventsDispatch[_ET]]r )�parent_dispatch_cls�fnc C sv |j | _|j | _t�|�}|jdd � | _t|j�| _ t t t t |dg �dd� d���| _t�| ||�|_t�� | _d S )Nr Z_legacy_signaturesc S s | d S rF r. )�sr. r. r/ �<lambda>� � z,_ClsLevelDispatch.__init__.<locals>.<lambda>)�key)r1 rJ rI r Zinspect_getfullargspec�argsrK r? �varkwrL �list�reversed�sorted�getattrrM r Z_augment_fn_docs�__doc__r+ �WeakKeyDictionaryrN )r- rQ rR �argspecr. r. r/ �__init__� s ���z_ClsLevelDispatch.__init__�rR �namedr) c C sN |r| � |�}| jrJztj|dd�}W n tk r: Y nX t�| ||�}|S )NT)Zno_self)�_wrap_fn_for_kwrM r Zget_callable_argspec� TypeErrorr Z_wrap_fn_for_legacy)r- rR rb r_ r. r. r/ �_adjust_fn_spec� s z!_ClsLevelDispatch._adjust_fn_spec)rR r) c s dddd�� �fdd� }|S )Nr �rW �kwr) c s$ t t�j| ��}|�|� � f |�S r* )�dict�ziprK �update)rW rg Zargdict�rR r- r. r/ �wrap_kw� s z2_ClsLevelDispatch._wrap_fn_for_kw.<locals>.wrap_kwr. )r- rR rl r. rk r/ rc � s z!_ClsLevelDispatch._wrap_fn_for_kw�_EventKey[_ET]r7 )� event_key� is_appendr) c C s� |j }t|t�std��t|dd�s6t�d|� d���t�|�D ]`}||k rb|| j krb| � |� q@|| j krv| � |� |r�| j | � |j � q@| j | � |j � q@t�|| � d S )Nz*Class-level Event targets must be classes.�_sa_propagate_class_eventsTz&Can't assign an event directly to the z class)�dispatch_target� isinstance�type�AssertionErrorr\ r ZInvalidRequestErrorr �walk_subclassesrN �update_subclassr: � _listen_fnr; r Z_stored_in_collection)r- rn ro �target�clsr. r. r/ �_do_insert_or_append� s( �� � z&_ClsLevelDispatch._do_insert_or_append�rn � propagater) c C s | j |dd� d S )NF�ro �rz �r- rn r| r. r. r/ �insert� s z_ClsLevelDispatch.insertc C s | j |dd� d S )NTr} r~ r r. r. r/ r: � s z_ClsLevelDispatch.append� Type[_ET])rx r) c s| || j kr2t|dd�r&t�� | j |< n t� | j |< | j | � |jdd � D ],}|| j krJ� �� fdd�| j | D �� qJd S )Nrp Tr c s g | ]}|� kr|�qS r. r. )�.0rR �Zclslevelr. r/ � <listcomp>� s z5_ClsLevelDispatch.update_subclass.<locals>.<listcomp>)rN r\ � collections�dequer6 �__mro__r= )r- rx ry r. r� r/ rv � s �z!_ClsLevelDispatch.update_subclass�rn r) c C sB |j }t�|�D ] }|| jkr| j| �|j� qt�|| � d S r* )rq r ru rN r> rw r �_removed_from_collection)r- rn rx ry r. r. r/ r> � s z_ClsLevelDispatch.remover( c C s8 t � }| j�� D ]}|�|� |�� qt�| |� dS )z Clear all class level listenersN)�setrN �valuesrj rD r �_clear)r- Zto_clear� dispatcherr. r. r/ rD � s z_ClsLevelDispatch.clear�_Dispatch[_ET]�_ClsLevelDispatch[_ET]��objr) c C s | S �z�Return an event collection which can be modified. For _ClsLevelDispatch at the class level of a dispatcher, this returns self. r. �r- r� r. r. r/ � for_modify� s z _ClsLevelDispatch.for_modifyN)r1 r2 r3 r] r4 r5 r` re rc rz r� r: rv r> rD r� r. r. r. r/ rH q s$ rH c @ s� e Zd ZU dZded< dddd�dd�Zd dd �d d �Zd d�dd�Zdd�dd�Zdd�dd�Z d d dd�dd�Z d d dd�dd�Z d d dd�d d �Z d d dd�d d �Z d ddd!�d"d#�Zd ddd!�d$d%�Zd dd&�d'd(�Zd)d*d+�d,d-�Zd.S )/�_InstanceLevelDispatchr. r� �parentr r? ra c C s | j �||�S r* )r� re �r- rR rb r. r. r/ re s z&_InstanceLevelDispatch._adjust_fn_specr ��itemr) c C s t � �d S r* ��NotImplementedError�r- r� r. r. r/ rA s z#_InstanceLevelDispatch.__contains__rE r( c C s t � �d S r* r� r, r. r. r/ rG s z _InstanceLevelDispatch.__len__�Iterator[_ListenerFnType]c C s t � �d S r* r� r, r. r. r/ rC s z _InstanceLevelDispatch.__iter__c C s t � �d S r* r� r, r. r. r/ �__bool__ s z _InstanceLevelDispatch.__bool__r7 rf c O s t � �d S r* r� �r- rW rg r. r. r/ � exec_once s z _InstanceLevelDispatch.exec_oncec O s t � �d S r* r� r� r. r. r/ �exec_once_unless_exception s z1_InstanceLevelDispatch.exec_once_unless_exceptionc O s t � �d S r* r� r� r. r. r/ �_exec_w_sync_on_first_run s z0_InstanceLevelDispatch._exec_w_sync_on_first_runc O s t � �d S r* r� r� r. r. r/ �__call__ s z _InstanceLevelDispatch.__call__rm r{ c C s t � �d S r* r� r r. r. r/ r� s z _InstanceLevelDispatch.insertc C s t � �d S r* r� r r. r. r/ r: ! s z _InstanceLevelDispatch.appendr� c C s t � �d S r* r� �r- rn r. r. r/ r> $ s z _InstanceLevelDispatch.remove�_DispatchCommon[_ET]�_InstanceLevelDispatch[_ET]r� c C s | S r� r. r� r. r. r/ r� ' s z!_InstanceLevelDispatch.for_modifyN)r1 r2 r3 r4 r5 re rA rG rC r� r� r� r� r� r� r: r> r� r. r. r. r/ r� � s r� c @ s2 e Zd ZU dZdZe� Zded< dZded< ded < d ed < d ed < ddd�dd�Z ddd�dd�Z dddd�dd�Z dddd�d d �Z dddd�d d �Z dddd�d d!�Zdddd�d"d#�Zdddd�d$d%�Zdddd�d&d'�Zddd(d�d)d*�Zdd+d,�d-d.�Zd/d0�d1d2�Zd3d0�d4d5�Zd+d0�d6d7�Zd8S )9�_EmptyListenerz�Serves as a proxy interface to the events served by a _ClsLevelDispatch, when there are no instance-level events present. Is replaced by _ListenerCollection when instance-level events are added. )r� �parent_listenersrJ zFrozenSet[_ListenerFnType]r| r. z Tuple[()]� listenersr� r� z(_ListenerFnSequenceType[_ListenerFnType]r� rP rJ r� �r� � target_clsc C s2 ||j kr|�|� || _|j | | _|j| _d S r* )rN rv r� r� rJ �r- r� r� r. r. r/ r` E s z_EmptyListener.__init__r� �_ListenerCollection[_ET]r� c C s` t d|�}|jdk st�t| j|j�}t|| j�| krFt|| j|� ntt|| j�t �s\t�|S )z�Return an event collection which can be modified. For _EmptyListener at the instance level of a dispatcher, this generates a new _ListenerCollection, applies it to the instance, and returns it. r� N) r Z _instance_clsrt �_ListenerCollectionr� r\ rJ �setattrrr �_JoinedListener)r- r� �resultr. r. r/ r� L s z_EmptyListener.for_modifyr r rf c O s t d��d S )Nzneed to call for_modify()r� r� r. r. r/ � _needs_modifya s z _EmptyListener._needs_modifyc O s | j ||� d S r* �r� r� r. r. r/ r� d s z_EmptyListener.exec_oncec O s | j ||� d S r* r� r� r. r. r/ r� g s z)_EmptyListener.exec_once_unless_exceptionc O s | j ||� d S r* r� r� r. r. r/ r� j s z_EmptyListener.insertc O s | j ||� d S r* r� r� r. r. r/ r: m s z_EmptyListener.appendc O s | j ||� d S r* r� r� r. r. r/ r> p s z_EmptyListener.removec O s | j ||� d S r* r� r� r. r. r/ rD s s z_EmptyListener.clearr7 c O s | j D ]}|||� qdS �zExecute this event.N�r� �r- rW rg rR r. r. r/ r� v s z_EmptyListener.__call__r? r� c C s || j kS r* r� r� r. r. r/ rA | s z_EmptyListener.__contains__rE r( c C s t | j�S r* )�lenr� r, r. r. r/ rG s z_EmptyListener.__len__r� c C s t | j�S r* )rB r� r, r. r. r/ rC � s z_EmptyListener.__iter__c C s t | j�S r* )r? r� r, r. r. r/ r� � s z_EmptyListener.__bool__N)r1 r2 r3 r] r4 � frozensetr| r5 r� r` r� r� r� r� r� r: r> rD r� rA rG rC r� r. r. r. r/ r� 3 s* r� c @ s. e Zd Zdd�dd�Zddddd �d d �Zd S ) �_MutexProtocolr? r( c C s d S r* r. r, r. r. r/ � __enter__� rU z_MutexProtocol.__enter__z Optional[Type[BaseException]]zOptional[BaseException]zOptional[TracebackType]zOptional[bool])�exc_type�exc_val�exc_tbr) c C s d S r* r. )r- r� r� r� r. r. r/ �__exit__� s z_MutexProtocol.__exit__N)r1 r2 r3 r� r� r. r. r. r/ r� � s r� c s e Zd ZU dZded< ded< ded< ded< ded < d d d �� fd d � Zdd�dd�Zdd�dd�Zdd d dd�dd�Zd d dd�dd�Z d d dd�dd�Z d d dd�d d �Z d d dd�d d �Z d dd �d!d"�Z d#d�d$d%�Zd&d�d'd(�Zdd�d)d*�Z� ZS )+�_CompoundListener)�_exec_once_mutex� _exec_once�_exec_w_sync_once� _is_asyncior� r� �Collection[_ListenerFnType]r� r� r? r� r� r )�argrg c s t � j||� d| _d S r@ )�superr` r� )r- r� rg �� __class__r. r/ r` � s z_CompoundListener.__init__r7 r( c C s d| _ d S )NT)r� r, r. r. r/ � _set_asyncio� s z _CompoundListener._set_asyncioc C s | j r t� S t�� S d S r* )r� r � threading�Lockr, r. r. r/ � _memoized_attr__exec_once_mutex� s z1_CompoundListener._memoized_attr__exec_once_mutex)�retry_on_exceptionrW rg r) c O sX | j �H | jsJz*z| ||� d}W n d}� Y nX W 5 |rB|sHd| _X W 5 Q R X d S )NTF)r� r� )r- r� rW rg � exceptionr. r. r/ �_exec_once_impl� s z!_CompoundListener._exec_once_implrf c O s | j s| jd|�|� dS )z]Execute this event, but only if it has not been executed already for this collection.FN)F�r� r� r� r. r. r/ r� � s z_CompoundListener.exec_oncec O s | j s| jd|�|� dS )at Execute this event, but only if it has not been executed already for this collection, or was called by a previous exec_once_unless_exception call and raised an exception. If exec_once was already called, then this method will never run the callable regardless of whether it raised or not. .. versionadded:: 1.3.8 TN)Tr� r� r. r. r/ r� � s z,_CompoundListener.exec_once_unless_exceptionc O sL | j s>| j�* z| ||� W n � Y nX d| _ W 5 Q R X n | ||� dS )an Execute this event, and use a mutex if it has not been executed already for this collection, or was called by a previous _exec_w_sync_on_first_run call and raised an exception. If _exec_w_sync_on_first_run was already called and didn't raise an exception, then a mutex is not used. .. versionadded:: 1.4.11 TN)r� r� r� r. r. r/ r� � s z+_CompoundListener._exec_w_sync_on_first_runc O s0 | j D ]}|||� q| jD ]}|||� q dS r� �r� r� r� r. r. r/ r� � s z_CompoundListener.__call__r� c C s || j kp|| jkS r* r� r� r. r. r/ rA � s z _CompoundListener.__contains__rE c C s t | j�t | j� S r* )r� r� r� r, r. r. r/ rG � s z_CompoundListener.__len__r� c C s t | j| j�S r* )r r� r� r, r. r. r/ rC � s z_CompoundListener.__iter__c C s t | jp | j�S r* )r? r� r� r, r. r. r/ r� � s z_CompoundListener.__bool__)r1 r2 r3 r4 r5 r` r� r� r� r� r� r� r� rA rG rC r� � __classcell__r. r. r� r/ r� � s$ r� c s� e Zd ZU dZdZded< ded< ded< d ed < d ed < dd d�� fdd� Zddd�dd�Zd(dddd�dd�Zd ddd �d d �Z d ddd �d d!�Z d dd"�d#d$�Z dd%�d&d'�Z � Z S ))r� z�Instance-level attributes on instances of :class:`._Dispatch`. Represents a collection of listeners. As of 0.7.9, _ListenerCollection is only first created via the _EmptyListener.for_modify() method. )r� r� rJ r� r| rO r� r� r� r� rP rJ zDeque[_ListenerFnType]r� zSet[_ListenerFnType]r| r� r� c sZ t � �� ||jkr |�|� d| _d| _|j| | _|| _|j| _t � � | _ t � | _ d S r@ )r� r` rN rv r� r� r� r� rJ r� r� r� r� r| r� r� r. r/ r` s z _ListenerCollection.__init__r� r� r� c C s | S )z�Return an event collection which can be modified. For _ListenerCollection at the instance level of a dispatcher, this returns self. r. r� r. r. r/ r� % s z _ListenerCollection.for_modifyTr? r7 )r< �only_propagater) c sj �j }t|�� �j�|j� � ��fdd�|j D �}|�|� |jrL��� |j�|�}t� �||� dS )zIPopulate from the listeners in another :class:`_Dispatch` object.c s& g | ] }|� kr�r |�j kr|�qS r. )r| )r� �l�Zexisting_listener_setr� r- r. r/ r� 8 s �z/_ListenerCollection._update.<locals>.<listcomp>N) r� r� r| rj r= r� r� �unionr Z_stored_in_collection_multi)r- r< r� Zexisting_listenersZother_listenersZ to_associater. r� r/ �_update0 s � z_ListenerCollection._updaterm r{ c C s$ |� | | j�r |r | j�|j� d S r* )Zprepend_to_listr� r| �addrw r r. r. r/ r� H s z_ListenerCollection.insertc C s$ |� | | j�r |r | j�|j� d S r* )Zappend_to_listr� r| r� rw r r. r. r/ r: M s z_ListenerCollection.appendr� c C s, | j �|j� | j�|j� t�|| � d S r* )r� r> rw r| �discardr r� r� r. r. r/ r> R s z_ListenerCollection.remover( c C s& t �| | j� | j�� | j�� d S r* )r r� r� r| rD r, r. r. r/ rD W s z_ListenerCollection.clear)T)r1 r2 r3 r] r4 r5 r` r� r� r� r: r> rD r� r. r. r� r/ r� s �r� c @ s� e Zd ZU dZded< ded< ded< ded < ddd d �d d �ZejsXedd�dd��Z dddd�dd�Z ddd�dd�Z dddd �d d �Z dddd �d d �Z ddd!�d"d#�Zdd�d$d%�Zd&S )'r� )�parent_dispatchrJ �localr� r� r� rP rJ r� r� r� r� z_EmptyListener[_ET])r� rJ r� c C s$ d| _ || _|| _|| _| j| _d S r@ )r� r� rJ r� r� )r- r� rJ r� r. r. r/ r` e s z_JoinedListener.__init__r( c C s t | j| j�S r* )r\ r� rJ r, r. r. r/ r� x s z_JoinedListener.listenersr r? ra c C s | j �||�S r* )r� re r� r. r. r/ re | s z _JoinedListener._adjust_fn_specz_JoinedListener[_ET]r� c C s | j �|� | _ | _| S r* )r� r� r� r� r. r. r/ r� � s z_JoinedListener.for_modifyrm r7 r{ c C s | j �||� d S r* )r� r� r r. r. r/ r� � s z_JoinedListener.insertc C s | j �||� d S r* )r� r: r r. r. r/ r: � s z_JoinedListener.appendr� c C s | j �|� d S r* )r� r> r� r. r. r/ r> � s z_JoinedListener.removec C s t � �d S r* r� r, r. r. r/ rD � s z_JoinedListener.clearN)r1 r2 r3 r4 r5 r` �typing� TYPE_CHECKING�propertyr� re r� r� r: r> rD r. r. r. r/ r� ] s r� )9r] � __future__r r� � itertoolsr r� �typesr r� r r r r r r r r r r r r r r r r r r+ � r r r r r r r Zutil.concurrencyr Z util.typingr r! r� �baser# r$ r% Z MemoizedSlotsr& r6 Z_ListenerFnSequenceTyperH r� r� r� r� r� r� r. r. r. r/ �<module> sb 7V l]