+ ]i8csRt^RIt^RIt^RIt^RIt^RIt^RIt^RIHtH t H t H t H t H t HtHtHt!RR4tRtRR/RltR tR tR tRR ltR tRtRtRtRRltR#)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_warningMatplotlibDeprecationWarningcsDa]tRt^toRtRRltRt]R4tRt Vt R#) classpropertyz 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" Ncs\WnVfVe \R4hW nW0nW@nR#)Nz#classproperty only implements fget.)_fget ValueErrorfsetfdel_doc)selffgetr r Zdocs&&&&&?/usr/lib64/python3.14/site-packages/matplotlib/_api/__init__.py__init__Zclassproperty.__init__-s-  t/BC C   cs$VPV4#Nr )rinstanceZowner&&&r__get__Zclassproperty.__get__6szz%  rcsVP#rr)r&rrZclassproperty.fget9s zzr)rr r r )NNN) __name__ __module__ __qualname__Z__firstlineno____doc__rrpropertyrZ__static_attributes__Z__classdictcell__)Z __classdict__s@rr r s( !rr c sda\R4o\V\4'dV3M8VfS3M1\;QJd.V3RlV4FNK 5M!V3RlV44pV3RlpVP4Fwr4\W@4'dK.\ W 4OpRV9d#VP R4VP R4\RPT\V4^8d*RPVRR4R,VR,,MV^,V!\V4444h R#) 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) Nc3s2<"TF qfSMTxK R#5ir).0tp none_types& r Z#check_isinstance..OsCUr 92Uscs<VSJdR#VPR8Xd VP#VP RVP 2#)NoneZbuiltinsZ.)rr)r!r"s&r type_nameZ#check_isinstance..type_nameQsD / ;(* (CR__ ; a'89 ;rr$z({!r} must be an instance of {}, not a {}, z or ) Ztype isinstanceZtupleitemsmapZremoveZappend TypeErrorZformatlenjoin)Ztypeskwargsr%kvZnamesr"s", @rcheck_isinstancer1AsT I#E400eX"]i\ UCUCUUCUC C ;  !##,c)+,E V$ V$:AA5zA~IIeCRj)F2U2Y>+08d1g& () ) r_print_supported_valuesTc s&V'g \R4hVP4FVwr4W@9pV'dKV: RV 2pV'd*VRRP\ \ V44 2, p\V4h R# \dRpLai;i)a 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. _print_supported_values : bool, default: True Whether to print *values* when raising ValueError. **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!F is not a valid value for ; supported values are r&N)r+r)r r-r*repr)valuesr2r.ZkeyZvalexistsZmsgs"$, r check_in_listr8ds4 /00LLN ]FvG5cU;C&03tV;L1M0NOOS/ !!# F sB BBc sVP4EF@wr#VPp\V4\V48wgO\;QJd%R\ W@44F 'gK RM RM!R\ W@444'gKy\ \ P!RR\ P!4444pRPVRRR 1,Uu.uFpVe \V4M \V4NK upRRR 1,4p\V4^8Xd VR, p\V: R \V4 R V R VP 24h R#uupi) 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) c3sF"TFwrW8g;'dVRJxK R#5irr)r ZsZt& rr#check_shape..s%SB$$@AJ5zQc! %yU N:,G,,-GG96 $:s#E c s\V4^8wd \R4hVP4wwr#W,# \d4\T: RT RRP \ \ T44 24Rhi;i)z *kwargs* must consist of a single *key, value* pair. If *key* is in *mapping*, return ``mapping[value]``; else, raise an appropriate ValueError. Examples -------- >>> _api.check_getitem({"foo": "bar"}, arg=arg) z-check_getitem takes a single keyword argumentr3r4r&N)r,r r)ZKeyErrorr-r*r5)Zmappingr.r/r0s", r check_getitemrDs 6{aHIIllnGFQ:z :e-aS0GyyT7+,- /059 ::s 9>A7cs aaaSPR8XgQh\S4P4UUu/uFwr\V\4'gKWbK! uppoS!4o\ P VVV3Rl4pV#uuppi)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__cs|<VS9dSV,PS4#\RSP: RV: 24h)zmodule z has no attribute )rZAttributeErrorr)nameclsrpropss&rrEZ+caching_module_getattr..__getattr__sD 5=;&&x0 0cnn''9$ BD Dr)rvarsr)r(r functoolsZcache)rGrFproprErrHsf @@rcaching_module_getattrrLs{& <<= (( (*.s)//*; ,*;JD4*TZ*; ,EuH__DD  ,s BBcsaSf\P!\V4#V3RlpVP4Fwr4RpR FepWc,\ S49gKRpVFBpV!Wc,4pWg,VnRWc, R2Vn\SWg,V4KD Kg V'dK|\RV: 24h Rp \SR/4p V !V 4V !V4,p V 'd\R V 24h/V CVCSn S#) 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_map`` attribute on the class and can be used by `.normalize_kwargs` (which assumes that higher priority aliases come last). cs\<a\P!\SS44V3Rl4pV#)cs(<\VS4!V/VB#r)getattr)rargsr.rFs&*,rmethodZ2define_aliases..make_alias..methods4&77 7r)rJZwrapsrM)rFrOrGsf r make_aliasZ"define_aliases..make_aliass* d+ , 8 - 8 rFTz Alias for `z`.z%Neither getter nor setter exists for cs80VmRVP44m#)c3s4"TFqFq"xK K R#5irr)r aliasesaliasr9rr#ZBdefine_aliases..get_aliased_and_aliases..sK:7%e7e:s)r6)Zdrrget_aliased_and_aliasesZ/define_aliases..get_aliased_and_aliasessLLK188:KLLr _alias_mapz2Parent class already defines conflicting aliases: )Zget_Zset_) rJZpartialdefine_aliasesr)rIrrZsetattrr rMZNotImplementedErrorrT) Zalias_drGrPrKrQr7ZprefixrRrOrSZpreexisting_aliasesZ conflictings &f rrUrUs$ {  99 ! &F}S )$E' 6F&,nFO'26=/%DFNC8 %'v7x@B B)M"#|R8*+>?,W56K!@ NP P7+7w7CN Jrcs\V4Fwr4V!V/VBu# R# \dT\T4^, 8XdhK:i;i)a Select and call the function that accepts ``*args, **kwargs``. *funcs* is a list of functions which should not raise any exception (other than `TypeError` if the arguments passed do not match their signature). `select_matching_signature` tries to call each of the functions in *funcs* with ``*args, **kwargs`` (in the order in which they are given). Calls that fail with a `TypeError` are silently skipped. As soon as a call succeeds, `select_matching_signature` returns its return value. If no function accepts ``*args, **kwargs``, then the `TypeError` raised by the last failing call is re-raised. Callers should normally make sure that any ``*args, **kwargs`` can only bind a single *func* (to avoid any ambiguity), although this is not checked by `select_matching_signature`. Notes ----- `select_matching_signature` is intended to help implementing signature-overloaded functions. In general, such functions should be avoided, except for back-compatibility concerns. A typical use pattern is :: def my_func(*args, **kwargs): params = select_matching_signature( [lambda old1, old2: locals(), lambda new: locals()], *args, **kwargs) if "old1" in params: warn_deprecated(...) old1, old2 = params.values() # note that locals() is ordered. else: new, = params.values() # do things with params which allows *my_func* to be called either with two parameters (*old1* and *old2*) or a single one (*new*). Note that the new signature is given last, so that callers get a `TypeError` corresponding to the new signature if the arguments they passed in do not match any signature. N)Z enumerater+r,)ZfuncsrNr.r;Zfuncs&*, rselect_matching_signaturerV%sTXU# (( ($ CJN"# s #AAcs*\V RV RV R24#)zEGenerate a TypeError to be raised by function calls with wrong arity.z () takes z positional arguments but z were given)r+)rFZtakesZgivenrr nargs_errorrWYs( vYug-Gwk+ ,,rcsx\V\4'g\\V44p\ V RV R24#)a( Generate a TypeError to be raised by function calls with wrong kwarg. Parameters ---------- name : str The name of the calling function. kw : str or Iterable[str] Either the invalid keyword argument name, or an iterable yielding invalid keyword arguments (e.g., a ``kwargs`` dict). z'() got an unexpected keyword argument 'Z')r(rArBr>r+)rFZkws&&r kwarg_errorrX_s7 b#   $r(^ vDRDJ KKrc#sn"VxVP4Fp\V4RjxL K R#L 5i)z8Yield *cls* and direct and indirect subclasses of *cls*.N)Z__subclasses__recursive_subclasses)rGZsubclsr<rrYrYps. I$$&'///'/s &53 5cs"/p\PR,R 8dT\P!\4P ^,p\ VR, 4\ VR, 43VR&M\P!4p\P!^4FVpVfWRR&MM\P!RVPPRR 44'gWRR&MVPpKX ?\P !W3/VBR#) a `warnings.warn` wrapper that sets *stacklevel* to "outside Matplotlib". The original emitter of the warning can be obtained by patching this function back to `warnings.warn`, i.e. ``_api.warn_external = warnings.warn`` (or ``functools.partial(warnings.warn, stacklevel=2)``, etc.). :NiNZ matplotlibZ mpl_toolkitsZskip_file_prefixesN stacklevelz-\A(matplotlib|mpl_toolkits)(\Z|\.(?!tests\.))rZ)ii )sysZ version_infopathlibZPathZ__file__ZparentsrAZ _getframer?r@reZmatchZ f_globalsZgetZf_backwarningsZwarn)ZmessageZcategoryr.ZbasedirZframerZs&& r warn_externalr_wsF w&,,x(003(+Gl,B(C(+Gn,D(E(G#$ #//!,J}'1|$88L!OO// B?AA(2|$LLE-  MM'.v.rr)rrJr?r\r]r[r^Z deprecationrrrrrrrrrr r1r8rCrDrLrUrVrWrXrYr_rrrr`s}  """J )F,","^ F:* F4n1h, L"0/r