o u#g;N@sdZddlZddlZddlZddlZddlZGdddeZ  ddddd Zdddddddd d d Z dddddddd d dZ GdddZ iZ dddZ GdddZeZdddZdddZddddZejddZdS) a  Helper functions for deprecating parts of the Matplotlib API. This documentation is only relevant for Matplotlib developers, not for users. .. warning:: This module is for internal use only. Do not use it in your own code. We may change the API at any time with no warning. Nc@seZdZdZdS)MatplotlibDeprecationWarningz>A class for issuing deprecation warnings for Matplotlib users.N)__name__ __module__ __qualname____doc__rr/var/www/static.ux5.de/https/Moving-Object-Detection-with-OpenCV/env/lib/python3.10/site-packages/matplotlib/_api/deprecation.pyrsrFremovalc Cs|r |rtdn|s|d^}} } |dt| d}d|}|s?|r)dnd|r.dndd|r6d nd |r.deprecate..finalize attributecsJeZdZd fdd ZfddZfddZfdd ZZS) z;deprecated..deprecate.._deprecated_propertyNcs.|dus |durt|rt||Sr() isinstancesuper__get__)selfinstanceowner) __class__r& emit_warningrrr5s zCdeprecated..deprecate.._deprecated_property.__get__cs|durt||Sr()r4__set__)r6r7valuer9r:rrr;szCdeprecated..deprecate.._deprecated_property.__set__cs|durt|Sr()r4 __delete__)r6r7r=rrr>s zFdeprecated..deprecate.._deprecated_property.__delete__csdkr|dSdS)Nzr)r6r8set_namerrr __set_name__szHdeprecated..deprecate.._deprecated_property.__set_name__r()rrrr5r;r>rA __classcell__r)r&r:r)r9r_deprecated_propertys rCcsjjj|dS)N)fgetfsetfdeldoc)rDrErF)rr/)rCr0rrr1sfunctioncst|}||_|Sr()r*r+rr-)rrrr1sc stddS)Nr )r%r)rrrrrrr rrrr:s  z3deprecated..deprecate..emit_warningcs|i|Sr(rargskwargs)r:rrrr.sz.deprecated..deprecate..wrapperr  z Notes ----- cSsg|]}|r|qSr)strip).0trrr sz1deprecated..deprecate..zUse z instead.z[*Deprecated*] z .. deprecated:: z z\ ) matplotlib._apir&r3typer,rrpropertyrDinspectcleandocrNjoin) r0rrrrrrold_docr1r. notes_header second_argr/r r) rCrrr&r:rrrr0rrr deprecatesV        zdeprecated..deprecater) rrrrrrrr r\rr[r deprecatedfs\r]c@s eZdZdZddZddZdS)deprecate_privatize_attributeaT Helper to deprecate public access to an attribute (or method). This helper should only be used at class scope, as follows:: class Foo: attr = _deprecate_privatize_attribute(*args, **kwargs) where *all* parameters are forwarded to `deprecated`. This form makes ``attr`` a property which forwards read and write access to ``self._attr`` (same name but with a leading underscore), with a deprecation warning. Note that the attribute name is derived from *the name this helper is assigned to*. This helper also works for deprecating methods. cOst|i||_dSr()r] deprecator)r6rJrKrrrr,sz&deprecate_privatize_attribute.__init__c s0t||jtfddfddddS)Ncst|dSNr)getattrr6r@rrsz.cst|d|Sr`)setattr)r6r<r@rrrcsr@)rdr_rT)r6r8rrr@rrAs    z*deprecate_privatize_attribute.__set_name__N)rrrrr,rArrrrr^s r^cstt}dur|St}|jvs$Jddjd|jvs5Jddjdtfdd}|t|<|S)a Decorator indicating that parameter *old* of *func* is renamed to *new*. The actual implementation of *func* should use *new*, not *old*. If *old* is passed to *func*, a DeprecationWarning is emitted, and its value is used, even if *new* is also passed by keyword (this is to simplify pyplot wrapper functions, which always pass *new* explicitly to the Axes method). If *new* is also passed but positionally, a TypeError will be raised by the underlying function during argument binding. Examples -------- :: @_api.rename_parameter("3.1", "bad_name", "good_name") def func(good_name): ... NMatplotlib internal error: z cannot be a parameter for () must be a parameter for c sL|vrtddjddd d||<|i|S)NzThe z parameter of z() has been renamed z since Matplotlib z7; support for the old name will be dropped %(removal)s.r)r%rpoprIrnewoldrrrr.$sz!rename_parameter..wrapper) r*partialrename_parameterrU signature parametersrr+ DECORATORS)rrlrkr decoratorror.rrjrrns$   rnc@seZdZddZdS)_deprecated_parameter_classcCdS)Nzrrbrrr__repr__8sz$_deprecated_parameter_class.__repr__N)rrrrurrrrrs7s rsc s6tjt fi}dur|SttddjDdjvrfjj}|tj j u|tj j uscsc|tj j urGt jngjjfddjDd_ndndt js{Jd d jd d dt f d d}|t|<|S)aI Decorator indicating that parameter *name* of *func* is being deprecated. The actual implementation of *func* should keep the *name* parameter in its signature, or accept a ``**kwargs`` argument (through which *name* would be passed). Parameters that come after the deprecated parameter effectively become keyword-only (as they cannot be passed positionally without triggering the DeprecationWarning on the deprecated parameter), and should be marked as such after the deprecation period has passed and the deprecated parameter is removed. Parameters other than *since*, *name*, and *func* are keyword-only and forwarded to `.warn_deprecated`. Examples -------- :: @_api.delete_parameter("3.1", "unused") def func(used_arg, other_arg, unused, more_args): ... Ncss$|] }|jtjjkr|jVqdSr()kindrU Parameter VAR_KEYWORDrrOparamrrr as z#delete_parameter..cs&g|]}|jkr|jtdn|qS))default)rreplace_deprecated_parameterryr@rrrQns  z$delete_parameter..rpFrergrfrcst|kr|vr|i|Sj|i|j}r-|r-t djddnEr@|r@t djddn2tfdd||ifDrrdd}t ftd jd rkd |n|d |i|S) Nz#Additional positional arguments to zS() are deprecated since %(since)s and support for them will be removed %(removal)s.rhz Additional keyword arguments to c3s$|] }|vo |tkVqdSr()r~)rOdr@rrr{sz4delete_parameter..wrapper..zIf any parameter follows z5, they should be passed as keyword, not positionally. parameter of rfrM)rrr)lenbind argumentsgetr%ranyrepr) inner_args inner_kwargsrdeprecation_addendum rr is_varargs is_varkwargsrK kwargs_namername_idxrorrrr.~s>   z!delete_parameter..wrapper)r*rmdelete_parameterrUronextrpvaluesrvrwVAR_POSITIONALrx KEYWORD_ONLYmathinfindexr} __signature__rrir+rq)rrrrKrrrvr.rrrr?s>        rcstt}dur |Sttjjtjjjvr'jj ks3Jddj dgj}| fdd|dDt fdd}j fd djDd |_|t|<|S) a3 Decorator indicating that passing parameter *name* (or any of the following ones) positionally to *func* is being deprecated. When used on a method that has a pyplot wrapper, this should be the outermost decorator, so that :file:`boilerplate.py` can access the original signature. Nrez/ must be a positional-or-keyword parameter for rfcs g|] }j|jkr|qSr)rprv)rOr)POKrorrrQsz%make_keyword_only..cs4t|krtddjdd|i|S)NzPassing the %(name)s %(obj_type)s positionally is deprecated since Matplotlib %(since)s; the parameter will become keyword-only %(removal)s.rrf)rrr)rr%rrI)rrrrrrr.s z"make_keyword_only..wrappercs&g|]}|jvr|jdn|qS))rv)rr}ry)KWOkwonlyrrrQsr)r*rmmake_keyword_onlyrUrorwPOSITIONAL_OR_KEYWORDrrprvrrr+r}rrrq)rrrrrnamesr.r)rrrrrrrorrrs,       r) allow_emptyc Ksdd}dd}|j}t||}t|t|rt|tr|n||}||krI|r;tt|dddd|jj|jjfvrItd i|dd ||SdS) a Return ``obj.method`` with a deprecation if it was overridden, else None. Parameters ---------- method An unbound method, i.e. an expression of the form ``Class.method_name``. Remember that within the body of a method, one can always use ``__class__`` to refer to the class that is currently being defined. obj Either an object of the class where *method* is defined, or a subclass of that class. allow_empty : bool, default: False Whether to allow overrides by "empty" methods without emitting a warning. **kwargs Additional parameters passed to `warn_deprecated` to generate the deprecation warning; must at least include the "since" key. cSsdSr(rrrrremptyz(deprecate_method_override..emptycSrt)rGNrrrrrempty_with_docstringrz7deprecate_method_override..empty_with_docstring__code__Nco_codemethod)rrr)rrar3rSr5rrr%) rr0rrKrrr bound_child bound_baserrrdeprecate_method_overrides.   rccsBttdtdVWddS1swYdS)Nignore)warningscatch_warnings simplefilterrrrrr'suppress_matplotlib_deprecation_warnings   "r)r r r Fr r r()r contextlibr*rUrrDeprecationWarningrrr%r]r^rqrnrsr~rrrcontextmanagerrrrrrs8   1 | 3  d0*