BEKh d Z ddlZddlZddlmZ ddlmZ ddlmZ ddlmZ ddlm Z d d
lm
Z
dd Z dd
Z ddZ
ddZddZd Z ddZd Zd Z d dZd dZdS ) zSHelpers related to deprecation of functions, methods, classes, other
functionality. N )compat)_hash_limit_string) decorator)inject_docstring_text)inject_param_text )exc c H t j | t j | d S N
stacklevelwarningswarnr
SADeprecationWarningmsgr s p/builddir/build/BUILD/cloudlinux-venv-1.0.10/venv/lib64/python3.11/site-packages/sqlalchemy/util/deprecations.pywarn_deprecatedr s" M#s/JGGGGGG c l |rt | d| } t j | t j | dS )zhIssue a deprecation warning with a parameterized string,
limiting the number of registrations.
N)r r r r
r )r argsr s r warn_deprecated_limitedr s:
0 b$// M#s/<<<<.decorate+ s7 ) $ d ,,, ,
r )versionr. r, r/ r- s `` @r deprecated_clsr2 ( sE (/'-R-
AF
Or Tc < |r d| dpdnddfd}|S )a Decorates 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.
r" r# r$ N$Call to deprecated function %(func)sc h t | t j t | j z S r& )_decorate_with_warningr
r r* __name__fnr- r. s r r/ z deprecated..decorateP s6 % $ d ,,, ,
r r0 r1 r. add_deprecation_to_docstringr/ r- s ` @r
deprecatedr< 7 s] " $ ,3GGgmmE8
Or c x i D ]\ }\ }}t | |< fd}|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."
)
)
c j t j | }|j t t |j t
|j t
|j z
d |j t t ndt t fd }| j d ur| j pd}|r,t |d
D } || }||_ |S )Nr0 c D ];}|| | k r't j | t j d <D ]-}||v r't j | t j d . | |i |S Nr r r )r9 r kwargsmcheck_defaultscheck_kwdefaultsmessagess r warnedz3deprecated_params..decorate..warned~ s #
!9 ++ M S%=!
;; M S%=! 2t&v&& &r r$ c 0 i | ]\ }\ }}|d |d|pdS )r" r# r$ r0 ).0paramr1 r. s r
z7deprecated_params..decorate.. sD 1 1 Eggg
2
O r )r inspect_getfullargspecrE r* zipr lenset intersection
differencer __doc__r items)
r9 specrG doc decoratedrC rD rE rF specss
@@@r r/ z#deprecated_params..decorateo sS ,R00 = $Is49~~DM0B0B B E EFM H !]] 7 7 A AN8}}//99HH N8}}H ' ' ' ' ' ' '
' j$39r # 5:[[]] C F2JJ r )rS _sanitize_restructured_text)rW rJ r1 r. r/ rF s ` @r deprecated_paramsrY [ se H%*[[]] ? ?!!5g>>) ) ) ) ) )V Or c < |r d| dpdnddfd}|S )aE Decorates 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.
r" z (pending) r$ Nr4 c h t | t j t | j z S r& )r6 r
r r* r7 r8 s r r/ z%pending_deprecation..decorate s6 % + d ,,, ,
r r0 r: s ` @r pending_deprecationr\ s] & $ 6=gg
2
O8
Or c , | |S t | | S N)r )parameter_value
default_value warning_texts r deprecated_option_valuerb s" %%% r c 4 d }t j d|| S )Nc J | dd \ }}|dv r|dz
}|S )Nr r )r( methz())group)rB type_names r replz)_sanitize_restructured_text..repl s1 ggamm t $ $ $ DLD r z \:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)resub)textri s r rX rX s( 63T4 @ @@r c
| j d ur| j pd}||t | z }t ||d }t | t u r=t | j }||d< t | j | j | } || }n|| _ t | | }t | |t |||d | S )Nr$ r' r rR )
rR r* r type__dict__r7 __bases__getattrsetattrr6 )r+ r, wtyper. docstring_headerrU clsdictconstructor_fns r r) r) s +T
!
1ck
7RC#Dk 2 2 22#C)91== 99 3<((G!$GI s|S]G<.warned s/
gu3333r4"6"""r Nr$ r' r c 2 t j d S r@ ry )r. rs s r z(_decorate_with_warning.. s w!!L!L!L r )rX r rR r* r7 r _sa_warn)r( rs r. rt rG rU rV s `` r r6 r6 s *'22G# # # # # Y# ,d
"
3t|
9rC#Ddm 4 4 44#C)91==t IILLLLLI r )r )r )NTr^ )rR rj r r$ r langhelpersr r r r r
r r r r2 r< rY r\ rb rX r) r6 r0 r r r~ s~
+ + + + + + " " " " " " . . . . . . * * * * * * H H H H= = = =O O O O ! ! ! !H? ? ?F 9=# # # #L A A A 8< 6 r