Files
aitsc/.venv/Lib/site-packages/sqlalchemy/util/__pycache__/deprecations.cpython-312.pyc

110 lines
13 KiB
Plaintext
Raw Normal View History

2025-02-23 09:07:52 +08:00
<EFBFBD>
2025-08-16 19:28:45 +08:00
<00><18>h}0<00><01>N<00>dZddlmZddlZddlmZddlmZddlmZddlmZddlm Z dd lm
2025-02-23 09:07:52 +08:00
Z
dd
lm Z dd lm Z dd lm Z dd lmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZddlmZede<05><19>Zedd<1B><19>Z d' d(d<1C>Z d) d*d<1D>Z d) d+d<1E>Z d, d-d<1F>Z d. d/d <20>Z d0d!<21>Z d' d1d"<22>Z!d2d#<23>Z"d3d$<24>Z# d' d4d%<25>Z$ d5 d6d&<26>Z%y)7zSHelpers related to deprecation of functions, methods, classes, other
functionality.<2E>)<01> annotationsN)<01>Any)<01>Callable)<01>Dict)<01>Match)<01>Optional)<01>Sequence)<01>Set)<01>Tuple)<01>Type)<01>TypeVar)<01>Union<6F>)<01>compat)<01>_hash_limit_string)<01>_warnings_warn)<01> decorator)<01>inject_docstring_text)<01>inject_param_text<78>)<01>exc<78>_T)<01>bound<6E>_FzCallable[..., Any]c<01>F<00>|||<04><01>}||_t||dz<00><03>y)N<><01>coder<00><01>
2025-08-16 19:28:45 +08:00
stacklevel)<02>deprecated_sincer)<06>msg<73>version<6F>type_rr<00>warns <20>@D:\aitsc\.venv\Lib\site-packages\sqlalchemy\util\deprecations.py<70>_warn_with_versionr&*s&<00><00> <11><13>4<EFBFBD> <20>D<EFBFBD>#<23>D<EFBFBD><19><12>4<EFBFBD>J<EFBFBD><11>N<EFBFBD>3<>c<01>@<00>t||tj||<03><01>y)Nr)r&r<00>SADeprecationWarning)r!r"rrs r%<00>warn_deprecatedr*7s<00><00><17> <0B>W<EFBFBD>c<EFBFBD>.<2E>.<2E>
2025-02-23 09:07:52 +08:00
<EFBFBD><14>r'c<01>^<00>|r t|d|<01>}t||tj||<04><02>y)zhIssue a deprecation warning with a parameterized string,
limiting the number of registrations.
<20>
rN)rr&rr))r!<00>argsr"rrs r%<00>warn_deprecated_limitedr.?s.<00><00> <0C> <20><13>b<EFBFBD>$<24>/<2F><03><16> <0B>W<EFBFBD>c<EFBFBD>.<2E>.<2E>
<EFBFBD><14>r'c<01>8<00><00><01><02><04>d<01><00>d<02>xsd<03><01><04>d<05><02><04><01>fd<04> }|S)N<>.. deprecated:: <20> <20>c <01>Z<00><04>t|<00>tj<00>t<00><01><01>z<00><04><02>S)N<><01>func)<04>_decorate_cls_with_warningrr)<00>dict)<05>cls<6C> constructor<6F>header<65>messager"s <20><><EFBFBD><EFBFBD>r%<00>decoratez deprecated_cls.<locals>.decorateVs2<00><><00>)<29> <0F> <17> <0F> $<24> $<24> <13>d<EFBFBD> <0B>,<2C> ,<2C> <13> <12> 
<EFBFBD>
r')r8<00>Type[_T]<5D>returnr=<00>)r"r;r9r<r:s``` @r%<00>deprecated_clsr@Qs&<00><><00>)0<>'<27>-<2D>R<EFBFBD>-<2D> A<>F<EFBFBD>
<EFBFBD>
<EFBFBD> <14>Or'c<01><><00><00><01><03><04><06>|r d<01><00>d<02>xsd<03><01><04>nd<04><06><01>d<05><01><03>tj<00><03>d<06>zz <00>d<08><04><06><01><00>fd<07> }|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.
r0r1r2Nz$Call to deprecated function %(func)sz (deprecated since: %s)c<01>d<00><05><00><03>J<00><01><05>J<00>t|<00><05>t|j<00><01>z<00><04><02><01><02>S)Nr4)<01>enable_warnings)<03>_decorate_with_warningr7<00>__name__)<06>fnrCr:r;r"<00>warnings <20><><EFBFBD><EFBFBD><EFBFBD>r%r<zdeprecated.<locals>.decorate<74>sH<00><><00><16>"<22>"<22>"<22><16>"<22>"<22>"<22>%<25> <0E> <13> <13>d<EFBFBD><02> <0B> <0B>,<2C> ,<2C> <13> <12>+<2B> 
<EFBFBD>
r'<00>rFrr>r)rr))r"r;<00>add_deprecation_to_docstringrGrCr<r:s`` `` @r%<00>
deprecatedrJcs]<00><><00>.$<24> <13> <14>]<5D><02>]<5D>
<EFBFBD><06>
<16><06><0E><EFBFBD>8<><07><0E><EFBFBD><15>*<2A>*<2A><07> <0B>(<28>7<EFBFBD>2<>2<>G<EFBFBD>

<EFBFBD>

<EFBFBD> <14>Or'c <01><<00>t d|tjd<01>|<01><01>S)N<>r;rG<00><01>2.0)rJr<00>MovedIn20Warning)r;<00>kws r%<00>moved_20rQ<00>s,<00><00> <16> <0A> <06><1E><03>(<<3C>(<<3C> <06>@B<> <06>r'c <01>:<00>tjd|<00>}|rdddd<05>|jd<06>}nd}d|<00>d |<04>d
d <0B>d <0C>}d |vr1|jdd<0F>}|s|j d<10>dus
Jd|z<00><00>|r|d |zz }t
j }td||d<12>|<02><01>S)Nz^:(attr|func|meth):<3A> attribute<74>function<6F>method)<03>attrr5<00>methr<00> constructzThe r1z= is considered legacy as of the 1.x series of SQLAlchemy and zbecomes a legacy constructz in 2.0.z:attr:<3A>warn_on_attribute_accessFrCz<>attribute %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.rLrM)<08>re<72>match<63>group<75>pop<6F>getr<00>LegacyAPIWarningrJ)<08>api_name<6D> alternativerP<00>type_regr#r;<00> attribute_ok<6F> warning_clss r%<00>became_legacy_20re<00>s<><00><00><12>x<EFBFBD>x<EFBFBD>-<2D>x<EFBFBD>8<>H<EFBFBD><0F>$<24>j<EFBFBD>(<28>K<> <14>N<EFBFBD>N<EFBFBD>1<EFBFBD> <1D>
<EFBFBD><05><1C><05><>
<15> <11> (<28> 
<EFBFBD> <0C><10>8<EFBFBD><1B><19>v<EFBFBD>v<EFBFBD>8<>%<25>@<40> <0C><1B><15>6<EFBFBD>6<EFBFBD>+<2B>,<2C><05>5<> <0E>)<29>,4<>4<> <0E>5<><13><0F>3<EFBFBD><1B>$<24>$<24><07><15>&<26>&<26>K<EFBFBD> <15> H<>W<EFBFBD>k<EFBFBD> H<>R<EFBFBD> H<>Hr'c <01><><00><00><05><06><07>i<00>i<00>i<00><06>j<00>D].\}\}}|<02>|<t|<03><00>|<tj<00>|<<00>0d<02><05><00><06>fd<01> }|S)aKDecorates 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.",
)
)
def some_function(**kwargs): ...
c<01>T<00><04><08> <09>
<EFBFBD> <0B>tj|<00>}|j<00><>tt |j
t |j
<00>t |j<00>z
d|j<00><00><00> t<00> <0B>j<00> <0C><00> t<00> <0C>j<00> <0B><00>
nZ|j<00>A|j<00> t<00> <0B>j<00> <0C><00> t<00> <0C>j<00> <0B><00>
n d<01> t<00> <0C><00>
|j<00>td<08><08> <09>
<EFBFBD> <0B> <0C><0E>fd<02> <0C>}|jduxr |jxsd}|rDt|<03> j<00>D<00><04><05>cic]\}\}}|d|dk(rdn|<05>d|xsd<03><01><04><02>c}}}<04>}||<00>}||_ |Scc}}}w) Nr?c<01>F<00><07><00>D]6}<03>|<00>||<00><12>|<00><01>||<00>|k7s<01>t<00>|<00>
|<00> |d<01><02><00>8<00><04>vr6t|<02>j<00><05>r<1C><04>J<00>t<00><08><00>
<EFBFBD><00> <09>d<01><02><00>D]}||vs<01>t<00>|<00>
|<00> |d<01><02><00>!||i|<02><01>S<00>N<>r)r&<00>set<65>
difference) rFr-<00>kwargs<67>m<> check_any_kw<6B>check_defaults<74>check_kw<6B>defaults<74>messages<65>version_warnings<67>versionss <20><><EFBFBD><EFBFBD><EFBFBD><EFBFBD><EFBFBD>r%<00>warnedz3deprecated_params.<locals>.decorate.<locals>.warned<65>s<><00><><00>#<23><01><1C>Q<EFBFBD>K<EFBFBD>'<27>F<EFBFBD>1<EFBFBD>I<EFBFBD>,A<><1C>Q<EFBFBD>K<EFBFBD>+<2B><06>q<EFBFBD> <09>X<EFBFBD>a<EFBFBD>[<5B>0H<30>&<26> <20><11> <0B> <20><11> <0B>(<28><11>+<2B>#$<24> <16> $<24><1C>x<EFBFBD>'<27>C<EFBFBD><06>K<EFBFBD>,B<>,B<><1E>-<0E>$<24>/<2F>/<2F>/<2F>"<22><1C>\<5C>*<2A><1C>\<5C>*<2A>$<24>\<5C>2<> <20> <12><1E><01><14><06>;<3B>&<26> <20><11> <0B> <20><11> <0B>(<28><11>+<2B>#$<24> <16><1E><16>t<EFBFBD>&<26>v<EFBFBD>&<26> &r'r2r0rNz1.4r1<00>rFrr-rrmrr>r)r<00>inspect_getfullargspecrrr7<00>zipr-<00>lenrk<00> intersectionrl<00>kwonlydefaults<74>varkwr<00>__doc__r<00>items)rF<00>specrv<00>doc<6F>paramr"r;<00> decoratedrorprqrrrs<00>specsrtrus @@@@<40><><EFBFBD><EFBFBD>r%r<z#deprecated_params.<locals>.decorate<74>s<><00><><00><15>,<2C>,<2C>R<EFBFBD>0<><04> <10>=<3D>=<3D> $<24><1B><13><18>I<EFBFBD>I<EFBFBD>s<EFBFBD>4<EFBFBD>9<EFBFBD>9<EFBFBD>~<7E><03>D<EFBFBD>M<EFBFBD>M<EFBFBD>0B<30>B<>E<>F<><18>M<EFBFBD>M<EFBFBD><12><0E>H<EFBFBD> !<21><18>]<5D>7<>7<><08>A<>N<EFBFBD><1A>8<EFBFBD>}<7D>/<2F>/<2F><08>9<>H<EFBFBD> <11> <20> <20> ,<2C><1B>*<2A>*<2A>H<EFBFBD> <20><18>]<5D>7<>7<><08>A<>N<EFBFBD><1A>8<EFBFBD>}<7D>/<2F>/<2F><08>9<>H<EFBFBD><1F>N<EFBFBD><1A>8<EFBFBD>}<7D>H<EFBFBD><1B>z<EFBFBD>z<EFBFBD> <0C>
<13> '<27> '<27>
<13> '<27>B<11>j<EFBFBD>j<EFBFBD><04>$<24>3<><12><1A><1A>9<>r<EFBFBD><03> <0E>#<23><13>6;<3B>[<5B>[<5B>]<5D><12>6C<01>1<><05>1<><07><17><1A> '<27>5<EFBFBD> 0<>u<EFBFBD>g<EFBFBD>=<3D><07> <0A>2<EFBFBD> <0A>P<01>P<01>5B<35><12><0E>C<EFBFBD><1B>2<EFBFBD>J<EFBFBD> <09><1F> <09><19><18><18><>s<00>(!F#rH)r<00>_sanitize_restructured_textrr))r<>r<>r"r;r<rsrtrus` @@@r%<00>deprecated_paramsr<73><00>sk<00><><00> "<22>H<EFBFBD>!<21>H<EFBFBD>BD<42><14>%*<2A>[<5B>[<5B>]<5D>!<21><05>!<21><07><17>!<21><08><15><0F>5<>g<EFBFBD>><3E><08><15><0F>"%<25>":<3A>":<3A><18><15><1F>&3<>
G<19>G<19>R <14>Or'c<01>h<00>dd<01>}tjdd<03>|<00>}tjd||<00>S)Nc<01>B<00>|jdd<02>\}}|dvr|dz }|S)Nrr)r5rWz()<29>r\)rnr#<00>names r%<00>replz)_sanitize_restructured_text.<locals>.repl-s,<00><00><17>g<EFBFBD>g<EFBFBD>a<EFBFBD><11>m<EFBFBD> <0B><05>t<EFBFBD> <10>$<24> $<24> <10>D<EFBFBD>L<EFBFBD>D<EFBFBD><13> r'z:ref:`(.+) <.*>`c<01>*<00>d|jd<02>zS)Nz"%s"rr<>)rns r%<00><lambda>z-_sanitize_restructured_text.<locals>.<lambda>3s<00><00><16>!<21>'<27>'<27>!<21>*<2A>1Dr'z\:(\w+)\:`~?(?:_\w+)?\.?(.+?)`)rnz
Match[str]r><00>str)rZ<00>sub)<02>textr<74>s r%r<>r<>,s1<00><00><14> <0E>6<EFBFBD>6<EFBFBD>%<25>'D<>d<EFBFBD> K<>D<EFBFBD> <0A>6<EFBFBD>6<EFBFBD>3<>T<EFBFBD>4<EFBFBD> @<40>@r'c <01>*<00>|jduxr |jxsd}|<05><>|<01>|t|<01><02>z}t|tj<00>r|dz }t ||d<04>}d}t |<00>t urgt|j<00>}||d<|jdd<00>|jdd<00>t |j|j|<08>}|<01>||}n||_|<01> t||<01>}|<01>"|<07>J<00>|<02>J<00>t||t||||d<00><00>|S)Nr2r4<00>@ (Background on SQLAlchemy 2.0 at: :ref:`migration_20_toplevel`)rr~<00>__dict__<5F> __weakref__)r~r7<00>
issubclassr<00>Base20DeprecationWarningr<00>typer<65>r]rE<00> __bases__<5F>getattr<74>setattrrD) r8r9<00>wtyper;r"<00>docstring_headerr<72><00>constructor_fn<66>clsdicts r%r6r67s9<00><00> <0E>+<2B>+<2B>T<EFBFBD>
!<21>
1<EFBFBD>c<EFBFBD>k<EFBFBD>k<EFBFBD>
7<EFBFBD>R<EFBFBD>C<EFBFBD><17>#<23> <16> "<22> <1C><04>+<2B> 6<> 6<> <1C> <15>e<EFBFBD>S<EFBFBD>9<>9<> :<3A> <1C>0<> <0E> <1C>$<24>C<EFBFBD>)9<>1<EFBFBD>=<3D><03><1D><0E> <0F><03>9<EFBFBD><04> <1C><1A>3<EFBFBD><<3C><<3C>(<28>G<EFBFBD>!$<24>G<EFBFBD>I<EFBFBD> <1E> <13>K<EFBFBD>K<EFBFBD>
<EFBFBD>D<EFBFBD> )<29> <13>K<EFBFBD>K<EFBFBD> <0A>t<EFBFBD> ,<2C><16>s<EFBFBD>|<7C>|<7C>S<EFBFBD>]<5D>]<5D>G<EFBFBD><<3C>C<EFBFBD><1A>&<26>!(<28><1B>!5<><0E><1E>C<EFBFBD>K<EFBFBD><1A>&<26>!(<28><13>k<EFBFBD>!:<3A><0E> <16> "<22>!<21>-<2D> -<2D>-<2D><18>$<24> $<24>$<24> <13><13><1B>&<26>"<22>E<EFBFBD>7<EFBFBD>G<EFBFBD>T<EFBFBD><12> <0E> <0F>Jr'c<01>V<00><01><02><03><05>t<00><02><00>t<00>tj<00>rd}nd}td<08><05><02><03>fd<03> <0C>}|j
duxr |j
xsd}|<04>+|t |j<00><05>z}||z }t||d<06>}||<00>} || _<00><02><03>fd<07>| _ | S) z=Wrap a function with a warnings.warn and augmented docstring.r<>r2c<01>d<00><04><00> xs|jdd<02>}|st<00><05><06>d<03><04>||i|<02><01>S)N<>_sa_skip_warningFrjr)r]r&)rFr-rm<00> skip_warningrCr;r"r<>s <20><><EFBFBD><EFBFBD>r%rvz&_decorate_with_warning.<locals>.warned{sC<00><><00>*<2A>*<2A>
<EFBFBD>f<EFBFBD>j<EFBFBD>j<EFBFBD> <1E><05>/
<EFBFBD> <0C><1C> <1E>w<EFBFBD><07><15>1<EFBFBD> E<><11>4<EFBFBD>"<22>6<EFBFBD>"<22>"r'Nr4rc<01>"<00><03>t<00><00><01>d<01><02>Sri)r&)r;r"r<>s<00><><EFBFBD>r%r<>z(_decorate_with_warning.<locals>.<lambda><3E>s<00><><00>!3<><0F><17>%<25>A<EFBFBD>"r'rw)
r<EFBFBD>r<>rr<>rr~r7rEr<00>_sa_warn)
r5r<>r;r"r<>rC<00>doc_onlyrvr<>r<>s
``` ` r%rDrDgs<><00><><00>*<2A>'<27>2<>G<EFBFBD><11>%<25><13>5<>5<>6<> ,<2C> <11>
<16><08><0E>#<23><0F>#<23> <0F>,<2C>,<2C>d<EFBFBD>
"<22>
3<EFBFBD>t<EFBFBD>|<7C>|<7C>
9<EFBFBD>r<EFBFBD>C<EFBFBD><17>#<23><18>D<EFBFBD>d<EFBFBD>m<EFBFBD>m<EFBFBD>4<>4<><18><18>H<EFBFBD>$<24><18>#<23>C<EFBFBD>)9<>1<EFBFBD>=<3D><03><16>t<EFBFBD> <0C>I<EFBFBD><1B>I<EFBFBD><15><06>I<EFBFBD><16> <15>r')N) r!r<>r"r<>r#<00>Type[exc.SADeprecationWarning]r<00>intr<00> Optional[str]r><00>None)rjN)
r!r<>r"r<>rr<>rr<>r>r<>) r!r<>r-z Sequence[Any]r"r<>rr<>rr<>r>r<>)<01>__init__)r"r<>r;r<>r9r<>r>zCallable[[Type[_T]], Type[_T]])NTNT) r"r<>r;r<>rI<00>boolrGz(Optional[Type[exc.SADeprecationWarning]]rCr<>r><00>Callable[[_F], _F])r;r<>rPrr>z0Callable[[Callable[..., _T]], Callable[..., _T]])r`r<>rar<>rPrr>r<>)r<>zTuple[str, str]r>r<>)r<>r<>r>r<>)r8r=r9r<>r<>r<>r;r<>r"r<>r<>r<>r>r=)NT)r5rr<>r<>r;r<>r"r<>r<>r<>rCr<>r>r)&r~<00>
__future__rrZ<00>typingrrrrrr r
r r r rr2r<00> langhelpersrrrrrrrrr&r*r.r@rJrQrer<>r<>r6rDr?r'r%<00><module>r<>s<><00><01><12>#<23> <09><16><1B><17><18><1B><1B><16><18><17><1A><18><14>+<2B>'<27>"<22>.<2E>*<2A><12> <0C>T<EFBFBD><13><1D><02> <0A>T<EFBFBD>-<2D>.<2E><02><1F>
4<> <0C>
4<> <10>
4<> *<2A>
4<><14>
4<>
<18>
4<> 
<EFBFBD>
4<>HL<01><06> <0C><06><1A><06>(+<2B><06>7D<37><06> <09><06><18><1E> <06> <0C><06>
<17><06><11><06><14> <06>
<18> <06> 
<EFBFBD> <06>&>H<01><14> <10><14><1E><14>-:<3A><14>#<23><14>("<22>)-<2D>8<<3C> <20> 3<14> <10>3<14> <1A>3<14>#'<27>3<14>6<> 3<14>
<1A> 3<14> <18> 3<14>l<06> <10><06><1B><06>5<><06>15<31>#I<01><11>#I<01> -<2D>#I<01><?<3F>#I<01><17>#I<01>Lb<14>JA<01>"'+<2B> -<0F> <11>-<0F><1E>-<0F> *<2A>-<0F><11> -<0F>
<11> -<0F> $<24> -<0F><0E>-<0F>j'+<2B> <20> *<15>
<0C>*<15> )<29>*<15><11>*<15><11> *<15>
$<24> *<15> <1A> *<15><08>*r'