xhez,dZddlmZddlZddlZddlmZddlmZddl m Z ddl m Z m Z ddlmZmZd d lmZGd d eZGd dZeeZdS)z!Tools to aid in deprecating code.) annotationsN)Action)wraps) ModuleType)AnyCallable)Versionparse) __version__ceZdZdS)DeprecatedErrorN)__name__ __module__ __qualname__8lib/python3.11/site-packages/conda_build/deprecations.pyrrsDrrceZdZUded<d'dZdddd(dZddddd)dZdddd*dZdddd+dZdddd,dZ dddd-d!Z d.d#Z d/d&Z dS)0DeprecationHandlerr _versionversion Version | strcz t||_dS#t$rtd|_YdSwxYw)zFactory to create a deprecation handle for the specified version. :param version: The version to compare against when checking deprecation statuses. z0.0.0.dev0+placeholderN)r r TypeError)selfrs r__init__zDeprecationHandler.__init__sI  <!'NNDMMM < < <!":;;DMMMM .deprecated_decorator..innerCs3 gxAIFFFFtT,V,,,r_generate_messagerrrr) r(r7r5r6rr r"rrs ` @@rdeprecated_decoratorz9DeprecationHandler.__call__..deprecated_decorator5s $ 6 6?88T%688! !7!! Hg /%g...4[[ - - - - - - -[ - Lrr(rr%rr)rr r"rrr:s````` r__call__zDeprecationHandler.__call__%sA           ,$#r)renamerrargumentr=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. r(rr%c  jdjddrsddn\stt  fd}|S)Nr*()zUse 'z ' instead.r+c|vrHtjdz|d}r|||i|Sr-)r1r2pop setdefault) r3r4valuer>r5r(r6r=rs rr7zHDeprecationHandler.argument..deprecated_decorator..innerrssv%%M'8E JJJJ#JJx66E9))&%888tT,V,,,rr8) r(r7r5r6rr>r r"r=rrs ` @@rr:z9DeprecationHandler.argument..deprecated_decoratoras $ 6 6?DDT%6DDDDD"*33333!7!! Hg /%g...4[[ - - - - - - - - -[ -Lrr;r)rr r"r>r=rrr:s``````` rr>zDeprecationHandler.argumentMsN(            @$#raction type[Action]cbGfdd}t|j||fiS)Nc6eZdZfdZdfd ZxZS)3DeprecationHandler.action..DeprecationMixinctj|i| |jrd|jddn d|jd\}}|st |||_||_dS)N`r+)superrr9option_stringsdestrr5help) inner_selfr3r4r5r6 __class__rr r"rs rrz.DeprecationMixin.__init__s  $1&111$($:$:  &44.DeprecationMixin.__call__sR OZ%8QY  FMJJJJJr)N)rrrrr< __classcell__)rTrr r"rrs@rDeprecationMixinrKs{ * * * * * * * * *0 K K K K K K K K K K Krr\)typer)rr r"rGrrr\s``` `` rrGzDeprecationHandler.actionsx K K K K K K K K K K K K K KBFO&6%?DDDrNonecr|||||d|d|zdS)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. r r.)r r"topicrrN)r` _get_module)rr r"rrs rmodulezDeprecationHandler.modulesO %""5))!,e)      rconstantrFrc |\} ||| d|\ st t|dd d   fd }||_dS) 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. r* __getattr__Nnamer!r%rc|krtjdzSr |Stdd|d)Nr.r/zmodule 'z' has no attribute '')r1r2AttributeError)rfr5rcfullnamer6r super_getattrrFs rrez0DeprecationHandler.constant..__getattr__shx gxAIFFFF  +$}T*** !QH!Q!Q$!Q!Q!QRR Rr)rfr!r%r)rar9rgetattrre) rr r"rcrFrrrbrer5rjr6rks `` ` @@@@rrczDeprecationHandler.constants( ++E22 22   $ $( $ $    ' +!'** *  t<<  S S S S S S S S S S S S)rr`c|||||\}}|st|tj||d|zdS)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. r.r/N)r9rr1r2)rr r"r`rrr5r6s rr`zDeprecationHandler.topicse$!22       ' +!'** *  gxAI>>>>>>rtuple[ModuleType, str]cddl} tjd|z}||}| ||jfSn#t $rYnwxYwt d)zDetect the module from which we are being called. :param stack: The stacklevel increment. :return: The module and module name. rNr.z&unable to determine the calling module)inspectsys _getframe getmoduler IndexErrorr)rrrpframerbs rrazDeprecationHandler._get_modules  M!e),,E&&u--F!00"    D FGGGs6> A  A prefix tuple[type[Warning] | None, str]c t|}t|}|j|krt}d|d}n!|j|krt}d|d}nd}d|d}|dt d|||gfS)aDeprecation 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 prefix: The message prefix, usually the function name. :param addendum: Additional messaging. Useful to indicate what to do instead. :return: The warning category (if applicable) and the message. z.is pending deprecation and will be removed in r*z%is deprecated and will be removed in Nzwas slated for removal in  )r rPendingDeprecationWarningDeprecationWarningjoinfilter) rr r"rvrdeprecate_versionremove_versionr5warnings rr9z$DeprecationHandler._generate_message)s",//y)) =, , ,0HSySSSGG ]^ + +)HJiJJJGGH?9???G  HHVD67H"=>> ? ?  r)rr) r r!r"r!rr#rr$r%r&)r r!r"r!r>r!r=r#rr#rr$r%r&) r r!r"r!rGrHrr#rr$) r r!r"r!rr#rr$r%r^)r r!r"r!rcr!rFrrr#rr$r%r^) r r!r"r!r`r!rr#rr$r%r^)rr$r%rn) r r!r"r!rvr!rr#r%rw) rrr__annotations__rr<r>rGrbrcr`rar9rrrrrsT<<<< $ &$&$&$&$&$&$\"#4$4$4$4$4$4$x $*E*E*E*E*E*Eb $       < $.).).).).).)l $??????@HHHH&       rr)__doc__ __future__rrqr1argparser functoolsrtypesrtypingrrpackaging.versionr r r RuntimeErrorrr deprecatedrrrrs('""""""  ,,,,,,,,     l   q q q q q q q q h   , , r