`Vg!dZddlmZddlZddlmZddlmZGddZGdd Z ddd Z Gd d Z ed d dZ ee ddZ ee ddZee ddZy)z accessor.py contains base classes for implementing accessor properties that can be mixed into or pinned onto other pandas classes. ) annotationsN)doc)find_stack_levelcbeZdZUeZded<eZded<ddZddZ d fd Z xZ S) DirNamesMixinset[str] _accessorszfrozenset[str] _hidden_attrsc4|j|jzS)z: Delete unwanted __dir__ for this object. )r r )selfs U/var/www/html/hubwallet-dev/venv/lib/python3.12/site-packages/pandas/core/accessor.py_dir_deletionszDirNamesMixin._dir_deletionss!3!333cZ|jDchc]}t||s|c}Scc}w)z9 Add additional __dir__ for this object. )r hasattr)r accessors r _dir_additionszDirNamesMixin._dir_additionss%*.TXGD(/4 U  rrc>eZdZdZdZdZdZe d ddZy) PandasDelegatez@ Abstract base class for delegating methods/properties. ctd|)NzYou cannot access the property  TypeErrorr nameargskwargss r _delegate_property_getz%PandasDelegate._delegate_property_get1s9$@AArc td|d)Nz The property z cannot be setr%)r r(valuer)r*s r _delegate_property_setz%PandasDelegate._delegate_property_set4s-v^<==rctd|)NzYou cannot call method r%r's r _delegate_methodzPandasDelegate._delegate_method7s1$899rcfd}fd}|D]4}|dk(r ||}n||}|s t||r(t|||6y)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. czfd}fd}|_|_t||tjS)Nc&|jSN)r+)r r(s r _getterz[PandasDelegate._add_delegate_accessors.._create_delegator_property.._getterOs22488rc(|j|Sr4)r.)r new_valuesr(s r _setterz[PandasDelegate._add_delegate_accessors.._create_delegator_property.._setterRs224DDr)fgetfsetr)rpropertygetattr__doc__)r(r5r8delegates` r _create_delegator_propertyzJPandasDelegate._add_delegate_accessors.._create_delegator_propertyNsA 9 E $G #G 7$0G0O0O rcXfd}|_tj|_|S)Nc0|jg|i|Sr4)r0)r r)r*r(s r fzSPandasDelegate._add_delegate_accessors.._create_delegator_method..f]s ,t,,TCDCFCCr)rr<r=)r(rBr>s` r _create_delegator_methodzHPandasDelegate._add_delegate_accessors.._create_delegator_method\s+ DAJ$/77AIHrr;N)rsetattr) clsr> accessorstyp overwriter?rCr(rBs ` r _add_delegate_accessorsz&PandasDelegate._add_delegate_accessors:sT(   &Dj .t4,T2T 2T1% &rNFrGstrrHbool) rrrr=r+r.r0 classmethodrIrr r#r#,s>B>:>C3&'*3&7;3&3&rr#cfd}|S)a Add delegated names to a class using a class decorator. This provides an alternative usage to directly calling `_add_delegate_accessors` below a class definition. Parameters ---------- delegate : object The class to get methods/properties & doc-strings. accessors : Sequence[str] List of accessor to add. typ : {'property', 'method'} overwrite : bool, default False Overwrite the method/property in the target class if it exists. Returns ------- callable A class decorator. Examples -------- @delegate_names(Categorical, ["categories", "ordered"], "property") class CategoricalAccessor(PandasDelegate): [...] c2|j|S)N)rH)rI)rErFr>rHrGs r add_delegate_accessorsz.delegate_names..add_delegate_accessorss ##Hi #R rrO)r>rFrGrHrRs```` r delegate_namesrSqs8 "!rceZdZdZddZdZy)CachedAccessora 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``. c ||_||_yr4)_name _accessor)r r(rs r __init__zCachedAccessor.__init__s !rc| |jS|j|}tj||j||Sr4)rXobject __setattr__rW)r objrE accessor_objs r __get__zCachedAccessor.__get__s= ;>> !~~c* 3 L9rN)r(rLrNone)rrrr=rYr_rOrr rUrUs&" rrU)klassotherscfd}|S)aG 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 trItjdt|dtdtdtt t t|jj|S)Nzregistration of accessor z under name z for type z: is overriding a preexisting attribute with the same name.) stacklevel) rwarningswarnrepr UserWarningrrDrUr add)rrEr(s r decoratorz%_register_accessor..decorators{ 3  MM+DN+;<:,jc 401+-   T>$9: 4 rrO)r(rErls`` r _register_accessorrmsR  r DataFrame)rbc&ddlm}t||S)Nr)rn)pandasrnrm)r(rns r register_dataframe_accessorrqs dI ..rSeriesc&ddlm}t||S)Nr)rr)rprrrm)r(rrs r register_series_accessorrts dF ++rIndexc&ddlm}t||S)Nr)ru)rprurm)r(rus r register_index_accessorrw&s dE **rrJrK)r= __future__rrgpandas.util._decoratorsrpandas.util._exceptionsrrr#rSrUrmrqrtrwrOrr r{s #'4:B&B&J "R""J2bUUp{+/,/ x(,), w'+(+r