JezK
Edit File: queue.pyc
� 1��fc @ s d 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 d g Z d e f d � � YZ d e f d � � YZ d d d � � YZ d d d � � YZ d e f d � � YZ d S( s� An adaptation of Py2.3/2.4's Queue module which supports reentrant behavior, using RLock instead of Lock for its mutex object. The Queue object is used exclusively by the sqlalchemy.pool.QueuePool class. This is to support the connection pool's usage of weakref callbacks to return connections to the underlying Queue, which can in extremely rare cases be invoked within the ``get()`` method of the Queue itself, producing a ``put()`` inside the ``get()`` and therefore a reentrant condition. i����( t deque( t timei ( t compat( t threading( t asyncio( t await_fallback( t await_only( t memoized_propertyt Emptyt Fullt Queuec B s e Z d Z RS( s4 Exception raised by Queue.get(block=0)/get_nowait().( t __name__t __module__t __doc__( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR # s c B s e Z d Z RS( s4 Exception raised by Queue.put(block=0)/put_nowait().( R R R ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR ) s c B s� e Z d e d � Z d � Z d � Z d � Z e d d � Z d � Z e d d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( i c C sS | j | � t j � | _ t j | j � | _ t j | j � | _ | | _ d S( s� Initialize a queue object with a given maximum size. If `maxsize` is <= 0, the queue size is infinite. If `use_lifo` is True, this Queue acts like a Stack (LIFO). N( t _initR t RLockt mutext Conditiont not_emptyt not_fullt use_lifo( t selft maxsizeR ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt __init__0 s c C s | j � | j � SWd QXd S( s9 Return the approximate size of the queue (not reliable!).N( R t _qsize( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt qsizeG s c C s | j � | j � SWd QXd S( sK Return True if the queue is empty, False otherwise (not reliable!).N( R t _empty( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt emptyM s c C s | j � | j � SWd QXd S( sJ Return True if the queue is full, False otherwise (not reliable!).N( R t _full( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt fullT s c C s� | j �� | s( | j � r� t � q� n� | d k rW x� | j � rS | j j � q7 Wnm | d k rr t d � � n t � | } xB | j � r� | t � } | d k r� t � n | j j | � q� W| j | � | j j � Wd QXd S( s Put an item into the queue. If optional args `block` is True and `timeout` is None (the default), block if necessary until a free slot is available. If `timeout` is a positive number, it blocks at most `timeout` seconds and raises the ``Full`` exception if no free slot was available within that time. Otherwise (`block` is false), put an item on the queue if a free slot is immediately available, else raise the ``Full`` exception (`timeout` is ignored in that case). i s# 'timeout' must be a positive numberg N( R R R t Nonet waitt ValueErrort _timet _putR t notify( R t itemt blockt timeoutt endtimet remaining( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt put[ s" c C s | j | t � S( s� Put an item into the queue without blocking. Only enqueue the item if a free slot is immediately available. Otherwise raise the ``Full`` exception. ( R) t False( R R$ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt put_nowait{ s c C s� | j �� | s( | j � r� t � q� n� | d k rW x� | j � rS | j j � q7 Wnm | d k rr t d � � n t � | } xB | j � r� | t � } | d k r� t � n | j j | � q� W| j � } | j j � | SWd QXd S( s Remove and return an item from the queue. If optional args `block` is True and `timeout` is None (the default), block if necessary until an item is available. If `timeout` is a positive number, it blocks at most `timeout` seconds and raises the ``Empty`` exception if no item was available within that time. Otherwise (`block` is false), return an item if one is immediately available, else raise the ``Empty`` exception (`timeout` is ignored in that case). i s# 'timeout' must be a positive numberg N( R R R R R R R! t _getR R# ( R R% R& R' R( R$ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt get� s$ c C s | j t � S( s� Remove and return an item from the queue without blocking. Only get an item if one is immediately available. Otherwise raise the ``Empty`` exception. ( R- R* ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt get_nowait� s c C s | | _ t � | _ d S( N( R R t queue( R R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s t | j � S( N( t lenR/ ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s | j S( N( R/ ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s% | j d k o$ t | j � | j k S( Ni ( R R0 R/ ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s | j j | � d S( N( R/ t append( R R$ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR" � s c C s' | j r | j j � S| j j � Sd S( N( R R/ t popt popleft( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR, � s N( R R R* R R R R t TrueR R) R+ R- R. R R R R R" R, ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR / s t AsyncAdaptedQueuec B s} e Z e e � Z d e d � Z d � Z d � Z d � Z e d � � Z d � Z e d d � Z d � Z e d d � Z RS( i c C s | | _ | | _ d S( N( R R ( R R R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s | j j � S( N( t _queueR ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s | j j � S( N( R6 R ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s | j j � S( N( R6 R ( R ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR � s c C s: | j r! t j d | j � } n t j d | j � } | S( NR ( R R t LifoQueueR R ( R R/ ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR6 � s c C sG y | j j | � SWn, t j k rB } t j t � d | �n Xd S( Nt replace_context( R6 R+ R t QueueFullR t raise_R ( R R$ t err( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR+ � s c C s� | s | j | � SyN | d k rG | j t j | j j | � | � � S| j | j j | � � SWn5 t j t j f k r� } t j t � d | �n Xd S( NR8 ( R+ R t await_R t wait_forR6 R) R9 t TimeoutErrorR R: R ( R R$ R% R& R; ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR) � s c C sD y | j j � SWn, t j k r? } t j t � d | �n Xd S( NR8 ( R6 R. R t QueueEmptyR R: R ( R R; ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR. s c C s� | s | j � SyH | d k rA | j t j | j j � | � � S| j | j j � � SWn5 t j t j f k r� } t j t � d | �n Xd S( NR8 ( R. R R< R R= R6 R- R? R> R R: R ( R R% R& R; ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR- s N( R R t staticmethodR R< R* R R R R R R6 R+ R4 R R) R. R- ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyR5 � s t FallbackAsyncAdaptedQueuec B s e Z e e � Z RS( ( R R R@ R R< ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyRA " s N( ( ( R t collectionsR R R! t R R t concurrencyR R R t langhelpersR t __all__t ExceptionR R R R5 RA ( ( ( sH /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/util/queue.pyt <module> s �T