3jC"SrSSKrSSKrSSKrSSKrSSKrSSKrSSKrSSKJ r J r J r J r J r JrJrJrJr "SS5r\"5r"SS\5r"S S 5r"S S 5rS rSrSrSr\4SjrSrSSjrSr Sr!Sr"Sr#SSjr$g)a+ Helper functions for managing the Matplotlib API. This documentation is only relevant for Matplotlib developers, not for users. .. warning:: This module and its submodules are for internal use only. Do not use them in your own code. We may change the API at any time with no warning. N) deprecatedwarn_deprecatedrename_parameterdelete_parametermake_keyword_onlydeprecate_method_overridedeprecate_privatize_attribute'suppress_matplotlib_deprecation_warningMatplotlibDeprecationWarningc\rSrSrSrSrg)_Unset cg)Nzselfs R/home/wildlama/miniconda3/lib/python3.13/site-packages/matplotlib/_api/__init__.py__repr___Unset.__repr__!srN)__name__ __module__ __qualname____firstlineno__r__static_attributes__rrrrr srrc\rSrSrSrSrg)UnsupportedError&z Raised on inherited methods if the child class does not support the functionality of the base class. See `.unsupported_method` for details. rN)rrrr__doc__rrrrrr&srrc,\rSrSrSrSS.SjrSrSrg)unsupported_method/a Descriptor that creates a method raising `.UnsupportedError`. Historically, we have quite a few cases of inheritance hierarchies that do not fully respect the Liskov Substitution Principle, e.g. Axes and Artist. Some of the methods of a base class may not be implemented in the child class. In that case, we override the method in the child class to raise `.UnsupportedError`. Use in a class body to mark inherited methods as unsupported:: class Axes3D(Axes): twinx = _api.unsupported_method() Calling ``Axes3D().twinx()`` will raise "UnsupportedError: Axes3D does not support 'twinx'." Parameters ---------- append_message : str Optional additional text to be appended to the error message. Nappend_messagecXlgNr$)rr%s r__init__unsupported_method.__init__Es,rc^URSUS3mUR(aTSUR-- mU4SjnX#lURSU3UlURUl[ XU5 g)Nz does not support 'z'. c>[T5er')r)rargskwargsmessages rmethod/unsupported_method.__set_name__..methodMs"7+ +r.)rr%rrsetattr)rownernamer0r/s @r __set_name__unsupported_method.__set_name__Hsw^^$$7vR@    sT000 0G ,!&!3!3 4AdV<!,,V$r)rrrrr r(r6rrrrr"r"/s**.- %rr"c8\rSrSrSrSSjrSr\S5rSr g) classpropertyVz Like `property`, but also triggers on access via the class, and it is the *class* that's passed as argument. Examples -------- :: class C: @classproperty def foo(cls): return cls.__name__ assert C.foo == "C" NcVXlUcUb [S5eX lX0lX@lg)Nz#classproperty only implements fget.)_fget ValueErrorfsetfdel_doc)rfgetr>r?docs rr(classproperty.__init__gs-  t/BC C   rc$URU5$r'r<)rinstancer4s r__get__classproperty.__get__pszz%  rcUR$r'rErs rrAclassproperty.fgetss zzr)r@r<r?r>)NNN) rrrrr r(rGpropertyrArrrrr9r9Vs% !rr9c ^[S5m[U[5(aU4OUcT4O[U4SjU55nU4SjnUR5Hup4[X@5(aM/[ X 5QnSU;a"UR S5 UR S5 [SRU[U5S:aSRUSS5S -US-OUS U"[U5555e g) a For each *key, value* pair in *kwargs*, check that *value* is an instance of one of *types*; if not, raise an appropriate TypeError. As a special case, a ``None`` entry in *types* is treated as NoneType. Examples -------- >>> _api.check_isinstance((SomeClass, None), arg=arg) Nc30># UH ocTOUv M g7fr'r).0tp none_types r #check_isinstance..sCUr 92Usc>UTLaS$URS:Xa UR$URSUR3$)NNonebuiltinsr2)rr)rOrPs r type_name#check_isinstance..type_namesD / ;(* (CR__ ; a'89 ;rrTz({!r} must be an instance of {}, not a {}r, z or r) type isinstancetupleitemsmapremoveappend TypeErrorformatlenjoin)typesr.rVkvnamesrPs @rcheck_isinstanceri{sT I#E400eX"]i\ CUC C ;  !##,c)+,E V$ V$:AA5zA~IIeCRj)F2U2Y>+08d1g& () ) rcj[U5S:ax[SU/UQ55(a^[R"XSS9n[U5=S:Xa SnOWS:Xa SUS<S 3nOGS S R [ [ U55S 3nO"S S R [ [ U553nU<S USU3$)a Generate an error message that a potential setting is not an acceptable value. If the acceptable values are all strings, and sufficiently large, then add just a few suggestions to the end of the message. Otherwise list the supported values. Parameters ---------- name : str The name of the setting, keyword argument, etc. to generate the message for. potential The potential value from the user that is not a valid choice. values : iterable Sequence of values to check on. c3B# UHn[U[5v M g7fr')r[str)rNrgs rrQ,list_suggestion_error_msg..sP;Oaz!S11;Osg?)cutoffrrz Did you mean: ?z Did you mean one of: rXz Supported values are z is not a valid value for r2)rcalldifflibget_close_matchesrdr^repr)r5 potentialvaluesbest suggestions rlist_suggestion_error_msgrzs  6{Q3PI;O;OPPP((3G$i .tAwk; 5diiD$6P5QQRS -diiD&8I.J-KL ]4TF!J< HHrc U(d [S5eUR5H&up#X0;nU(aM[[X#U55e g![a SnN/f=f)a4 For each *key, value* pair in *kwargs*, check that *value* is in *values*; if not, raise an appropriate ValueError. Parameters ---------- values : iterable Sequence of values to check on. Note: All values must support == comparisons. This means in particular the entries must not be numpy arrays. **kwargs : dict *key, value* pairs as keyword arguments to find in *values*. Raises ------ ValueError If any *value* in *kwargs* is not found in *values*. Examples -------- >>> _api.check_in_list(["foo", "bar"], arg=arg, other_arg=other_arg) zNo argument to check!FN)rar]r=rz)rwr.keyvalexistss r check_in_listrsc0 /00LLN ]Fv6sHI I# F sA AAc DUR5GHup#URn[U5[U5:wd"[S[ X@555(dML[ [ R"SS[ R"5555nSRUSSS2Vs/sHnUb [U5O [U5PM snSSS25n[U5S:XaUS- n[U<S [U5S US UR35e gs snf) a~ For each *key, value* pair in *kwargs*, check that *value* has the shape *shape*; if not, raise an appropriate ValueError. *None* in the shape is treated as a "free" size that can have any length. e.g. (None, 2) -> (N, 2) The values checked must be numpy arrays. Examples -------- To check for (N, 2) shaped arrays >>> _api.check_shape((None, 2), arg=arg, other_arg=other_arg) c3D# UHupX:g=(a USLv M g7fr'r)rNsts rrQcheck_shape..s"SB$$@AJ5zQc! %yU N:,G,,-GG96 $:s,#D c [U5S:wa [S5eUR5uup4X$![a" U"[ X4UR 555Sef=f)a *kwargs* must consist of a single *key, value* pair. If *key* is in *mapping*, return ``mapping[value]``; else, raise an appropriate ValueError. Parameters ---------- _error_cls : Class of error to raise. Examples -------- >>> _api.getitem_checked({"foo": "bar"}, arg=arg) rz/getitem_checked takes a single keyword argumentN)rcr=r]KeyErrorrzkeys)mapping _error_clsr.rfrgs rgetitem_checkedr se 6{aJKKllnGFQTz T21HItSTs 4,A c ^^^TRS:Xde[T5R5VVs0sHup[U[5(dMX_M snnmT"5m[ R UUU4Sj5nU$s snnf)a Helper decorator for implementing module-level ``__getattr__`` as a class. This decorator must be used at the module toplevel as follows:: @caching_module_getattr class __getattr__: # The class *must* be named ``__getattr__``. @property # Only properties are taken into account. def name(self): ... The ``__getattr__`` class will be replaced by a ``__getattr__`` function such that trying to access ``name`` on the module will resolve the corresponding property (which may be decorated e.g. with ``_api.deprecated`` for deprecating module globals). The properties are all implicitly cached. Moreover, a suitable AttributeError is generated and raised if no property with the given name exists. __getattr__cr>UT;aTURT5$[STR<SU<35e)Nzmodule z has no attribute )rGAttributeErrorr)r5clsrFpropss rr+caching_module_getattr..__getattr__:sD 5=;&&x0 0cnn''9$ BD Dr)rvarsr]r[rK functoolscache)rr5proprrFrs` @@rcaching_module_getattrr!s{& <<= (( (*.s)//*; ,*;JD4*TZ*; ,EuH__DD  ,s A?A?cN^Tc"[U5$U4SjnUR5Hsup4SnSHPnXc-[ T5;dMSnUH2nU"Xc-5nXg-UlSXc-S3Ul[TXg-U5 M4 MR U(aMf[SU<35e UR5VVVs0sHup4UHowU_M M n nnnSn [TS 05n U "U 5U "U 5-n U (a[S U 35e0U EU ETl T$s snnnf) a! Class decorator for defining property aliases. Use as :: @_api.define_aliases({"property": ["alias", ...], ...}) class C: ... For each property, if the corresponding ``get_property`` is defined in the class so far, an alias named ``get_alias`` will be defined; the same will be done for setters. If neither the getter nor the setter exists, an exception will be raised. The alias map is stored as the ``_alias_to_prop`` attribute under the format ``{"alias": "property", ...}` on the class, and can be used by `.normalize_kwargs`. c\>^[R"[TT55U4Sj5nU$)Nc(>[UT5"U0UD6$r')getattr)rr-r.r5s rr02define_aliases..make_alias..methodZs4&77 7r)rwrapsr)r5r0rs` r make_alias"define_aliases..make_aliasYs* d+ , 8 - 8 rF)get_set_Tz Alias for `z`.z%Neither getter nor setter exists for cF1UR5kUR5k$r')rrw)ds rget_aliased_and_aliases/define_aliases..get_aliased_and_aliasesps''AHHJ''r_alias_to_propz2Parent class already defines conflicting aliases: ) rpartialdefine_aliasesr]rrr r3r=rNotImplementedErrorr) alias_drrraliasesr~prefixaliasr0 alias_to_proprpreexisting_aliases conflictings ` rrrDsR$ {  99 ! &F}S )$E' 6F&,nFO'26=/%DFNC8 %'v7x@B B)*1O)8 gUt gO("#'7<*+>?,];rs  """ |$%$%NJ )FI<'JT F,6T0 F7t1h, L"0/r