i;(%SrSSKJr SSKrSSKrSSKJr SSKJr SSK J r SSK J r SSK Jr \ (a:SS KJrJr SS K JrJrJr SS KJrJr SS KJr \"S 5r\"S5r\"S\\S9r"SS\5r"SS5r\"\5r S\!S'g)z Reusable helpers for deprecating functionality. Note: most of this file has been copied from conda's implementation. Usage documentation can be found here: https://docs.conda.io/projects/conda/en/latest/dev-guide/deprecations.html ) annotationsN)Action)wraps) ModuleType) TYPE_CHECKING) __version__)ArgumentParser Namespace)AnyCallableTypeVar) ParamSpecSelf)VersionTP ActionType)boundc\rSrSrSrg)DeprecatedError#N)__name__ __module__ __qualname____firstlineno____static_attributes__r>lib/python3.13/site-packages/anaconda_cli_base/deprecations.pyrr#srrc\rSrSr%S\S'S\S'S\S'SSjr\SS j5rSS jrS S S .SSjjr S S S S.SSjjr S S S .SSjjr S S S .SSjjr S S S .S Sjjr S S S .S!SjjrS"Sjr\S.S#SjjrSrg )$DeprecationHandler) str | None_versiontuple[int, ...] | None_version_tuplezVersion | None_version_objectcJXlURU5UlSUlg)zFactory to create a deprecation handle for the specified version. Args: version: The version to compare against when checking deprecation statuses. N)r$_get_version_tupler&r')selfversions r__init__DeprecationHandler.__init__.s& #55g>#rc[SUR5RS555=(d S$![[4a gf=f)zpReturn version as non-empty tuple of ints if possible, else None. Args: version: Version string to parse. c38# UHn[U5v M g7fN)int).0parts r 8DeprecationHandler._get_version_tuple..DsJ/ItT/Is.N)tuplestripsplitAttributeError ValueError)r+s rr)%DeprecationHandler._get_version_tuple;sE Jw}}/D/DS/IJJRd R +  s7:A  A c,UR(a'URU5=n(aURU:$SSKJn URcU"UR 5UlURU"U5:$![ a U"S5UlN.f=f)zqTest whether own version is less than the given version. Args: version: Version string to compare against. r)parsez0.0.0.dev0+placeholder)r&r)packaging.versionr>r'r$ TypeError)r*r+ version_tupler>s r_version_less_than%DeprecationHandler._version_less_thanHs   T5L5LW5U$UM$U&&6 6 ,    ' G',T]]';$##eGn44 G',-E'F$ Gs A99BBNr)addendumstackc(^^^^^SUUUUU4SjjnU$)aEDeprecation decorator for functions, methods, & classes. Args: deprecate_in: Version in which code will be marked as deprecated. remove_in: Version in which code is expected to be removed. addendum: Optional additional messaging. Useful to indicate what to do instead. stack: Optional stacklevel increment. c>^^^TRTTTRSTR3TS9ummT(d [T5e[ T5SUUUU4Sjj5nU$)Nr6 deprecate_in remove_inprefixrDcF>[R"TTST-S9 T"U0UD6$N stacklevel)warningswarn)argskwargscategoryfuncmessagerEs rinnerHDeprecationHandler.__call__..deprecated_decorator..inners' gxAIFT,V,,rrSzP.argsrTzP.kwargsreturnr_generate_messagerrrr) rVrXrUrWrDrIrJr*rEs ` @@rdeprecated_decorator9DeprecationHandler.__call__..deprecated_decoratorqst $ 6 6)#//*!D,=,=+>?! !7! Hg%g..4[ - - - LrrVCallable[P, T]r[rar)r*rIrJrDrEr^s````` r__call__DeprecationHandler.__call___s$  ,$#r)renamerDrEc0^^^^^^^SUUUUUUU4SjjnU$)aDeprecation decorator for keyword arguments. Args: deprecate_in: Version in which code will be marked as deprecated. remove_in: Version in which code is expected to be removed. argument: The argument to deprecate. rename: Optional new argument name. addendum: Optional additional messaging. Useful to indicate what to do instead. stack: Optional stacklevel increment. c >^^^T RTTTRSTRSTS3T(a T(dSTS3OTS9ummT(d [T5e[ T5SUUUUUU 4Sjj5nU$) Nr6()zUse 'z ' instead.rHc>TU;aD[R"TTST-S9 URTS5nT(aURTU5 T"U0UD6$rM)rQrRpop setdefault) rSrTvalueargumentrUrVrWrdrEs rrXHDeprecationHandler.argument..deprecated_decorator..innersVv%MM'8E J#JJx6E))&%8T,V,,rrZr\) rVrXrUrWrDrmrIrJrdr*rEs ` @@rr^9DeprecationHandler.argument..deprecated_decorators $ 6 6)#//*!D,=,=+>azK39eF8:.x !7! Hg%g..4[ - - -Lrr`r)r*rIrJrmrdrDrEr^s``````` rrmDeprecationHandler.arguments,  @$#rch^^^^^"UUUUU4SjS[5n[URXc405$)z9Wraps any argparse.Action to issue a deprecation warning.cz>^\rSrSr%S\S'S\S'S UUUUU4SjjrS S UU4SjjjrSrU=r$) 3DeprecationHandler.action..DeprecationMixin type[Warning]rUstrhelpc>[TU]"U0UD6 T RTTUR(aSURSS3OSURS3T[ S9up4U(d [ U5eX0lX@lg)N`)rIrJrKrDdeprecation_type) superr,r]option_stringsdest FutureWarningrrUrw) inner_selfrSrTrUrW __class__rDrIrJr*s rr,.DeprecationMixin.__init__s $1&1$($:$:!-' &44J55b9:!< ! 13%%2%; %!  )'22&.#")rc>[R"URURST-S9 [TU]XX45 g)NrO)rQrRrwrUr|rb)rparser namespacevalues option_stringrrEs rrb.DeprecationMixin.__call__s9 OO'' 5y  FJrr)rrrSr rTr r[Noner0) rrrr rr rr rr#r[r) rrrr__annotations__r,rbr __classcell__)rrDrIrJr*rEs@rDeprecationMixinrssg# #I * *<-1  K  K& K% K  K *  K   K Krr)rtyper)r*rIrJactionrDrErs``` `` rrDeprecationHandler.actions1+ K+ Kv+ KZFOO&6%?DDrcTURUUURU5SUSU-S9 g)a.Deprecation function for modules. Args: deprecate_in: Version in which code will be marked as deprecated. remove_in: Version in which code is expected to be removed. addendum: Optional additional messaging. Useful to indicate what to do instead. stack: Optional stacklevel increment. rN)rIrJtopicrDrEN)r _get_module)r*rIrJrDrEs rmoduleDeprecationHandler.modules8" %""5)!,e)  rc^^^^ ^ ^ ^ URT5unm URUUT ST3US9um m T (d [T 5e[USS5m SU UU U UU U4SjjnXlg)aVDeprecation function for module constant/global. Args: deprecate_in: Version in which code will be marked as deprecated. remove_in: Version in which code is expected to be removed. constant: value: addendum: Optional additional messaging. Useful to indicate what to do instead. stack: Optional stacklevel increment. r6rH __getattr__Nc>UT:Xa"TTST-S9 T$T(aT"U5$[STSUS35e)NrNrOzmodule 'z' has no attribute '')rQrRr:)namerUconstantfullnamerWrE super_getattrrls rr0DeprecationHandler.constant..__getattr__:sMx gxAIF $T** 8H:5I$q!QR Rr)rrvr[r )rr]rgetattrr) r*rIrJrrlrDrErrrUrrWrs `` ` @@@@rrDeprecationHandler.constants, ++E2 22%Zq + 3 '!'* *  t<  S S)rcURUUUUS9upgU(d [U5e[R"XvSU-S9 g)aUDeprecation function for a topic. Args: deprecate_in: Version in which code will be marked as deprecated. remove_in: Version in which code is expected to be removed. topic: The topic being deprecated. addendum: Optional additional messaging. Useful to indicate what to do instead. stack: Optional stacklevel increment. rHrNrON)r]rrQrR)r*rIrJrrDrErUrWs rrDeprecationHandler.topicFsL(!22% 3 !'* *  gAI>rc[R"SU-5nURRn[RR 5HLn[ U[5(dM[US5(dM-URU:XdM?XDR4s $ SSK nURU5nUb XfR4$[S5e![a N=f=f![a N'f=f)zDetect the module from which we are being called. Args: stack: The stacklevel increment. Returns: The module and module name. rN__file__rNz&unable to determine the calling module)sys _getframef_code co_filenamemodulesr isinstancerhasattrrrr:inspect getmodule IndexErrorr)r*rEframefilenameloadedrrs rrDeprecationHandler._get_modulehs 1MM!e),E 9 <<33 "kk002F%fj99 "6:66 (2 &883 &&u-F!00"FGG)"     s"C!C CC! C.-C.)r{c URU5(a [nSUS3nO'URU5(a UnSUS3nOSnSUS3nUSR[SX7U/554$)aGenerate the standardized deprecation message and determine whether the deprecation is pending, active, or past. Args: deprecate_in: Version in which code will be marked as deprecated. remove_in: Version in which code is expected to be removed. prefix: The message prefix, usually the function name. addendum: Additional messaging. Useful to indicate what to do instead. deprecation_type: The warning type to use for active deprecations. Returns: The warning category (if applicable) and the message. z.is pending deprecation and will be removed in r6z%is deprecated and will be removed in Nzwas slated for removal in  )rBPendingDeprecationWarningjoinfilter)r*rIrJrKrDr{rUwarnings rr]$DeprecationHandler._generate_messages0  " "< 0 00HFykQRSG  $ $Y / /'H=i[JGH29+Q?G  HHVD6H"=> ?  r)r$r'r&)r*rr+rvr[r)r+rvr[r%)r*rr+rvr[bool) r*rrIrvrJrvrDr#rEr1r[*Callable[[Callable[P, T]], Callable[P, T]])r*rrIrvrJrvrmrvrdr#rDr#rEr1r[r)r*rrIrvrJrvrrrDr#rEr1r[r) r*rrIrvrJrvrDr#rEr1r[r)r*rrIrvrJrvrrvrlr rDr#rEr1r[r)r*rrIrvrJrvrrvrDr#rEr1r[r)r*rrEr1r[ztuple[ModuleType, str])r*rrIrvrJrvrKrvrDr#r{rur[z tuple[type[Warning] | None, str])rrrrrr, staticmethodr)rBrbrmrrrrrDeprecationWarningr]rrrrr!r!)su**## $  58 $ ($($($($  ($  ($ 4($`"#6$6$6$6$ 6$  6$6$6$ 46$| $8E8E8E8E 8E  8E8E 8E~ $           @ $0)0)0)0) 0)  0)0)0) 0)p $ ? ? ? ?  ?  ? ?  ?D'H`+=% % % %  %  % (%  *% % rr! deprecated)"__doc__ __future__rrrQargparser functoolsrtypesrtypingranaconda_cli_baserr r r r r typing_extensionsrrr?rrrrr RuntimeErrorrr!rrrrrrs#  )2--1) A#AT&\:J l M M ` "4K!@ @r