/
opt
/
alt
/
python27
/
lib64
/
python2.7
/
site-packages
/
sqlalchemy
/
pool
/
up file
home
� 1��fc @ sM d d l m Z d d l m Z d d l m Z d e j f d � � YZ d S( i ( t Pooli ( t event( t Enginet PoolEventsc B s� e Z d Z d Z e Z e d � � Z e d � � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z d � Z RS( s� Available events for :class:`_pool.Pool`. The methods here define the name of an event as well as the names of members that are passed to listener functions. e.g.:: from sqlalchemy import event def my_on_checkout(dbapi_conn, connection_rec, connection_proxy): "handle an on checkout event" event.listen(Pool, 'checkout', my_on_checkout) In addition to accepting the :class:`_pool.Pool` class and :class:`_pool.Pool` instances, :class:`_events.PoolEvents` also accepts :class:`_engine.Engine` objects and the :class:`_engine.Engine` class as targets, which will be resolved to the ``.pool`` attribute of the given engine or the :class:`_pool.Pool` class:: engine = create_engine("postgresql://scott:tiger@localhost/test") # will associate with engine.pool event.listen(engine, 'checkout', my_on_checkout) t SomeEngineOrPoolc C s� t | t � r8 t | t � r" t St | t � r� | Snd t | t � rN | j St | t � ra | St | d � r� t | j j d � r� | j j j � n d Sd S( Nt dispatcht _no_async_engine_events( t isinstancet typet issubclassR R t poolt hasattrR t _eventsR t None( t clst target( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt _accept_with- s c K s- | j } | j d | j � | j | � d S( Nt asyncio( t dispatch_targett setdefaultt _is_asynciot base_listen( R t event_keyt kwR ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt _listen? s c C s d S( s Called at the moment a particular DBAPI connection is first created for a given :class:`_pool.Pool`. This event allows one to capture the point directly after which the DBAPI module-level ``.connect()`` method has been used in order to produce a new DBAPI connection. :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. N( ( t selft dbapi_connectiont connection_record( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt connectG t c C s d S( s% Called exactly once for the first time a DBAPI connection is checked out from a particular :class:`_pool.Pool`. The rationale for :meth:`_events.PoolEvents.first_connect` is to determine information about a particular series of database connections based on the settings used for all connections. Since a particular :class:`_pool.Pool` refers to a single "creator" function (which in terms of a :class:`_engine.Engine` refers to the URL and connection options used), it is typically valid to make observations about a single connection that can be safely assumed to be valid about all subsequent connections, such as the database version, the server and client encoding settings, collation settings, and many others. :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. N( ( R R R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt first_connectW R c C s d S( s� Called when a connection is retrieved from the Pool. :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. :param connection_proxy: the :class:`._ConnectionFairy` object which will proxy the public interface of the DBAPI connection for the lifespan of the checkout. If you raise a :class:`~sqlalchemy.exc.DisconnectionError`, the current connection will be disposed and a fresh connection retrieved. Processing of all checkout listeners will abort and restart using the new connection. .. seealso:: :meth:`_events.ConnectionEvents.engine_connect` - a similar event which occurs upon creation of a new :class:`_engine.Connection`. N( ( R R R t connection_proxy( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt checkoutp R c C s d S( s� Called when a connection returns to the pool. Note that the connection may be closed, and may be None if the connection has been invalidated. ``checkin`` will not be called for detached connections. (They do not return to the pool.) :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. N( ( R R R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt checkin� R c C s d S( s Called before the "reset" action occurs for a pooled connection. This event represents when the ``rollback()`` method is called on the DBAPI connection before it is returned to the pool or discarded. A custom "reset" strategy may be implemented using this event hook, which may also be combined with disabling the default "reset" behavior using the :paramref:`_pool.Pool.reset_on_return` parameter. The primary difference between the :meth:`_events.PoolEvents.reset` and :meth:`_events.PoolEvents.checkin` events are that :meth:`_events.PoolEvents.reset` is called not just for pooled connections that are being returned to the pool, but also for connections that were detached using the :meth:`_engine.Connection.detach` method. Note that the event **is not** invoked for connections that were invalidated using :meth:`_engine.Connection.invalidate`. These events may be intercepted using the :meth:`.PoolEvents.soft_invalidate` and :meth:`.PoolEvents.invalidate` event hooks, and all "connection close" events may be intercepted using :meth:`.PoolEvents.close`. The :meth:`_events.PoolEvents.reset` event is usually followed by the :meth:`_events.PoolEvents.checkin` event, except in those cases where the connection is discarded immediately after reset. In the 1.4 series, the event is also not invoked for asyncio connections that are being garbage collected without their being explicitly returned to the pool. This is due to the lack of an event loop which prevents "reset" operations from taking place. Version 2.0 will feature an enhanced version of :meth:`.PoolEvents.reset` which is invoked in this scenario while passing additional contextual information indicating that an event loop is not guaranteed to be present. :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. .. seealso:: :meth:`_events.ConnectionEvents.rollback` :meth:`_events.ConnectionEvents.commit` N( ( R R R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt reset� R c C s d S( s| Called when a DBAPI connection is to be "invalidated". This event is called any time the :meth:`._ConnectionRecord.invalidate` method is invoked, either from API usage or via "auto-invalidation", without the ``soft`` flag. The event occurs before a final attempt to call ``.close()`` on the connection occurs. :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. :param exception: the exception object corresponding to the reason for this invalidation, if any. May be ``None``. .. versionadded:: 0.9.2 Added support for connection invalidation listening. .. seealso:: :ref:`pool_connection_invalidation` N( ( R R R t exception( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt invalidate� R c C s d S( sa Called when a DBAPI connection is to be "soft invalidated". This event is called any time the :meth:`._ConnectionRecord.invalidate` method is invoked with the ``soft`` flag. Soft invalidation refers to when the connection record that tracks this connection will force a reconnect after the current connection is checked in. It does not actively close the dbapi_connection at the point at which it is called. .. versionadded:: 1.0.3 :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. :param exception: the exception object corresponding to the reason for this invalidation, if any. May be ``None``. N( ( R R R R# ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt soft_invalidate� R c C s d S( s� Called when a DBAPI connection is closed. The event is emitted before the close occurs. The close of a connection can fail; typically this is because the connection is already closed. If the close operation fails, the connection is discarded. The :meth:`.close` event corresponds to a connection that's still associated with the pool. To intercept close events for detached connections use :meth:`.close_detached`. .. versionadded:: 1.1 :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. N( ( R R R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt close� R c C s d S( s� Called when a DBAPI connection is "detached" from a pool. This event is emitted after the detach occurs. The connection is no longer associated with the given connection record. .. versionadded:: 1.1 :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. :param connection_record: the :class:`._ConnectionRecord` managing the DBAPI connection. N( ( R R R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt detach R c C s d S( s� Called when a detached DBAPI connection is closed. The event is emitted before the close occurs. The close of a connection can fail; typically this is because the connection is already closed. If the close operation fails, the connection is discarded. .. versionadded:: 1.1 :param dbapi_connection: a DBAPI connection. The :attr:`._ConnectionRecord.dbapi_connection` attribute. N( ( R R ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt close_detached" R ( t __name__t __module__t __doc__t _target_class_docR t _dispatch_targett classmethodR R R R R R! R" R$ R% R& R' R( ( ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyR s 0 N( t baseR R R t engine.baseR t EventsR ( ( ( sI /opt/alt/python27/lib64/python2.7/site-packages/sqlalchemy/pool/events.pyt <module> s