ó H`¾Tc@s«dZddlmZddlZddlZddlmZdd„Zdd „Zde d „Z de 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((sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytwarn_deprecatedscCstj|tjd|ƒdS(NR(RRRtSAPendingDeprecationWarning(RR((sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytwarn_pending_deprecationscsP|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)scs&t|tjˆtd|jƒˆƒS(Ntfunc(t_decorate_with_warningRRtdictt__name__(tfn(theadertmessage(sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytdecorate0s N(tNone(tversionRtadd_deprecation_to_docstringR((RRsb/var/www/send.findwatt.com/datamanager/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)scs&t|tjˆtd|jƒˆƒS(NR (R RRR R(R(RR(sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyRRs N(R(RRRR((RRsb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytpending_deprecation7s  cCsd„}tjd||ƒS(NcSs5|jddƒ\}}|dkr1|d7}n|S(NiiR tmeths()(sfuncR(tgroup(tmttype_tname((sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytreplZs  s\:(\w+)\:`~?\.?(.+?)`(tretsub(ttextR((sb/var/www/send.findwatt.com/datamanager/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.cs&tjˆˆƒddƒ|||ŽS(NRi(RR(Rtargstkwargs(twtypeR(sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pytwarnedgsR R iN(R!Rt__doc__RR Rtinject_docstring_text(R R$Rtdocstring_headerR%tdoct decorated((R$Rsb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyR bs    cCsi|jddƒ}t|ƒdkr(|S|\}}|jdƒsX|dtj|ƒStj|ƒSdS(Ns it (tsplittlent startswithttextwraptdedent(R t split_textt firstlinet remaining((sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyt_dedent_docstringys c CsÚt|p dƒ}|jdƒ}tj|ƒjdƒ}|drV|jddƒngt|ƒD]\}}|jƒsc|^qc}|jddƒ|t|t|ƒdƒ}|d|!|||}dj |ƒS(NR s ii( R4R,R/R0tinsertt enumeratetstriptminR-tjoin( tdoctextt injecttexttpostlinest injectlinestnumtlinetblankst inject_pos((sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyR'…s 1(R&R RRRt langhelpersRRR RtTrueRRR!R R/R4R'(((sb/var/www/send.findwatt.com/datamanager/lib/python2.7/site-packages/sqlalchemy/util/deprecations.pyt s     !