ó
x“EYc@s
dZd
dl
Z
d
dlZd
dlZd
dlmZ
d
dlmZ
d
dlmZ
d
dlm	Z	
d
dl
Z
d
dlmZ
d
dl
mZ
d
d	l
mZ
e
jeƒ
Zd
„Zd„Zd„Zd
ef
d„ƒYZdef
d„ƒYZdS(s

=================================
Multiple DB API backend support.
=================================

A DB backend module should implement a method named 'get_backend' which
takes no arguments. The method can return any object that implements DB
API methods.
iÿÿÿÿN(
tremovals(
texcutils(
timportutils(
t
reflection(
t_LE(
t	exception(
toptionsc

Cst|j
d
<|S(sÄ
Indicate api method as safe for re-connection to database.

    Database connection retries will be enabled for the decorated api method.
    Database connection failure can have many causes, which can be temporary.
    In such cases retry may increase the likelihood of connection.

    Usage::

        @safe_for_db_retry
        def api_method(self):
            self.engine.connect()


    :param f: database api method.
    :type f: function.
    tenable_retry_on_disconnect(tTruet__dict__(
t
f((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pytsafe_for_db_retry,s

c

Cst|j
d
<|S(sRetry a DB API call if Deadlock was received.

    wrap_db_entry will be applied to all db.api functions marked with this
    decorator.
    tenable_retry_on_deadlock(RR	(
R
((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pytretry_on_deadlockAs

c

Cst|j
d
<|S(s›Retry a DB API call if RetryRequest exception was received.

    wrap_db_entry will be applied to all db.api functions marked with this
    decorator.
    tenable_retry_on_request(RR	(
R
((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pytretry_on_requestKs

t
wrap_db_retryc
BsVeZ
dZejd
dƒddedeeed„d„ƒ
Zd„Zd	„Z	RS(
sRetry db.api methods, if db_error raised

    Retry decorated db.api methods. This decorator catches db_error and retries
    function in a loop until it succeeds, or until maximum retries count
    will be reached.

    Keyword arguments:

    :param retry_interval: seconds between transaction retries
    :type retry_interval: int or float

    :param max_retries: max number of retries before an error is raised
    :type max_retries: int

    :param inc_retry_interval: determine increase retry interval or not
    :type inc_retry_interval: bool

    :param max_retry_interval: max interval value between retries
    :type max_retry_interval: int or float

    :param exception_checker: checks if an exception should trigger a retry
    :type exception_checker: callable
    Rs"Retry on request is always enabledi
ii
c


CstS(
N(
tFalse(
texc((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyt<lambda>tsc		Cstt
|ƒjƒ
tjf
|_||_|rI|jtjf
7_n|rg|jtjf
7_n|
|_	||_
||_||_dS(
N(
tsuperRt__init__RtRetryRequesttdb_errortexception_checkertDBConnectionErrort
DBDeadlocktretry_intervaltmax_retriestinc_retry_intervaltmax_retry_interval(	tselfRRRRtretry_on_disconnectR
RR((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyRns	




	
	
	
cs%tj
ˆƒ
‡‡
fd
†ƒ
}|S(Ncs(
ˆ
j}ˆ
j
}x
tr#
yˆ||
ŽSWqtk
r

}
tjƒ~}ˆ
j|ƒ
}|d
kru||_nO|r‘tj	t
dƒ
ƒ

nt|t	jƒrÄt
|jƒ
|_|j|_nWdQXtjdtjˆƒ
ƒ
tj|ƒ

ˆ
jr
t|dˆ
jƒ}n|d8}qXqWdS(NisDB exceeded retry limit.s#Performing DB retry for function %sii
(RRRt	ExceptionR
tsave_and_reraise_exceptiont_is_exception_expectedtreraisetLOGRRt
isinstanceRttypet	inner_excttype_tvaluetdebugRtget_callable_namettimetsleepRtminR(targstkwargst
next_intervalt	remainingt
etectxttexpected(R
R(s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pytwrapper„s.	
		











	


	


(tsixtwraps(RR
R7((R
Rs@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyt__call__ƒs
!!cCsHt|
|j
ƒr;t|
tjƒs7tjd
|
ƒ
ntS|j|
ƒ
S(NsDB error: %s(R&RRRR%R+RR(RR((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyR#§s




(
t__name__t
__module__t__doc__Rt
removed_kwargRRRR:R#(((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyRUs	





	$tDBAPIcBsDeZ
dZded
„Zd„Zd„Zeded„ƒ
Z	RS(s2Initialize the chosen DB API backend.

    After initialization API methods is available as normal attributes of
    ``DBAPI`` subclass. Database API methods are supposed to be called as
    DBAPI instance methods.

    :param backend_name: name of the backend to load
    :type backend_name: str

    :param backend_mapping: backend name -> module/class to load mapping
    :type backend_mapping: dict
    :default backend_mapping: None

    :param lazy: load the DB backend lazily on the first DB API method call
    :type lazy: bool
    :default lazy: False

    :keyword use_db_reconnect: retry DB transactions on disconnect or not
    :type use_db_reconnect: bool

    :keyword retry_interval: seconds between transaction retries
    :type retry_interval: int

    :keyword inc_retry_interval: increase retry interval or not
    :type inc_retry_interval: bool

    :keyword max_retry_interval: max interval value between retries
    :type max_retry_interval: int

    :keyword max_retries: max number of retries before an error is raised
    :type max_retries: int
    cKsud|_
|
|_|pi|_tjƒ|_|sC|jƒ
n|jd
t	ƒ|_
d„|jƒDƒ
|_dS(Ntuse_db_reconnectc
Ss+i|]!\}
}|
dkr||
“qS(RRRR(sretry_intervalsinc_retry_intervalsmax_retry_intervalsmax_retries((t.0t
kt
v((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pys
<dictcomp>às
		



(
tNonet_backendt
_backend_namet_backend_mappingt	threadingtLockt_lockt
_load_backendtgetRR@titemst_wrap_db_kwargs(Rtbackend_nametbackend_mappingtlazyR1((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyRÔs	
	




c
	Csz|jk
|j
sp|jj|j|jƒ}
tjd
i|jd6|
d6ƒ
tj|
ƒ
}|j	ƒ|_
nWdQXdS(Ns&Loading backend %(name)r from %(path)rtnametpath(
RJRERGRLRFR%R+Rt
import_moduletget_backend(Rtbackend_pathtbackend_mod((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyRKæs


	

	




cCs½|js|j
ƒ
nt|j|
ƒ}t|d
ƒs;|S|joV|jjdtƒ}|jjdtƒ}|jjdtƒ}|s•|s•|r¹td|d||j	|ƒ
}n|S(NR:RRRR R
(
RERKtgetattrthasattrR@R	RLRRRN(RtkeytattrR R
R((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyt__getattr__òs 
	






	




cCsn|
jt
jd
ƒ
|d|
jjd|d|d|
jjd|
jjd|
jjd|
jjd	|
jj	ƒS(
sy
Initialize DBAPI instance given a config instance.

        :param conf: oslo.config config instance
        :type conf: oslo.config.cfg.ConfigOpts

        :param backend_mapping: backend name -> module/class to load mapping
        :type backend_mapping: dict

        :param lazy: load the DB backend lazily on the first DB API method call
        :type lazy: bool

        tdatabaseRORPRQR@RRRR(
t
register_optsRt
database_optsR]tbackendR@tdb_retry_intervaltdb_inc_retry_intervaltdb_max_retry_intervaltdb_max_retries(tclstconfRPRQ((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pytfrom_config

s






N(
R;R<R=RDRRRKR\tclassmethodRg(((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyR?²s 		
(R=tloggingRHR-t
debtcollectorRt
oslo_utilsR
RRR8t
oslo_db._i18nRtoslo_dbRRt	getLoggerR;R%RR
RtobjectRR?(((s@/home/tvault/.virtenv/lib/python2.7/site-packages/oslo_db/api.pyt<module>s"







		
	
]