o i(6@sddlZddlZddlZddlmZddZdddZGdd d eZ  dd d Z  dd dZ  dddZ  dddZ dS)N)_utilscCst|dS)Nr)rget_qualified_name)objrY/home/ubuntu/.local/lib/python3.10/site-packages/ddtrace/vendor/debtcollector/removals.py_get_qualified_namesrcCs.td|||fD] }||}|r|Sq|S)z=Fetch first non-none/empty result of applying ``apply_func``.N)filter)fgetfsetfdel apply_funcvalue_not_foundfresultrrr_fetch_first_results rc @sxeZdZdZddddZdddddedddf dd Zd d Zd d ZddZ ddZ ddZ ddZ ddZ ddZdS)removed_propertya>Property descriptor that deprecates a property. This works like the ``@property`` descriptor but can be used instead to provide the same functionality and also interact with the :mod:`warnings` module to warn when a property is accessed, set and/or deleted. :param message: string used as ending contents of the deprecate message :param version: version string (represents the version this deprecation was created in) :param removal_version: version string (represents the version this deprecation will be removed in); a string of '?' will denote this will be removed in some future unknown version :param stacklevel: stacklevel used in the :func:`warnings.warn` function to locate where the users code is when reporting the deprecation call (the default being 3) :param category: the :mod:`warnings` category to use, defaults to :py:class:`DeprecationWarning` if not provided z'Setting the '%s' property is deprecatedz'Reading the '%s' property is deprecatedz(Deleting the '%s' property is deprecated)setgetdeleteNc Cs^||_||_||_||_||_||_||_| |_|dur't |r't |dd}i|_ ||_ dS)N__doc__) r r r stacklevelcategoryversionremoval_versionmessageinspect isfunctiongetattr_message_cacher) selfr r r docrrrrrrrr__init__@s  zremoved_property.__init__c Csnz|j|}W|Sty6|j|}|t|j|j|jtdd}tj ||j |j |j d}||j|<Y|Sw)Nz???)r)rrr) r KeyError_PROPERTY_GONE_TPLSrr r r rrgenerate_messagerrr)r!kind out_message prefix_tplprefixrrr_fetch_message_from_cachePs     z*removed_property._fetch_message_from_cachecKs|||_|d|j|_|d|j|_|d|j|_|d|j|_|d|j|_|dt|d|j|_|j |S)Nrrrrrr"r) r rrrrrrrrr clear)r!r kwargsrrr__call__^s  zremoved_property.__call__cCs>|jdur td|d}tj||j|jd||dS)Nzcan't delete attributerrr)r AttributeErrorr+r deprecationrr)r!rr(rrr __delete__ls   zremoved_property.__delete__cCs@|jdur td|d}tj||j|jd|||dS)Nzcan't set attributerr/)r r0r+rr1rrr!rvaluer(rrr__set__ts   zremoved_property.__set__cCsF|dur|S|jdurtd|d}tj||j|jd||S)Nzunreadable attributerr/)r r0r+rr1rrr3rrr__get__|s    zremoved_property.__get__cCsDt|||j|j|j}|j|_|j|_|j|_|j|_|j|_|SN) typer r rrrrrr)r!r orrrgetterzremoved_property.gettercCsDt||j||j|j}|j|_|j|_|j|_|j|_|j|_|Sr7) r8r r rrrrrr)r!r r9rrrsetterr;zremoved_property.settercCsDt||j|j||j}|j|_|j|_|j|_|j|_|j|_|Sr7) r8r r rrrrrr)r!r r9rrrdeleterr;zremoved_property.deleter)__name__ __module__ __qualname__rr%DeprecationWarningr#r+r.r2r5r6r:r<r=rrrrr$s$   rrcs@|durtjtdStjfdd}||S)aDecorates a function, method, or class to emit a deprecation warning Due to limitations of the wrapt library (and python) itself, if this is applied to subclasses of metaclasses then it likely will not work as expected. More information can be found at bug #1520397 to see if this situation affects your usage of this *universal* decorator, for this specific scenario please use :py:func:`.removed_class` instead. :param str message: A message to include in the deprecation warning :param str version: Specify what version the removed function is present in :param str removal_version: What version the function will be removed. If '?' is used this implies an undefined future version :param int stacklevel: How many entries deep in the call stack before ignoring :param type category: warnings message category (this defaults to ``DeprecationWarning`` when none is provided) N)rrrrrc s(t|\}}|rt|rd}d}nd}d}|snd}d}|durXt|rEd}d}tt|} | dkr=tj|dd}n$tj|dd}nd}tt|} | dkrWt|}n d}tj|dd}|rkd ||g} n|} n|} |rv| |7} |d | } tj | d } tj | d ||i|S) Nz Using classzUsing function/methodz()__main__F)fully_qualifiedT.z '%s' is deprecated)rrrr/) rrrisclassr getmoduleget_class_nameget_callable_namejoinr&r1) rinstanceargsr- qualifiedf_name prefix_pre thing_post base_name module_name thing_namer*r(rrrrrrrwrappers`    zremove..wrapper) functoolspartialremovewrapt decorator)rrrrrrrUrrTrrXs4rXcs8d}tj|d|||dtjfdd}|S)zBDecorates a kwarg accepting function to deprecate a removed kwarg.z%Using the '%s' argument is deprecatedNpostfixrrrcs&|vr tjd||i|SNr/rr1)rrKrLr-rold_namer(rrrrUs zremoved_kwarg..wrapper)rr&rYrZ)r`rrrrrr*rUrr_r removed_kwargsracs0fddddfdd}|S)zBDecorates a class to denote that it will be removed at some point.cs*tjtdfdd}|S)N)assignedcs&tjd|g|Ri|Sr]r^)r!rLr-)rold_initr(rrrnew_initsz1removed_class.._wrap_it..new_init)rVwrapsr get_assigned)rcr(rd)rr)rcr(r_wrap_itszremoved_class.._wrap_itcSs,t|stt|\}}td|dS)Nz5Unexpected class type '%s' (expected class type only))rrFrrr8 TypeError)cls_qual type_namerrr _check_its z removed_class.._check_itcs2|tjddd}|j||_|S)NzCUsing class '%s' (either directly or via inheritance) is deprecatedr[)rr&r#)rir()rlrgcls_namerrrrr_cls_decoratorsz%removed_class.._cls_decoratorr)rm replacementrrrrrrnr)rlrgrrmrrrrr removed_class s  rpc Cst|r t|}nt|tr|}ntt|\}} td| d|} |r,d|} nd} tj | | |||d} tj | ||ddS)a6Helper to be called inside a module to emit a deprecation warning :param str replacment: A location (or information about) of any potential replacement for the removed module (if applicable) :param str message: A message to include in the deprecation warning :param str version: Specify what version the removed module is present in :param str removal_version: What version the module will be removed. If '?' is used this implies an undefined future version :param int stacklevel: How many entries deep in the call stack before ignoring :param type category: warnings message category (this defaults to ``DeprecationWarning`` when none is provided) zAUnexpected module type '%s' (expected string or module type only)z#The '%s' module usage is deprecatedz, please use %s insteadNr[r/) rismoduler isinstancestrrrr8rhr&r1) modulerorrrrrrRrjrkr*r\r(rrrremoved_module*s(     rur7)NNNNrN)NNNrN) rVrrYrBrrrobjectrrXrarprurrrrs,   ~ S  !