o [h2@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 SADeprecationWarningmsgrr/home/ubuntu/experiments/live_experiments/Pythonexperiments/Otree/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*Zadd_deprecation_to_docstringr+rr5r deprecated7sr8c 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..)rZinspect_getfullargspecr>r%ziprlenset intersection differencer__doc__ritems)r4specr@doc decoratedr?specs)r<r=r>rr+os2  z#deprecated_params..decorate)rJ_sanitize_restructured_text)rOrBr,r*r+rrNrdeprecated_params[s +rQcr.)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_deprecationsrRcCs|dur|St||SN)r)Zparameter_value default_valueZ warning_textrrrdeprecated_option_valuesrUcCsdd}td||S)NcSs$|dd\}}|dvr|d7}|S)Nrr)r#methz())group)r;type_namerrrreplsz)_sanitize_restructured_text..replz\:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)resub)textrZrrrrPsrPcCs|jdur|jp d}|dur?|t|d;}t||d}t|tur7t|j}||d<t|j|j|}||}n||_t||}t||t |||d|S)Nr r"rrI) rIr%rtype__dict__r2 __bases__getattrsetattrr1)r&r(wtyper*docstring_headerrLZclsdictZconstructor_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|Sr9rr)r4rr:r*rcrrr@sz&_decorate_with_warning..warnedNr r"rcstjddSr9rerrfrrsz(_decorate_with_warning..)rPrrIr%r2rZ_sa_warn)r#rcr*rdr@rLrMrrfrr1s r1)r )r)NTrS)rIr[rr rZ langhelpersrrrrr rrrr-r8rQrRrUrPr$r1rrrrs,          $C &