$TXg=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.pyrrsrrceZdZUded<ded<ded<ddZeddZdd Zd d ed  dd Z d d d ed ddZ d d e d  ddZ d d d ddZ d d ed  ddZd d ed  ddZd dZ 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..9sJ/ItT/Is.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)addendumstackdeprecation_typec(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 d fd }|S)Nr1 deprecate_in remove_inprefixr=r?cJtjdz|i|SN stacklevel)warningswarn)argskwargscategoryfuncmessager>s rinnerzHDeprecationHandler.__call__..deprecated_decorator..innerrs' gxAIFT,V,,rrMzP.argsrNzP.kwargsreturnr_generate_messagerrrr) rPrRrOrQr=rCr?rDr'r>s ` @@rdeprecated_decoratorz9DeprecationHandler.__call__..deprecated_decoratorcsr $ 6 6)#//*!D,=,=+>?!!1 !7! Hg%g..4[ - - LrrPCallable[P, T]rTrYr)r'rCrDr=r>r?rWs`````` r__call__zDeprecationHandler.__call__Rs"  .$#r)renamer=r>r?c 0dfd }|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  jjdjdd rsd dn\s tt d fd }|S) Nr1()zUse 'z ' instead.rBc|vrAtjdz|jd}r|j||i|SrG)rKrLpop setdefault) rMrNvalueargumentrOrPrQr[r>s rrRzHDeprecationHandler.argument..deprecated_decorator..innersVv%MM'8E J#JJx6E))&%8T,V,,rrSrU) rPrRrOrQr=rdrCr?rDr[r'r>s ` @@rrWz9DeprecationHandler.argument..deprecated_decorators $ 6 6)#//*!D,=,=+>azK39eF8:.x!1!7 ! Hg%g..4[ - - -LrrXr) r'rCrDrdr[r=r>r?rWs ```````` rrdzDeprecationHandler.argument|s*  B$#rclGfddt}t|j||fiS)z9Wraps any argparse.Action to issue a deprecation warning.cjeZdZUded<ded<dfd Z d d fd ZxZS) 3DeprecationHandler.action..DeprecationMixin type[Warning]rOstrhelpct||i| j |jrd|jddnd|jd\}}|s t |||_||_y)N`rB)superr)rVoption_stringsdestrrOrj) inner_selfrMrNrOrQ __class__r=rCr?rDr's rr)z.DeprecationMixin.__init__s $1&1$($:$:!-' &44J55b9:!< ! 13%%5%; %!'  )'22&. #") rc|r/tj|j|jdzt|||||y)NrI)rKrLrjrOrnrZ)rqparser namespacevalues option_stringrrr>s rrZz.DeprecationMixin.__call__s@MM""++#$u9  FMJr)rqr rMr rNr rTNoner,) rqr rurrvr rwr rxr rTry)rrr__annotations__r)rZ __classcell__)rrr=rCr?rDr'r>s@rDeprecationMixinrgsg# #I * *<-1  K  K& K% K  K *  K   K Krr|)rtyper)r'rCrDactionr=r>r?r|s``` ``` rr~zDeprecationHandler.actions3, K, Kv, K\FOO&6%?DDr)r=r>cZ|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. rrH)rCrDtopicr=r>N)r _get_module)r'rCrDr=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. r1rB __getattr__Nc|k(rtjdzSr|Stdd|d)NrIzmodule 'z' has no attribute '')rKrLr5)namerOconstantfullnamerQr> super_getattrrcs rrz0DeprecationHandler.constant..__getattr__-sMx gxAIF $T** 8H:5I$q!QR Rr)rrirTr )rrVrgetattrr)r'rCrDrrcr=r>r?rrrOrrQrs `` ` @@@@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. rBrHrIN)rVrrKrL) r'rCrDrr=r>r?rOrQs rrzDeprecationHandler.topic9sS&!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. rH__file__rNz&unable to determine the calling module)sys _getframef_code co_filenamer2modulesrw isinstancerhasattrrrr5inspect getmodule IndexErrorr)r'r>framefilenameloadedrrs rrzDeprecationHandler._get_module[s  1MM!e),E  9 <<33$CKK$6$6$89F%fj9 "6:6 (2 &88 : &&u-F!00FGG+"    4FGG9 s"CC CC C0/C0c |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'rCrDrEr=r?rOwarnings rrVz$DeprecationHandler._generate_messages(  " "< 00HFykQRSG  $ $Y /'H=i[JGH29+Q?G  HHVD67H"=> ?  r)r'r r(rirTry)r(rirTr")r'r r(rirTbool)r'r rCrirDrir=r r>r-r?rhrT*Callable[[Callable[P, T]], Callable[P, T]])r'r rCrirDrirdrir[r r=r r>r-r?rhrTr)r'r rCrirDrir~rr=r r>r-r?rhrTr) r'r rCrirDrir=r r>r-rTry)r'r rCrirDrirrircr r=r r>r-r?rhrTry)r'r rCrirDrirrir=r r>r-r?rhrTry)r'r r>r-rTztuple[ModuleType, str])r'r rCrirDrirErir=r r?rhrTz tuple[type[Warning] | None, str])rrrrzr) staticmethodr&r<DeprecationWarningrZrd FutureWarningr~rrrrrVrrrrr"s**## $54 $*<($($($($  ($  ($(($ 4($`"#*<6$6$6$6$ 6$  6$6$6$(6$ 46$| $*7:E:E:E:E :E  :E:E(:E :EB $           < $*<0)0)0)0) 0)  0)0)0)(0) 0)p $*< ? ? ? ?  ?  ? ?( ?  ?D$HL! ! ! !  !  ! (!  *! rr) __doc__ __future__rrrKargparser functoolsrtypesrtypingrrr r r r r rr9rrrr}rr RuntimeErrorrr deprecatedrrrrsx("  2>>) A#AT&\:J l @ @ F  , r