Your IP : 172.28.240.42

Current Path : /usr/lib/python2.7/dist-packages/twisted/enterprise/
Upload File :
Current File : //usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyc


[XMc@sdZddlZddlmZddlmZmZddlmZddl	m
Z
defdYZd	e
fd
YZdfdYZd
fdYZe
ddddZeeZdZdZeeZdd
dgZdS(sg
An asynchronous mapping to U{DB-API 2.0<http://www.python.org/topics/database/DatabaseAPI-2.0.html>}.
iN(tthreads(treflecttlog(t
deprecated(tVersiontConnectionLostcBseZdZRS(sb
    This exception means that a db connection has been lost.  Client code may
    try again.
    (t__name__t
__module__t__doc__(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRst
ConnectioncBs;eZdZdZdZdZdZdZRS(s

    A wrapper for a DB-API connection instance.

    The wrapper passes almost everything to the wrapped connection and so has
    the same API. However, the Connection knows about its pool and also
    handle reconnecting should when the real connection dies.
    cCs ||_d|_|jdS(N(t_pooltNonet_connectiont	reconnect(tselftpool((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyt__init__#s		cCsdS(N((R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pytclose(scCs|jjs|jjdSyN|jj|jj}|j|jj|j|jjdSWnt	j
ddnX|jj|j|jj
rt	jdntdS(NsRollback failedsConnection lost.(R
R
Rtrollbacktcursortexecutetgood_sqlRtcommitRterrRt
disconnecttnoisytmsgR(Rtcurs((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR2s 



cCs;|jdk	r%|jj|jn|jj|_dS(N(RRR
Rtconnect(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR
HscCst|j|S(N(tgetattrR(Rtname((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyt__getattr__Ms(RRRRRRR
R(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR	s		
		tTransactioncBsAeZdZdZdZdZdZdZdZ	RS(sA lightweight wrapper for a DB-API 'cursor' object.

    Relays attribute access to the DB cursor. That is, you can call
    execute(), fetchall(), etc., and they will be called on the
    underlying DB-API cursor object. Attributes will also be
    retrieved from there.
    cCs ||_||_|jdS(N(R
Rtreopen(RRt
connection((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR[s		cCs |j}d|_|jdS(N(t_cursorRR(RR#((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR`s		cCs|jdk	r|jny|jj|_dSWn)|jjsNqbtjddnX|jj	r~tj
dn|j|jj|_dS(NsCursor creation failedsConnection lost, reconnecting(R#RRRRR
R
RRRR(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR!es

cCs|jjd|_dS(N(RR
RR#(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR
xs
cCst|j|S(N(RR#(RR((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR|sN(
RRRRR#RRR!R
R(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR Qs				tConnectionPoolcBseZdZdjZeZdZdZdZ
dZeZdZ
eZeZeZdZdZdZdZdZd	Zd
ZdZdZd
ZdZdZdZdZ dZ!dZ"dZ#dZ$dZ%RS(s
    Represent a pool of connections to a DB-API 2.0 compliant database.

    @ivar connectionFactory: factory for connections, default to L{Connection}.
    @type connectionFactory: any callable.

    @ivar transactionFactory: factory for transactions, default to
        L{Transaction}.
    @type transactionFactory: any callable

    @ivar shutdownID: C{None} or a handle on the shutdown event trigger
        which will be used to stop the connection pool workers when the
        reactor stops.

    @ivar _reactor: The reactor which will be used to schedule startup and
        shutdown events.
    @type _reactor: L{IReactorCore} provider
    s-min max name noisy openfun reconnect good_sqliisselect 1c	Os||_tj||_t|jdd
dkrFtjdnt|jdddkrqtjdn|jdd
}|d
krd	d
l	m
}n||_||_||_
xH|jD]=}d|}|j|rt||||||=qqWt|j|j|_t|j|j|_i|_d	dlm}d	d
l}|j|_|j|j|j|_|jj|j|_d
S(sCCreate a new ConnectionPool.

        Any positional or keyword arguments other than those documented here
        are passed to the DB-API object when connecting. Use these arguments to
        pass database names, usernames, passwords, etc.

        @param dbapiName: an import string to use to obtain a DB-API compatible
                          module (e.g. 'pyPgSQL.PgSQL')

        @param cp_min: the minimum number of connections in pool (default 3)

        @param cp_max: the maximum number of connections in pool (default 5)

        @param cp_noisy: generate informational log messages during operation
                         (default False)

        @param cp_openfun: a callback invoked after every connect() on the
                           underlying DB-API object. The callback is passed a
                           new DB-API connection object.  This callback can
                           setup per-connection state such as charset,
                           timezone, etc.

        @param cp_reconnect: detect connections which have failed and reconnect
                             (default False). Failed connections may result in
                             ConnectionLost exceptions, which indicate the
                             query may need to be re-sent.

        @param cp_good_sql: an sql query which should always succeed and change
                            no state (default 'select 1')

        @param cp_reactor: use this reactor instead of the global reactor
            (added in Twisted 10.2).
        @type cp_reactor: L{IReactorCore} provider
        tapilevels2.0s'DB API module not DB API 2.0 compliant.tthreadsafetyiis+DB API module not sufficiently thread-safe.t
cp_reactori(treactorscp_%s(t
threadpoolN(t	dbapiNameRtnamedModuletdbapiRRRRtpopttwisted.internetR(t_reactortconnargstconnkwtCP_ARGSthas_keytsetattrtmintmaxtconnectionsttwisted.pythonR)tthreadt	get_identtthreadIDt
ThreadPooltcallWhenRunningt_starttstartID(	RR*R0R1R(targtcp_argR)R9((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRs2$				
	cCsd|_|jS(N(RR?tstart(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR>s	cCsD|js@|jj|jjdd|j|_t|_ndS(s
        Start the connection pool.

        If you are using the reactor normally, this function does *not*
        need to be called.
        tduringtshutdownN(trunningR)RBR/taddSystemEventTriggert
finalCloset
shutdownIDtTrue(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRBs
	
	cOs2ddlm}tj||j|j|||S(s
        Execute a function with a database connection and return the result.

        @param func: A callable object of one argument which will be executed
            in a thread with a connection from the pool.  It will be passed as
            its first argument a L{Connection} instance (whose interface is
            mostly identical to that of a connection object for your DB-API
            module of choice), and its results will be returned as a Deferred.
            If the method raises an exception the transaction will be rolled
            back.  Otherwise, the transaction will be committed.  B{Note} that
            this function is B{not} run in the main thread: it must be
            threadsafe.

        @param *args: positional arguments to be passed to func

        @param **kw: keyword arguments to be passed to func

        @return: a Deferred which will fire the return value of
            C{func(Transaction(...), *args, **kw)}, or a Failure.
        i(R((R.R(RtdeferToThreadPoolR)t_runWithConnection(RtfunctargstkwR(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pytrunWithConnectionsc	Os|j|}y$||||}|j|SWnPtj\}}}y|jWntjddnX|||nXdS(NsRollback failed(tconnectionFactoryRtsystexc_infoRRRR(	RRLRMRNtconntresulttexcTypetexcValuetexcTraceback((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRKs
cOs2ddlm}tj||j|j|||S(s
        Interact with the database and return the result.

        The 'interaction' is a callable object which will be executed
        in a thread using a pooled connection. It will be passed an
        L{Transaction} object as an argument (whose interface is
        identical to that of the database cursor for your DB-API
        module of choice), and its results will be returned as a
        Deferred. If running the method raises an exception, the
        transaction will be rolled back. If the method returns a
        value, the transaction will be committed.

        NOTE that the function you pass is *not* run in the main
        thread: you may have to worry about thread-safety in the
        function you pass to this if it tries to use non-local
        objects.

        @param interaction: a callable object whose first argument
            is an L{adbapi.Transaction}.

        @param *args: additional positional arguments to be passed
            to interaction

        @param **kw: keyword arguments to be passed to interaction

        @return: a Deferred which will fire the return value of
            'interaction(Transaction(...), *args, **kw)', or a Failure.
        i(R((R.R(RRJR)t_runInteraction(RtinteractionRMRNR(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pytrunInteraction,scOs|j|j||S(sExecute an SQL query and return the result.

        A DB-API cursor will will be invoked with cursor.execute(*args, **kw).
        The exact nature of the arguments will depend on the specific flavor
        of DB-API being used, but the first argument in *args be an SQL
        statement. The result of a subsequent cursor.fetchall() will be
        fired to the Deferred which is returned. If either the 'execute' or
        'fetchall' methods raise an exception, the transaction will be rolled
        back and a Failure returned.

        The  *args and **kw arguments will be passed to the DB-API cursor's
        'execute' method.

        @return: a Deferred which will fire the return value of a DB-API
        cursor's 'fetchall' method, or a Failure.
        (RZt	_runQuery(RRMRN((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pytrunQueryOscOs|j|j||S(sExecute an SQL query and return None.

        A DB-API cursor will will be invoked with cursor.execute(*args, **kw).
        The exact nature of the arguments will depend on the specific flavor
        of DB-API being used, but the first argument in *args will be an SQL
        statement. This method will not attempt to fetch any results from the
        query and is thus suitable for INSERT, DELETE, and other SQL statements
        which do not return values. If the 'execute' method raises an
        exception, the transaction will be rolled back and a Failure returned.

        The args and kw arguments will be passed to the DB-API cursor's
        'execute' method.

        return: a Deferred which will fire None or a Failure.
        (RZt
_runOperation(RRMRN((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pytrunOperationcscCs^|jr(|jj|jd|_n|jrP|jj|jd|_n|jdS(sC
        Close all pool connections and shutdown the pool.
        N(RHR/tremoveSystemEventTriggerRR?RG(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRvs		cCsWd|_|jjt|_x$|jjD]}|j|q/W|jj	dS(s3This should only be called by the shutdown trigger.N(
RRHR)tstoptFalseRER7tvaluest_closetclear(RRS((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRGs	
	cCs|j}|jj|}|dkr|jretjd|j|jpNd|j	pZdfn|j
j|j|j	}|jdkr|j|n||j|<n|S(sReturn a database connection when one becomes available.

        This method blocks and should be run in a thread from the internal
        threadpool. Don't call this method directly from non-threaded code.
        Using this method outside the external threadpool may exceed the
        maximum number of connections in the pool.

        @return: a database connection from the pool.
        sadbapi connecting: %s %s%stN(
R;R7tgetRRRRR*R0R1R,Rtopenfun(RttidRS((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRs	cCs]|j}||jj|k	r3tdn|dk	rY|j||j|=ndS(sDisconnect a database connection associated with this pool.

        Note: This function should only be used by the same thread which
        called connect(). As with connect(), this function is not used
        in normal non-threaded twisted code.
        swrong connection for threadN(R;R7Rft	ExceptionRRc(RRSRh((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRs
cCsO|jr#tjd|jfny|jWntjddnXdS(Nsadbapi closing: %ssConnection close failed(RRRR*RRR(RRS((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRcs	c
Os|j|}|j||}y.||||}|j|j|SWnPtj\}}}	y|jWntjddnX|||	nXdS(NsRollback failed(
RPttransactionFactoryRRRQRRRRRR(
RRYRMRNRSttransRTRURVRW((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyRXs

cOs|j|||jS(N(Rtfetchall(RRkRMRN((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR[scOs|j||dS(N(R(RRkRMRN((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR]scCsTi|jd6|jd6|jd6|jd6|jd6|jd6|jd6|jd6S(	NR*R5R6RR
RR0R1(R*R5R6RR
RR0R1(R((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyt__getstate__s






cCs)||_|j|j|j|jdS(N(t__dict__RR*R0R1(Rtstate((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyt__setstate__s	N(&RRRtsplitR2RaRR5R6RRRgR
RRER	RPR RjRHRR>RBRORKRZR\R^RRGRRRcRXR[R]RmRp(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyR$s>	I					#				
								
tTwistediicCs|jddjddS(sK
    Something really stupid that replaces quotes with escaped quotes.
    t's''s\s\\(treplace(ttext((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyt_safescCs
t|S(s<
    Make a string safe to include in an SQL statement.
    (Rv(Ru((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pytsafesRw(RRQR.RR8RRttwisted.python.deprecateRttwisted.python.versionsRRiRtobjectR	R R$t_unreleasedVersiont_unreleasedDeprecationRvRwt__all__(((s=/usr/lib/python2.7/dist-packages/twisted/enterprise/adbapi.pyt<module>s 7/f