wBf:dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z e r9ddlm Z mZdd l mZmZmZmZmZdd lmZed Zed Zed eeZddlmZGddeZGddZeeZy)z!Tools to aid in deprecating code.) annotationsN)Action)wraps) ModuleType) TYPE_CHECKING)ArgumentParser Namespace)AnyCallable ParamSpecSelfTypeVar)VersionTP ActionType)bound) __version__c eZdZy)DeprecatedErrorN)__name__ __module__ __qualname__2lib/python3.12/site-packages/conda/deprecations.pyrrsrrc|eZdZUded<ded<ded<ddZeddZdd Zd d d  dd Zd d d d ddZ d d d  ddZ d d d  ddZ d d d  ddZ d d d  ddZ d dZed d!dZy )"DeprecationHandler str | None_versiontuple[int, ...] | None_version_tuplezVersion | None_version_objectcL||_|j||_d|_y)zFactory to create a deprecation handle for the specified version. :param version: The version to compare against when checking deprecation statuses. N)r!_get_version_tupler#r$)selfversions r__init__zDeprecationHandler.__init__'s(   #55g>#rc td|jjdDxsdS#ttf$rYywxYw)z|Return version as non-empty tuple of ints if possible, else None. :param version: Version string to parse. c32K|]}t|ywN)int).0parts r z8DeprecationHandler._get_version_tuple..9sJtTJs.N)tuplestripsplitAttributeError ValueError)r(s rr&z%DeprecationHandler._get_version_tuple2sE  Jw}}/D/DS/IJJRd R +  s25AAc|jr"|j|x}r|j|kSddlm}|j ||j |_|j||kS#t $r|d|_Y-wxYw)z}Test whether own version is less than the given version. :param version: Version string to compare against. r)parsez0.0.0.dev0+placeholder)r#r&packaging.versionr8r$r! TypeError)r'r( version_tupler8s r_version_less_thanz%DeprecationHandler._version_less_than=s   T5L5LW5U$UM$U&&6 6 ,    ' G',T]]';$##eGn44 G',-E'F$ GsA..BBNr)addendumstackc$dfd }|S)arDeprecation decorator for functions, methods, & classes. :param deprecate_in: Version in which code will be marked as deprecated. :param remove_in: Version in which code is expected to be removed. :param addendum: Optional additional messaging. Useful to indicate what to do instead. :param stack: Optional stacklevel increment. cjjdj\s tt dfd }|S)Nr1 deprecate_in remove_inprefixr=cJtjdz|i|SN stacklevel)warningswarn)argskwargscategoryfuncmessager>s rinnerzHDeprecationHandler.__call__..deprecated_decorator..innerps' gxAIFT,V,,rrLzP.argsrMzP.kwargsreturnr_generate_messagerrrr) rOrQrNrPr=rBrCr'r>s ` @@rdeprecated_decoratorz9DeprecationHandler.__call__..deprecated_decoratorbso $ 6 6)#//*!D,=,=+>?! !7! Hg%g..4[ - - LrrOCallable[P, T]rSrXr)r'rBrCr=r>rVs````` r__call__zDeprecationHandler.__call__Rs   ,$#r)renamer=r>c,dfd }|S)aDeprecation decorator for keyword arguments. :param deprecate_in: Version in which code will be marked as deprecated. :param remove_in: Version in which code is expected to be removed. :param argument: The argument to deprecate. :param rename: Optional new argument name. :param addendum: Optional additional messaging. Useful to indicate what to do instead. :param stack: Optional stacklevel increment. c  jjdjddrsddn\s tt d fd }|S) Nr1()zUse 'z ' instead.rAc|vrAtjdz|jd}r|j||i|SrF)rJrKpop setdefault) rLrMvalueargumentrNrOrPrZr>s rrQzHDeprecationHandler.argument..deprecated_decorator..innersVv%MM'8E J#JJx6E))&%8T,V,,rrRrT) rOrQrNrPr=rcrBrCrZr'r>s ` @@rrVz9DeprecationHandler.argument..deprecated_decorators $ 6 6)#//*!D,=,=+>azK39eF8:.x !7! Hg%g..4[ - - -LrrWr)r'rBrCrcrZr=r>rVs``````` rrczDeprecationHandler.argumentzs(  @$#rchGfddt}t|j||fiS)z9Wraps any argparse.Action to issue a deprecation warning.cheZdZUded<ded<dfd Z d d fd ZxZS) 3DeprecationHandler.action..DeprecationMixin type[Warning]rNstrhelpct||i| j|jrd|jddnd|jdt \}}|s t |||_||_y)N`)rBrCrDr=deprecation_type) superr)rUoption_stringsdest FutureWarningrrNri) inner_selfrLrMrNrP __class__r=rBrCr's rr)z.DeprecationMixin.__init__s $1&1$($:$:!-' &44J55b9:!< ! 13%%2%; %!'  )'22&. #") rctj|j|jdzt|||||y)NrH)rJrKrirNrnrY)rrparser namespacevalues option_stringrsr>s rrYz.DeprecationMixin.__call__s= OO'' 5y  FMJr)rrr rLr rMr rSNoner,) rrr rvrrwr rxr ryr rSrz)rrr__annotations__r)rY __classcell__)rsr=rBrCr'r>s@rDeprecationMixinrfsg# #I * *<-1  K  K& K% K  K *  K   K Krr})rtyper)r'rBrCactionr=r>r}s``` `` rrzDeprecationHandler.actions3+ K+ Kv+ KZFOO&6%?DDrcZ|j|||j|d|d|zy)a[Deprecation function for modules. :param deprecate_in: Version in which code will be marked as deprecated. :param remove_in: Version in which code is expected to be removed. :param addendum: Optional additional messaging. Useful to indicate what to do instead. :param stack: Optional stacklevel increment. rrG)rBrCtopicr=r>N)r _get_module)r'rBrCr=r>s rmodulezDeprecationHandler.modules8 %""5)!,e)  rc |j\} |j|| d|\ s t t|dd d   fd }||_y)aDeprecation function for module constant/global. :param deprecate_in: Version in which code will be marked as deprecated. :param remove_in: Version in which code is expected to be removed. :param constant: :param value: :param addendum: Optional additional messaging. Useful to indicate what to do instead. :param stack: Optional stacklevel increment. r1rA __getattr__Nc|k(rtjdzSr|Stdd|d)NrGrHzmodule 'z' has no attribute '')rJrKr5)namerNconstantfullnamerPr> super_getattrrbs rrz0DeprecationHandler.constant..__getattr__%sMx gxAIF $T** 8H:5I$q!QR Rr)rrhrSr )rrUrgetattrr) r'rBrCrrbr=r>rrrNrrPrs `` ` @@@@rrzDeprecationHandler.constants( ++E2 22%Zq + 3 '!'* *  t<  S S)rc|j||||\}}|s t|tj||d|zy)aDeprecation function for a topic. :param deprecate_in: Version in which code will be marked as deprecated. :param remove_in: Version in which code is expected to be removed. :param topic: The topic being deprecated. :param addendum: Optional additional messaging. Useful to indicate what to do instead. :param stack: Optional stacklevel increment. rArGrHN)rUrrJrK)r'rBrCrr=r>rNrPs rrzDeprecationHandler.topic1sP$!22% 3 '!'* *  gxAI>rc tjd|z} |jj}t tj j D]?}t|tst|ds!|j|k(s1||jfcS ddl }|j|}|||jfSt!d#t$rY;wxYw#t$r Yt!dwxYw)zDetect the module from which we are being called. :param stack: The stacklevel increment. :return: The module and module name. rG__file__rNz&unable to determine the calling module)sys _getframef_code co_filenamer2modulesrx isinstancerhasattrrrr5inspect getmodule IndexErrorr)r'r>framefilenameloadedrrs rrzDeprecationHandler._get_moduleQs  1MM!e),E  9 <<33$CKK$6$6$899F%fj9 "6:6 (2 &88 9 &&u-F!00FGG+"    4FGG9 s"CC CC C0/C0)rmc |j|r t}d|d}n"|j|r |}d|d}nd}d|d}|djtd|||gfS)aSGenerate the standardized deprecation message and determine whether the deprecation is pending, active, or past. :param deprecate_in: Version in which code will be marked as deprecated. :param remove_in: Version in which code is expected to be removed. :param prefix: The message prefix, usually the function name. :param addendum: Additional messaging. Useful to indicate what to do instead. :param deprecation_type: The warning type to use for active deprecations. :return: The warning category (if applicable) and the message. z.is pending deprecation and will be removed in r1z%is deprecated and will be removed in Nzwas slated for removal in  )r<PendingDeprecationWarningjoinfilter)r'rBrCrDr=rmrNwarnings rrUz$DeprecationHandler._generate_messagews(  " "< 00HFykQRSG  $ $Y /'H=i[JGH29+Q?G  HHVD67H"=> ?  r)r'r r(rhrSrz)r(rhrSr")r'r r(rhrSbool) r'r rBrhrCrhr=r r>r-rS*Callable[[Callable[P, T]], Callable[P, T]])r'r rBrhrCrhrcrhrZr r=r r>r-rSr)r'r rBrhrCrhrrr=r r>r-rSr) r'r rBrhrCrhr=r r>r-rSrz)r'r rBrhrCrhrrhrbr r=r r>r-rSrz)r'r rBrhrCrhrrhr=r r>r-rSrz)r'r r>r-rSztuple[ModuleType, str])r'r rBrhrCrhrDrhr=r rmrgrSz tuple[type[Warning] | None, str])rrrr{r) staticmethodr&r<rYrcrrrrrDeprecationWarningrUrrrrr"so**## $54 $ &$&$&$&$  &$  &$ 4&$\"#4$4$4$4$ 4$  4$4$4$ 44$x $8E8E8E8E 8E  8E8E 8E~ $           < $.).).).) .)  .).).) .)l $????  ?  ?? ?@$HZ+=! ! ! !  !  ! (!  *! rr) __doc__ __future__rrrJargparser functoolsrtypesrtypingrrr r r r r rr9rrrr~rr RuntimeErrorrr deprecatedrrrrsx("  2>>) A#AT&\:J l v v r  , r