ó
‹EYc@s«dZd
dl
mZ
ddlZddlZddlmZ
dd„
Zdd	„
Zde
d
„Zde
d„Zd„Z
dd
„
ZddlZd„Zd„ZdS(sSHelpers related to deprecation of functions, methods, classes, other
functionality.i(
texciÿÿÿÿNi
(
t	decoratoricCstj
|tjd
|
ƒ

dS(Nt
stacklevel(twarningstwarnRtSADeprecationWarning(tmsgR((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytwarn_deprecateds
cCstj
|tjd
|
ƒ

dS(NR(RRRtSAPendingDeprecationWarning(RR((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytwarn_pending_deprecations
csP|rd
|ˆ
pdf‰nd‰ˆ
dkr:d‰
n‡‡
fd†}|S(s¨
Decorates a function and issues a deprecation warning on use.

    :param message:
      If provided, issue message in the warning.  A sensible default
      is used if not provided.

    :param add_deprecation_to_docstring:
      Default True.  If False, the wrapped function's __doc__ is left
      as-is.  If True, the 'message' is prepended to the docs if
      provided, or sensible default if message is omitted.

    s.. deprecated:: %s %sts$Call to deprecated function %(func)sc

s&t|t
jˆ
td
|jƒ
ˆƒS(Ntfunc(t_decorate_with_warningRRtdictt__name__(
tfn(theadertmessage(sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytdecorate0s

	
N(
tNone(tversionRtadd_deprecation_to_docstringR((RRsQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyt
deprecateds


	csP|rd
|ˆ
pdf‰nd‰ˆ
dkr:d‰
n‡‡
fd†}|S(sEDecorates a function and issues a pending deprecation warning on use.

    :param version:
      An approximate future version at which point the pending deprecation
      will become deprecated.  Not used in messaging.

    :param message:
      If provided, issue message in the warning.  A sensible default
      is used if not provided.

    :param add_deprecation_to_docstring:
      Default True.  If False, the wrapped function's __doc__ is left
      as-is.  If True, the 'message' is prepended to the docs if
      provided, or sensible default if message is omitted.
    s.. deprecated:: %s (pending) %sR
s$Call to deprecated function %(func)sc

s&t|t
jˆ
td
|jƒ
ˆƒS(NR(RRRR
R(
R(RR(sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyRRs

	
N(
R(RRRR((RRsQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytpending_deprecation7s


	c
Csd
„}
tj
d|
|ƒS(Nc
Ss5|jd
dƒ\}
}|
dkr1|d7}n|S(Ni
iRtmeths()(sfuncsmeth(
tgroup(t
mttype_tname((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytreplZs




s\:(\w+)\:`~?\.?(.+?)`(tretsub(ttextR((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyt_sanitize_restructured_textYs
	cs’tˆƒ
‰t
‡‡
fd
†ƒ
}|jdk	r<|jp?d}|dk	ry|td|jƒ
;}t||dƒ}n||ƒ
}||_|S(s=Wrap a function with a warnings.warn and augmented docstring.c
s#tj
ˆˆ
d
dƒ

||
|ŽS(NRi(RR(Rtargstkwargs(Rtwtype(sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytwarnedgs
R
Ri
N(R!R
t__doc__RR
Rtinject_docstring_text(RR$Rtdocstring_headerR%tdoct	decorated((RR$sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyRbs


	
c
Csi|jd
dƒ}
t
|
ƒ
dkr(|S|
\}}|jdƒ
sX|d
tj|ƒ
Stj|ƒ
SdS(Ns

i
t
 (tsplittlent
startswithttextwraptdedent(R t
split_textt	firstlinet	remaining((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyt_dedent_docstringys




c	CsÚt|pd
ƒ
}|j
dƒ
}tj|
ƒ
j
dƒ
}|drV|jdd
ƒ
ngt|ƒ
D]\}}|jƒsc|^qc}|jddƒ
|t|t|ƒ
dƒ}|d|!|||}dj	|ƒ
S(NR
s

ii
(
R4R,R/R0tinsertt	enumeratetstriptminR-tjoin(	tdoctextt
injecttexttpostlinestinjectlinestnumtlinetblankst
inject_pos((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyR'…s





1

(R&R
RRRtlanghelpersR
RR	RtTrueRRR!RR/R4R'(((sQ/home/tvault/.virtenv/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyt<module>	s



!