Current File : //opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyc
�
��4]c @� sU d Z d d l m Z d d l m Z d d l 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
e j f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d e f d � � YZ d S( s� 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.
i ( t absolute_import( t with_statementN( t chaini ( t legacy( t registryi ( t exc( t util( t threadingt
RefCollectionc B� s e Z d Z d � Z RS( t refc C� s t j | t j � S( N( t weakrefR R t _collection_gced( t self( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt _memoized_attr_ref1 s ( R ( t __name__t
__module__t __slots__R
( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR . s t _empty_collectionc B� s5 e Z d � Z d � Z d � Z d � Z d � Z RS( c C� s d S( N( ( R t element( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt append6 s c C� s d S( N( ( R t other( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt extend9 s c C� s d S( N( ( R R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt remove< s c C� s
t g � S( N( t iter( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt __iter__? s c C� s d S( N( ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt clearB s ( R R R R R R R ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR 5 s
t _ClsLevelDispatchc B� sn e Z d Z d Z d � Z d � Z d � Z d
� Z d � Z d � Z d
� Z
d � Z d � Z d � Z
RS( s2 Class-level events on :class:`._Dispatch` classes.t namet arg_namest has_kwt legacy_signaturest _clslevelt __weakref__c C� s� | j | _ t j | � } | j d | _ t | j � | _ t t
t t | d g � d d � �� � | _
t j | | | � | _ t j � | _ d S( Ni t _legacy_signaturest keyc S� s | d S( Ni ( ( t s( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt <lambda>Z t ( R R R t inspect_getfullargspect argsR t boolt varkwR t listt reversedt sortedt getattrR R t _augment_fn_docst __doc__R
t WeakKeyDictionaryR ( R t parent_dispatch_clst fnt argspec( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt __init__R s 'c C� sj | r | j | � } n | j rf y t j | d t �} Wn t k
rM qf Xt j | | | � } n | S( Nt no_self( t _wrap_fn_for_kwR R t get_callable_argspect Truet TypeErrorR t _wrap_fn_for_legacy( R R2 t namedR3 ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt _adjust_fn_specb s
c � s � � f d � } | S( Nc � s/ t t � j | � � } | j | � � | � S( N( t dictt zipR t update( R' t kwt argdict( R2 R ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt wrap_kwo s
( ( R R2 RB ( ( R2 R sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR6 n s c C� s� | j } t | t � s$ t d � � t | d t � sL t j d | � � n | g } x� | r� | j d � } | j | j
� � | | k r� | | j k r� | j | � qX | | j k r� | j
| � n | j | j | j � qX Wt j | | � d S( Ns* Class-level Event targets must be classes.t _sa_propagate_class_eventss. Can't assign an event directly to the %s classi ( t dispatch_targett
isinstancet typet AssertionErrorR- R8 R t InvalidRequestErrort popR t __subclasses__R t update_subclasst _assign_cls_collectiont
appendleftt
_listen_fnR t _stored_in_collection( R t event_keyt propagatet targett stackt cls( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt insertv s" c C� s� | j } t | t � s$ t d � � t | d t � sL t j d | � � n | g } x� | r� | j d � } | j | j
� � | | k r� | | j k r� | j | � qX | | j k r� | j
| � n | j | j | j � qX Wt j | | � d S( Ns* Class-level Event targets must be classes.RC s. Can't assign an event directly to the %s classi ( RD RE RF RG R- R8 R RH RI R RJ R RK RL R RN R RO ( R RP RQ RR RS RT ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s" c C� s< t | d t � r( t j � | j | <n t � | j | <d S( NRC ( R- R8 t collectionst dequeR R ( R RR ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRL � s c C� s� | | j k r | j | � n | j | } xZ | j d D]K } | | j k r: | j g | j | D] } | | k rc | ^ qc � q: q: Wd S( Ni ( R RL t __mro__R ( R RR t clslevelRT R2 ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRK � s
c C� s~ | j } | g } xU | ri | j d � } | j | j � � | | j k r | j | j | j � q q Wt j | | � d S( Ni ( RD RI R RJ R R RN R t _removed_from_collection( R RP RR RS RT ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s c C� sN t � } x. | j j � D] } | j | � | j � q Wt j | | � d S( s Clear all class level listenersN( t setR t valuesR? R R t _clear( R t to_cleart
dispatcher( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s
c C� s | S( s� Return an event collection which can be modified.
For _ClsLevelDispatch at the class level of
a dispatcher, this returns self.
( ( R t obj( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt
for_modify� s ( R R R R R R ( R R R/ R R4 R< R6 RU R RL RK R R Ra ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR F s"
t _InstanceLevelDispatchc B� s e Z d Z d � Z RS( c C� s | j j | | � S( N( t parentR< ( R R2 R; ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR< � s ( ( R R R R< ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRb � s t _EmptyListenerc B� s~ e Z d Z e � Z d Z d Z d � Z d � Z d � Z e Z
Z Z Z
Z d � Z d � Z d � Z d
� Z e Z RS(
s� 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.
Rc t parent_listenersR c C� sH | | j k r | j | � n | | _ | j | | _ | j | _ d S( N( R RK Rc Re R ( R Rc t
target_cls( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR4 � s
c C� sh t | j | j � } t | | j � | k rC t | | j | � n! t t | | j � t � sd t � | S( s� 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.
( t _ListenerCollectionRc t
_instance_clsR- R t setattrRE t _JoinedListenerRG ( R R` t result( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRa � s
!c O� s t d � � d S( Ns need to call for_modify()( t NotImplementedError( R R' R@ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt
_needs_modify� s c O� s% x | j D] } | | | � q
Wd S( s Execute this event.N( Re ( R R' R@ R2 ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt __call__� s c C� s
t | j � S( N( t lenRe ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt __len__ s c C� s
t | j � S( N( R Re ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR s c C� s
t | j � S( N( R( Re ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt __bool__ s ( ( Rc Re R ( R R R/ t frozensetRQ t listenersR R4 Ra Rm t exec_onceRU R R R Rn Rp R Rq t __nonzero__( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRd � s t _CompoundListenerc B� sJ e Z d Z d � Z d � Z d � Z d � Z d � Z d � Z e Z RS( t _exec_once_mutext
_exec_oncec C� s
t j � S( N( R t Lock( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt _memoized_attr__exec_once_mutex s c O� sJ | j sF | j �/ | j s= z | | | � Wd t | _ Xn Wd QXn d S( s] Execute this event, but only if it has not been
executed already for this collection.N( Rx Rw R8 ( R R' R@ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRt s
c O� sF x | j D] } | | | � q
Wx | j D] } | | | � q+ Wd S( s Execute this event.N( Re Rs ( R R' R@ R2 ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRn # s c C� s t | j � t | j � S( N( Ro Re Rs ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRp + s c C� s t | j | j � S( N( R Re Rs ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR . s c C� s t | j p | j � S( N( R( Rs Re ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRq 1 s ( Rw Rx (
R R R Rz Rt Rn Rp R Rq Ru ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRv s Rg c B� sV e Z d Z d Z d � Z d � Z e d � Z d
� Z d � Z d � Z
d
� Z RS( s� 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.
Re Rc R Rs RQ R c C� sl | | j k r | j | � n t | _ | j | | _ | | _ | j | _ t j � | _ t
� | _ d S( N( R RK t FalseRx Re Rc R RV RW Rs R[ RQ ( R Rc Rf ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR4 J s c C� s | S( s� Return an event collection which can be modified.
For _ListenerCollection at the instance level of
a dispatcher, this returns self.
( ( R R` ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRa T s c C� s� | j } t | � } | j j | j � g | j D]. } | | k rK | sZ | | j k r2 | ^ q2 } | j | � | j j | � } t j | | | � d S( sM Populate from the listeners in another :class:`_Dispatch`
object.N( Rs R[ RQ R? R t unionR t _stored_in_collection_multi( R R t only_propagatet existing_listenerst existing_listener_sett lt other_listenerst to_associate( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt _update] s
c C� s8 | j | | j � r4 | r4 | j j | j � q4 n d S( N( t prepend_to_listRs RQ t addRN ( R RP RQ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRU q s c C� s8 | j | | j � r4 | r4 | j j | j � q4 n d S( N( t append_to_listRs RQ R� RN ( R RP RQ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR v s c C� s: | j j | j � | j j | j � t j | | � d S( N( Rs R RN RQ t discardR RZ ( R RP ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR { s c C� s1 t j | | j � | j j � | j j � d S( N( R R] Rs RQ R ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s
( Re Rc R Rs RQ R ( R R R/ R R4 Ra R8 R� RU R R R ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRg 7 s
Rj c B� s\ e Z d Z d � Z e d � � Z d � Z d � Z d � Z d � Z d
� Z
d � Z RS(
Rc R t localRe c C� s4 t | _ | | _ | | _ | | _ | j | _ d S( N( R{ Rx Rc R R� Re ( R Rc R R� ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR4 � s
c C� s t | j | j � S( N( R- Rc R ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRs � s c C� s | j j | | � S( N( R� R< ( R R2 R; ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR< � s c C� s | j j | � | _ | _ | S( N( R� Ra Re ( R R` ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRa � s c C� s | j j | | � d S( N( R� RU ( R RP RQ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRU � s c C� s | j j | | � d S( N( R� R ( R RP RQ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s c C� s | j j | � d S( N( R� R ( R RP ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s c C� s
t � � d S( N( Rl ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyR � s ( Rc R R� Re ( R R R R4 t propertyRs R< Ra RU R R R ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyRj � s ( R/ t
__future__R R RV t itertoolsR R
R% R R R R R t
MemoizedSlotsR t objectR R Rb Rd Rv Rg Rj ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/event/attr.pyt <module> s$ �=&O
Mini Shell