h{NSrSSKrSSKrSSKrSSKrSSKr"SS\5rSSS.SjjrSSSSSSSS .S jr SSSSSSSS .S jr "S S 5r 0r SSjr "SS5r\"5rSSjrSSjrSS.Sjr\R&S5rg)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\rSrSrSrSrg)MatplotlibDeprecationWarningz>A class for issuing deprecation warnings for Matplotlib users.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__rM/var/www/html/env/lib/python3.13/site-packages/matplotlib/_api/deprecation.pyrrsHr rFremovalc hU(aU(a [S5eO,US:Xa&URS5tpn US[U 5S-3nU(d>U(aSOSU(aSO SU(aS OS--S-U(aS OS-U(aS OS-nU(a[O[n U "U[ X"XPUX6S 9-5$) Nz5A pending deprecation cannot have a scheduled removalr.zThe %(name)s %(obj_type)sz%(name)sz' will be deprecated in a future versionz' was deprecated in Matplotlib %(since)sz# and will be removed in %(removal)sz Use %(alternative)s instead.z %(addendum)s)funcnameobj_typesincer alternativeaddendum) ValueErrorsplitintPendingDeprecationWarningrdict) rmessagerrpendingrrrmacromeso_ warning_clss r_generate_deprecation_warningr&s TU U  B++c*aG1SY]O, ,4 (*:A 678?4RI K    1< ,  E !)_b  2 07+^^^^^^^^^^^SSKJm [T[5(a9TcSmTRmT=(d TR mTR nU4SjnO[T[T45(aSTcSmSmT=(d TRR mTR n"UUU4SjS[T55mUU4SjnO.TcS mTmT=(d TR mTR nU4S jnUUUUUUUU4S jmUU4S jn [R"U=(d S 5RS5nSn SRTT(aSTS3OS T4V s/sHn U (dM U R5PM sn 5n SUSX;aU OS STSU 3n U(dU S- n U"X5$s sn f)Nr) classpropertyclassc>UTl[R"TR5"U5TlT$![a N9f=fN)r AttributeError functoolswraps__init__)wrappernew_docobjs rfinalize/deprecated..deprecate..finalizesC")CK )s||^\rSrSrSUUU4SjjrUU4SjrUU4SjrU4SjrSrU=r $);deprecated..deprecate.._deprecated_propertyc^>UcUb[UT5(aT"5 [TU] X5$r3) isinstancesuper__get__)selfinstanceowner __class__r0 emit_warnings rrDCdeprecated..deprecate.._deprecated_property.__get__s/+u/@ *4 ? ?$ 7?8;;r c6>UbT"5 [TU]X5$r3)rC__set__)rErFvaluerHrIs rrLCdeprecated..deprecate.._deprecated_property.__set__s+$ 7?8;;r c6>UbT"5 [TU]U5$r3)rC __delete__)rErFrHrIs rrPFdeprecated..deprecate.._deprecated_property.__delete__s+$ 7-h77r c>TS:XaUmgg)Nzr)rErGset_namers r __set_name__Hdeprecated..deprecate.._deprecated_property.__set_name__sz)'*r rr3) rrr r rDrLrPrTr __classcell__)rHr0rIrs@r_deprecated_propertyr?s!<< < 8 ((r rWcR>T"TRTRTRUS9$)N)fgetfsetfdeldoc)rYrZr[)r$r9rWr:s rr;r<s'+sxxWNNr functioncL>[R"T5"U5nXlU$r3)r5r6r )r8r9rs rr;r<s #//$/8")r c &>[TTTTTTTTS9 g)Nr')r-)rrr rrr!rrsrrI3deprecated..deprecate..emit_warnings wT{(X !r c">T"5 T"U0UD6$r3r)argskwargsrIrs rr8.deprecated..deprecate..wrappers N(( (r r z Notes ----- zUse z instead.z[*Deprecated*] z .. deprecated:: z z\ ) matplotlib._apir0rBtyper7rr propertyrYinspectcleandocstripjoin)r:r rrr!rrold_docr;r8 notes_headert second_argr9rWr0rIrrrs``````` @@@@r deprecatedeprecated..deprecate~s1 c4 "<[UST35$Nr$)getattr)rErs r.s'$!D6 ";r c$>[UST3U5$r})setattr)rErMrs rrrs4&z5)Ir )r)rryri)rErGrs `rrT*deprecate_privatize_attribute.__set_name__s1tT__ ;I K- r )ryN)rrr r r r7rTr rr rrvrvs 6r rvcx^^^^[R"[TTT5nTcU$[R"T5nTUR ;dST<STR S35eTUR ;dST<STR S35e[R"T5UUUU4Sj5nU[U'U$)aZ 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): ... Matplotlib internal error: z cannot be a parameter for () must be a parameter for c >TU;a7[TST<STRST<STS3 S9 URT5UT'T"U0UD6$)NzThe z parameter of z() has been renamed z since Matplotlib z:; support for the old name will be dropped in %(removal)s.r )r-rpop)rbrcrnewoldrs rr8!rename_parameter..wrappersh &= cWN4==/J$$'7*r)rEs r__repr__$_deprecated_parameter_class.__repr__3s'r rN)rrr r rr rr rrr2s(r rc ^^^^^^ ^ ^ ^ ^ [R"[TT40TD6nTcU$[R"T5m [ ST R R55S5m TT R ;GaT R TRnU[RRLm U[RRLm T (dT (dU[RRLa[RO/T R QRT5m T R!T R R5Vs/sH(nUR"T:XaUR![$S9OUPM* snS9=Tlm O7Sm O4S=m m [Rm T (dST<STR(S 35eTR+S S5m[R,"T5UUU U UU UU U U4 S j5nU[.U'U$s snf) a 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): ... Nc3# UH;nUR[RR:XdM-URv M= g7fr3)kindrj Parameter VAR_KEYWORDr).0params r #delete_parameter..\s6H0Mu ::):):)F)FF# 0Ms ,AA)defaultrFrrrrc.> [U5T ::aT U;aT"U0UD6$T R"U0UD6RnT(a/URT 5(a[ T STR S3S9 OT(a/URT 5(a[ T STR S3S9 Oh[ U 4SjX"RT 05455(a=ST <S3n[ T 4[T 5STR S 3T(aTS -U-OUS .TD6 T"U0UD6$) Nz#Additional positional arguments to zV() are deprecated since %(since)s and support for them will be removed in %(removal)s.rz Additional keyword arguments to c3T># UHnTU;=(a UT[:gv M g7fr3)_deprecated_parameter)rdrs rr4delete_parameter..wrapper..s/GEQ?qw*???Es%(zIf any parameter follows z5, they should be passed as keyword, not positionally. parameter of rrf)rrr)lenbind argumentsgetr-ranyrepr) inner_args inner_kwargsrdeprecation_addendumrr is_varargs is_varkwargsrc kwargs_namername_idxrrs rr8!delete_parameter..wrapperysJ z?h &4|+C4|4 4NNJ?,?II )---- !D==/"C D EimmD11 !A==/"C D E G$mmK&DEGGG,D84-. !  $Z(r:DL(S.+??2     Z0<00r )r5rdelete_parameterrjrnextrvaluesrrVAR_POSITIONALr KEYWORD_ONLYmathinfindexreplacerr __signature__rrr6r)rrrrcrrrr8rrrrrrs```` @@@@@@rrr:s2!!"2E4J6JI |!!$'IH 0D0D0K0K0MHIMOK y#####D)..W..=== w00<<< ,!G$5$5$B$BB-y++,2248  .7->->'1188:K<;E::% &; <+01:K<->.= =D  H$)) \88 ")$1J}}oR ! "{zz*d+H__T111@$Jw NeK[U5T:a[TSTSTRS3S9 T"U0UD6$)NzPassing the %(name)s %(obj_type)s positionally is deprecated since Matplotlib %(since)s; the parameter will become keyword-only in %(removal)s.rr)r rr)rr-r)rbrcrrrrs rr8"make_keyword_only..wrappersI t9x   EmDMM?"$E  G T$V$$r )rr)r5rmake_keyword_onlyrjrrPOSITIONAL_OR_KEYWORDrrrrrr6rrrrr) rrrrrPOKKWOnameskwonlyr8rrs ``` @rrrs!!"3UDAI |!!$'I    1 1C    ( (C I(( ($$T*//36V %dX.(T UV 7 $i"" #E{{4 H$XY/9/t%%d+00C7/F9__T % %&--))002:42E$)::#7 3 UB2:4-5G$Jw N+9":4s!FF+F) allow_emptyc SnSnURn[X5n[U[U55(a[U[5(aUOUR U5nXx:wa_U(aF[[USS5SS5UR R UR R 4;a[S0USS.UED6 U$g) 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. cgr3rrr rempty(deprecate_method_override..emptysr cg)r\Nrrr rempty_with_docstring7deprecate_method_override..empty_with_docstringsr __code__Nco_codemethod)rrr)rr~rBrhrDrrr-) rr:rrcrrr bound_child bound_bases rdeprecate_method_overriders,) ??D#$K k4; / /JsD4I4I  ^^C  ! W[*dC&."^^331::BBDD I4XHHI r c## [R"5 [R"S[5 Sv SSS5 g!,(df  g=f7f)Nignore)warningscatch_warnings simplefilterrrr r'suppress_matplotlib_deprecation_warningrs0  "h(DE  # " "sA A A A A)rrrFrrr3)r contextlibr5rjrrDeprecationWarningrr&r-rtrvrrrrrrrcontextmanagerrrr rrs  I#5I MO5 "5222ub".Bb"$""er2yx> 0f(( 45aH.b;@'T r