Mh<' SrSSKJr SSKJrJr SSKrSSKJr SSK J r "SS5r "S S 5r S S S 4SSjjr "SS5r\"SSS9SSj5r\"\SS9SSj5r\"\SS9SSj5r\"\SS9SSj5rg)z accessor.py contains base classes for implementing accessor properties that can be mixed into or pinned onto other pandas classes. ) annotations)CallablefinalN)doc)find_stack_levelc|^\rSrSr%\"5rS\S'\"5rS\S'\ S Sj5r S Sjr S U4Sjjr S r U=r$) DirNamesMixinset[str] _accessorszfrozenset[str] _hidden_attrsc4URUR-$)z* Delete unwanted __dir__ for this object. )r r )selfs F/var/www/html/env/lib/python3.13/site-packages/pandas/core/accessor.py_dir_deletionsDirNamesMixin._dir_deletionss !3!333cjURVs1sHn[X5(dMUiM sn$s snf)z) Add additional __dir__ for this object. )r hasattr)raccessors r_dir_additionsDirNamesMixin._dir_additionss'*.TXGD[[TU] 55nXR5- UR 5-n[ U5$)zX Provide method name lookup and completion. Notes ----- Only provide 'public' methods. )setsuper__dir__rrsorted)rrv __class__s rrDirNamesMixin.__dir__$s?" #&&((D,?,?,A Abzr)returnr )r" list[str])__name__ __module__ __qualname____firstlineno__rr __annotations__ frozensetr rrrr__static_attributes__ __classcell__)rs@rr r s=5J $-KM>/ 4 4 U  rr cl\rSrSrSrS SjrS SjrS Sjr\SSS4S S jj5r S r g )PandasDelegate1z8 Abstract base class for delegating methods/properties. c[SU35e)NzYou cannot access the property  TypeErrorrnameargskwargss r_delegate_property_get%PandasDelegate._delegate_property_get6s9$@AArc [SUS35e)Nz The property z cannot be setr0)rr3valuer4r5s r_delegate_property_set%PandasDelegate._delegate_property_set9s-v^<==rc[SU35e)NzYou cannot call method r0r2s r_delegate_methodPandasDelegate._delegate_method<s1$899rFcU$Nr!xs rPandasDelegate.Fs1rTc^^SUU4SjjnSUU4SjjnUH\n U(d[TT"U 5S5cM US:Xa U"U 5n OU"U 5n U(d[X 5(aMP[X U 5 M^ g)a] Add accessors to cls from the delegate class. Parameters ---------- cls Class to add the methods/properties to. delegate Class to get methods/properties and doc-strings. accessors : list of str List of accessors to add. typ : {'property', 'method'} overwrite : bool, default False Overwrite the method/property in the target class if it exists. accessor_mapping: Callable, default lambda x: x Callable to map the delegate's function to the cls' function. raise_on_missing: bool, default True Raise if an accessor does not exist on delegate. False skips the missing accessor. c >^U4SjnU4SjnTUlTUl[UU[TT"T55RS9$)Nc&>URT5$r@)r6)rr3s r_getter[PandasDelegate._add_delegate_accessors.._create_delegator_property.._getter_s22488rc(>URTU5$r@)r:)r new_valuesr3s r_setter[PandasDelegate._add_delegate_accessors.._create_delegator_property.._setterbs224DDr)fgetfsetr)r$propertygetattr__doc__)r3rHrLaccessor_mappingdelegates` r_create_delegator_propertyJPandasDelegate._add_delegate_accessors.._create_delegator_property^sI 9 E $G #G H&6t&<=EE rcf>^U4SjnTUl[TT"T55RUlU$)Nc0>UR"T/UQ70UD6$r@)r=)rr4r5r3s rfSPandasDelegate._add_delegate_accessors.._create_delegator_method..fos,,TCDCFCCr)r$rQrR)r3rYrSrTs` r_create_delegator_methodHPandasDelegate._add_delegate_accessors.._create_delegator_methodns1 DAJ*:4*@AIIAIHrNrPr3str)rQrsetattr) clsrT accessorstyp overwriterSraise_on_missingrUr[r3rYs ` ` r_add_delegate_accessors&PandasDelegate._add_delegate_accessors?ss>     D$H&6t&:  1URTTTTTTS9 U$)N)rcrSrd)re)r`rSrarTrcrdrbs radd_delegate_accessors.delegate_names..add_delegate_accessorss/ ##   -- $  rr!)rTrarbrcrSrdrns`````` rdelegate_namesrpsP   "!rc(\rSrSrSrSSjrSrSrg)CachedAccessorai Custom property-like object. A descriptor for caching accessors. Parameters ---------- name : str Namespace that will be accessed under, e.g. ``df.foo``. accessor : cls Class with the extension methods. Notes ----- For accessor, The class's __init__ method assumes that one of ``Series``, ``DataFrame`` or ``Index`` as the single argument ``data``. cXlX lgr@)_name _accessor)rr3rs r__init__CachedAccessor.__init__s  !rcUc UR$URU5n[RXRU5 U$r@)rvobject __setattr__ru)robjr` accessor_objs r__get__CachedAccessor.__get__s; ;>> !~~c* 3 L9r)rvruN)r3r^r"ri)r$r%r&r'rRrwr~r*r!rrrrrrs&" rrr)klassothersc^^UU4SjnU$)as Register a custom accessor on {klass} objects. Parameters ---------- name : str Name under which the accessor should be registered. A warning is issued if this name conflicts with a preexisting attribute. Returns ------- callable A class decorator. See Also -------- register_dataframe_accessor : Register a custom accessor on DataFrame objects. register_series_accessor : Register a custom accessor on Series objects. register_index_accessor : Register a custom accessor on Index objects. Notes ----- When accessed, your accessor will be initialized with the pandas object the user is interacting with. So the signature must be .. code-block:: python def __init__(self, pandas_object): # noqa: E999 ... For consistency with pandas methods, you should raise an ``AttributeError`` if the data passed to your accessor has an incorrect dtype. >>> pd.Series(['a', 'b']).dt Traceback (most recent call last): ... AttributeError: Can only use .dt accessor with datetimelike values Examples -------- In your library code:: import pandas as pd @pd.api.extensions.register_dataframe_accessor("geo") class GeoAccessor: def __init__(self, pandas_obj): self._obj = pandas_obj @property def center(self): # return the geographic center point of this DataFrame lat = self._obj.latitude lon = self._obj.longitude return (float(lon.mean()), float(lat.mean())) def plot(self): # plot this array's data on a map, e.g., using Cartopy pass Back in an interactive IPython session: .. code-block:: ipython In [1]: ds = pd.DataFrame({{"longitude": np.linspace(0, 10), ...: "latitude": np.linspace(0, 20)}}) In [2]: ds.geo.center Out[2]: (5.0, 10.0) In [3]: ds.geo.plot() # plots data on a map c >[TT5(aG[R"S[U5S[T5S[T5S3[[ 5S9 [ TT[TU55 TRRT5 U$)Nzregistration of accessor z under name z for type z: is overriding a preexisting attribute with the same name.) stacklevel) rwarningswarnrepr UserWarningrr_rrr add)rr`r3s r decorator%_register_accessor..decorator2s~ 3   MM+DN+;<:,jc 401+-   T>$9: 4 rr!)r3r`rs`` r_register_accessorrsR  r DataFrame)rc$SSKJn [X5$)Nr)r)pandasrr)r3rs rregister_dataframe_accessorrBs d ..rSeriesc$SSKJn [X5$)Nr)r)rrr)r3rs rregister_series_accessorrIs d ++rIndexc$SSKJn [X5$)Nr)r)rrr)r3rs rregister_index_accessorrPs d **r) rar#rbr^rcrgrSrhrdrgr])rR __future__rtypingrrrpandas.util._decoratorsrpandas.util._exceptionsrr r-rprrrrrrr!rrrs #'4