o i2@sdZddlZddlZddlmZddlmZddlmZddlmZddlm Z d d lm Z d$d d Z d$ddZ d$ddZ d%ddZd&ddZddZ d&ddZddZddZ d'd d!Zd'd"d#ZdS)(zSHelpers related to deprecation of functions, methods, classes, other functionality.N)compat)_hash_limit_string) decorator)inject_docstring_text)inject_param_text)exccCtj|tj|ddSN stacklevelwarningswarnr SADeprecationWarningmsgrrW/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/sqlalchemy/util/deprecations.pywarn_deprecatedrcCs$|rt|d|}t|tj|dS)zhIssue a deprecation warning with a parameterized string, limiting the number of registrations. N)rrrr r)rargsrrrrwarn_deprecated_limiteds rcCr r )rrr SAPendingDeprecationWarningrrrrwarn_pending_deprecation$rr__init__cs$d|pdffdd}|S)N.. deprecated:: %s %scst|tjtdSNfunc)_decorate_cls_with_warningr rdict)cls constructorheadermessagerrdecorate+s z deprecated_cls..decorater)versionr*r(r+rr'rdeprecated_cls(s r-Tc8|r d|pdfnddurdfdd}|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. rr N$Call to deprecated function %(func)sct|tjt|jdSr!)_decorate_with_warningr rr%__name__fnr)r*rrr+P zdeprecated..decoraterr,r*add_deprecation_to_docstringr+rr5r deprecated7sr9c s8iD] \}\}}t||<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." ) ) cst|}|jdur.tt|jt|jt|jd|jtt ndtt fdd}|j durG|j pHd}|rWt |dd D}||}||_ |S)NrcsfD]}|||krtj|tjddqD]}||vr+tj|tjddq||i|SNr r r)r4rkwargsm)check_defaultscheck_kwdefaultsmessagesrrwarned~s  z3deprecated_params..decorate..warnedr cSs&i|]\}\}}|d||pdfqS)rr r).0paramr,r*rrr s z7deprecated_params..decorate..)rinspect_getfullargspecr?r%ziprlenset intersection differencer__doc__ritems)r4specrAdoc decoratedr@specs)r=r>r?rr+os2  z#deprecated_params..decorate)rL_sanitize_restructured_text)rQrCr,r*r+rrPrdeprecated_params[s +rScr.)aEDecorates 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. z.. deprecated:: %s (pending) %sr Nr/cr0r!)r1r rr%r2r3r5rrr+r6z%pending_deprecation..decoraterr7rr5rpending_deprecationsrTcCs|dur|St||SN)r)parameter_value default_value warning_textrrrdeprecated_option_valuesrYcCsdd}td||S)NcSs$|dd\}}|dvr|d7}|S)Nrr)r#methz())group)r<type_namerrrreplsz)_sanitize_restructured_text..replz\:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)resub)textr^rrrrRsrRcCs|jdur|jp d}|dur?|t|d;}t||d}t|tur7t|j}||d<t|j|j|}||}n||_t||}t||t |||d|S)Nr r"rrK) rKr%rtype__dict__r2 __bases__getattrsetattrr1)r&r(wtyper*docstring_headerrNclsdictconstructor_fnrrrr$s"      r$cstttfdd}|jdur|jpd}|dur)|t|jd;}t||d}||}||_fdd|_|S) z=Wrap a function with a warnings.warn and augmented docstring.cstjdd||i|Sr:rr)r4rr;r*rgrrrAsz&_decorate_with_warning..warnedNr r"rcstjddSr:rkrrlrrsz(_decorate_with_warning..)rRrrKr%r2r_sa_warn)r#rgr*rhrArNrOrrlrr1s r1)r )r)NTrU)rKr_rr r langhelpersrrrrr rrrr-r9rSrTrYrRr$r1rrrrs,          $C &