U r\jk5@s<dZddlZddlZddlZddlmZddlmZddlmZddlm Z ddlm Z dd lm Z d d lm Z d Z d aed ddkrdZ ejrdanedddkrdad0ddZddZd1ddZd2ddZd3ddZd4ddZd5d d!Zd6d"d#Zd$d%Zd7d&d'Zd(d)Zd*d+Zd8d,d-Zd9d.d/ZdS):zSHelpers related to deprecation of functions, methods, classes, other functionality.N)compat)_hash_limit_string)_warnings_warn) decorator)inject_docstring_text)inject_param_text)excFSQLALCHEMY_WARN_20false)trueyes1TZSQLALCHEMY_SILENCE_UBER_WARNINGcCsHt|tjr"ts"tst||dS|||d}||_t||dddS)Ncoder stacklevel) issubclassr Base20DeprecationWarningr SILENCE_UBER_WARNING_emit_uber_warningdeprecated_sincer)msgversiontype_rrwarnrS/root/pica-gateway/venv/lib/python3.8/site-packages/sqlalchemy/util/deprecations.py_warn_with_version)s   rcCstrdSdatj}t|do2|o2tjddk}d}|rR|dddd d d }n|d d d d d d }||}t||d ddS)NTisattyTERMdumba%(red)sDeprecated API features detected! These feature(s) are not compatible with SQLAlchemy 2.0. %(green)sTo prevent incompatible upgrades prior to updating applications, ensure requirements files are pinned to "sqlalchemy<2.0". %(cyan)sSet environment variable SQLALCHEMY_WARN_20=1 to show all deprecation warnings. Set environment variable SQLALCHEMY_SILENCE_UBER_WARNING=1 to silence this message.%(nocolor)szzzzz)redcyangreenmagentaZnocolorrr) rsysstderrhasattrr osenvirongetr)rrfile_Z use_colorrrrrrr9s8    rcCst||tj||ddSNr)rr SADeprecationWarning)rrrrrrrwarn_deprecatedlsr2cCs(|rt|d|}t||tj||ddS)zhIssue a deprecation warning with a parameterized string, limiting the number of registrations. rN)rrr r1)rargsrrrrrrwarn_deprecated_limitedrs r5cCst|tjjtj||ddSr0)rr RemovedIn20Warningr)rrrrrrwarn_deprecated_20~sr7__init__cs&dp dffdd}|S)N.. deprecated:: %s %sr'cst|tjtdS)Nfunc)_decorate_cls_with_warningr r1dictcls constructorheadermessagerrrdecorates z deprecated_cls..decorater)rrCrArDrr@rdeprecated_clss rEcsJd||s dndf|r$d|7|r0tjntjfdd}|S)Nzg.. deprecated:: 1.4 The %s class is considered legacy as of the 1.x series of SQLAlchemy and %s in 2.0.will be removedbecomes a legacy construct cst|jS)N)r<rr>rArC warning_clsrrrDsz#deprecated_20_cls..decorate)r LegacyAPIWarningr6)Zclsname alternativerAbecomes_legacyrDrrIrdeprecated_20_clss   rNcs|dkrdkrtjd|r0dp(dfnddkr@ddkrNtjtjk rdd7fdd }|S) aDecorates a function and issues a deprecation warning on use. :param version: Issue version in the warning. :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. 2.0N1.4r9r'z$Call to deprecated function %(func)sz (deprecated since: %s)cs t|t|jddS)Nr:)enable_warnings)_decorate_with_warningr=__name__)fnrQrBrCrwarningrrrDszdeprecated..decorate)r r6r1)rrCZadd_deprecation_to_docstringrVrQrDrrUr deprecateds$   rWcKstd|tjd|S)NrOrCrV)rO)rWr ZMovedIn20Warning)rCkwrrrmoved_20srZc Kstd|}|r(dddd|d}nd}d|||s:d nd f}d |krt|d d }|st|dd ksttd||r|d|7}|rtj}ntj}t d||d|S)Nz^:(attr|func|meth): attributefunctionmethod)attrr;methrZ constructzPThe %s %s is considered legacy as of the 1.x series of SQLAlchemy and %s in 2.0.rFrGz:attr:Zwarn_on_attribute_accessFrQzattribute %s will emit a warning on read access. If you *really* want this, add warn_on_attribute_access=True. Otherwise please add enable_warnings=False.rHrOrX)rO) rematchgrouppopr-AssertionErrorr rKr6rW) Zapi_namerLrMrYZtype_regrrCZ attribute_okrJrrr deprecated_20s:     rec sdiiiD]8\}\}}||<t||<|dkrBtjntj|<qfdd}|S)a"Decorates a function to warn on use of certain parameters. e.g. :: @deprecated_params( weak_identity_map=( "0.7", "the :paramref:`.Session.weak_identity_map parameter " "is deprecated." ) ) rOcst|}|jdk r\tt|jt|jt|jd|jtt n dt|j t fdd}|j dk r|j pd}|rt |ddD}||}||_ |S)NrcsD]T}|dkr ||dk s<|dk r|||krt|||ddqkrt|rtddD](}||krt|||ddq|||SNr/r)rset difference)rTr4kwargsm) check_any_kwcheck_defaultscheck_kwdefaultsmessagesversion_warningsversionsrrwarnedWs< z3deprecated_params..decorate..warnedr'cSs2i|]*\}\}}|d|dkr dn||p(dfqS)r9rOrPr'r).0paramrrCrrr }s  z7deprecated_params..decorate..)rZinspect_getfullargspecrnr=zipr4lenrg intersectionrhvarkwr__doc__ritems)rTspecrrdoc decoratedrospecsrprq)rkrlrmrnrrDEs4  !z#deprecated_params..decorate)r{_sanitize_restructured_textr r6r1)rrtrrCrDrrrdeprecated_params(s BrcCs(dd}tddd|}td||S)NcSs$|dd\}}|dkr |d7}|S)Nrr )r;r_z()rb)rjrnamerrrreplsz)_sanitize_restructured_text..replz:ref:`(.+) <.*>`cSsd|dS)Nz"%s"rr)rjrrrz-_sanitize_restructured_text..z\:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)r`sub)textrrrrrsrc Cs|jdk r|jpd}|dk r|dk r2|t|d;}t|tjrF|d7}t||d}t|tkrt|j}||d<|dd|ddt|j |j |}|dk r||}n||_|dk rt ||}|dk rt ||t ||||d|S)Nr'r:@ (Background on SQLAlchemy 2.0 at: :ref:`migration_20_toplevel`)rrz__dict__ __weakref__)rzr=rr rrtyperrcrS __bases__getattrsetattrrR) r?rAwtyperCrdocstring_headerr}ZclsdictZconstructor_fnrrrr<sB        r<c stttjrd}nd}tfdd}|jdk rD|jpFd}|dk rt|t|jd;}||7}t||d}||} || _fdd | _ | S) z=Wrap a function with a warnings.warn and augmented docstring.rr'cs0 p|dd}|s&tdd|||S)NZ_sa_skip_warningFr/r)rcr)rTr4riZ skip_warningrQrCrrrrrrs z&_decorate_with_warning..warnedNr:rcstddSrf)rr)rCrrrrrs z(_decorate_with_warning..) rrr rrrzr=rSrZ_sa_warn) r;rrCrrrQZdoc_onlyrrr}r~rrrrRs   rR)N)r/N)r/N)r/N)r8)Nr8F)NTNT)NF)N)NT) rzr+r`r(r'rZ langhelpersrrrrrr r rgetenvlowerZpy2krrr2r5r7rErNrWrZrerrr<rRrrrrsT        3   % = )b *