Ë
|
nñúh<' ã ó, d Z ddlmZ ddlmZmZ ddlZddlmZ ddl m
|
Z
|
G d d« Z G d d
|
« Z d d d f ddZ G d d« Z edd¬« d d« Z eed¬« d d« Z eed¬« d d« Z eed¬« d d« Zy) z
|
|
accessor.py contains base classes for implementing accessor properties
|
that can be mixed into or pinned onto other pandas classes.
|
|
é )Ú annotations)ÚCallableÚfinalN)Údoc)Úfind_stack_levelc ól e Zd ZU e« Zded< e« Zded< edd« Z ddZ
|
d fd Z xZ S )
|
Ú DirNamesMixinúset[str]Ú
|
_accessorszfrozenset[str]Ú _hidden_attrsc ó4 | j | j z S )z:
|
Delete unwanted __dir__ for this object.
|
)r r )Úselfs úGH:\Change_password\venv_build\Lib\site-packages\pandas/core/accessor.pyÚ_dir_deletionsz DirNamesMixin._dir_deletions s ð
|
×!3Ñ!3Ñ3Ð3ó c óZ | j D ch c] }t | |« s| c}S c c}w )z9
|
Add additional __dir__ for this object.
|
)r Úhasattr)r Úaccessors r Ú_dir_additionsz DirNamesMixin._dir_additions s% ð *.¯ © ÖTX¼GÀDÈ(Õ<SÒTÐTùÒTs (¡(c ó t t | « « }|| j « z
|
| j « z }t |« S )z
|
Provide method name lookup and completion.
|
|
Notes
|
-----
|
Only provide 'public' methods.
|
)ÚsetÚsuperÚ__dir__r r Úsorted)r ÚrvÚ __class__s r r zDirNamesMixin.__dir__$ sA ø ô Ó"Ó #Ø4×&Ñ&Ó(Ñ(¨D×,?Ñ,?Ó,AÑ AÜbzÐr )Úreturnr
|
)r ú list[str]) Ú__name__Ú
|
__module__Ú __qualname__r r Ú__annotations__Ú frozensetr r r r r Ú __classcell__)r s @r r r s= ø
Ù 5JÓ Ù$-£KM>Ó/à
|
ò4ó ð4ó U÷
|
ñ
|
r r c óZ e Zd ZdZd
|
dZd
|
dZd
|
dZedd df d d« Zy ) ÚPandasDelegatez@
|
Abstract base class for delegating methods/properties.
|
c ó t d| « )Nz You cannot access the property ©Ú TypeError©r ÚnameÚargsÚkwargss r Ú_delegate_property_getz%PandasDelegate._delegate_property_get6 s ÜÐ9¸$¸Ð@ÓAÐAr c ó t d| d« )Nz The property z cannot be setr( )r r+ Úvaluer, r- s r Ú_delegate_property_setz%PandasDelegate._delegate_property_set9 s Ü-¨ v¨^Ð<Ó=Ð=r c ó t d| « )NzYou cannot call method r( r* s r Ú_delegate_methodz PandasDelegate._delegate_method< s ÜÐ1°$°Ð8Ó9Ð9r Fc ó | S ©N© ©Úxs r ú<lambda>zPandasDelegate.<lambda>F s ¸1 r Tc ó dfd }dfd }|D ]J } |st | « d« |dk( r || « }
|
n || « }
|
|s t | | « r>t | | |
|
« L y)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
|
ó fd} fd} |_ |_ t ||t « « j ¬« S )Nc ó& | j « S r5 )r. )r r+ s r Ú_getterz[PandasDelegate._add_delegate_accessors.<locals>._create_delegator_property.<locals>._getter_ s ø Ø×2Ñ2°4Ó8Ð8r c ó( | j |« S r5 )r1 )r Ú
|
new_valuesr+ s r Ú_setterz[PandasDelegate._add_delegate_accessors.<locals>._create_delegator_property.<locals>._setterb s ø Ø×2Ñ2°4¸ÓDÐDr )ÚfgetÚfsetr )r ÚpropertyÚgetattrÚ__doc__)r+ r= r@ Úaccessor_mappingÚdelegates ` r Ú_create_delegator_propertyzJPandasDelegate._add_delegate_accessors.<locals>._create_delegator_property^ sI ù ô 9ô Eð $GÔ Ø #GÔ äØ Ø ÜHÑ&6°tÓ&<Ó=×EÑEôð r c ód fd} |_ t « « j |_ |S )Nc ó0 | j g|¢i |¤S r5 )r3 )r r, r- r+ s r ÚfzSPandasDelegate._add_delegate_accessors.<locals>._create_delegator_method.<locals>.fo s ø Ø,t×,Ñ,¨TÐC°DÒC¸FÑCÐCr )r rD rE )r+ rK rF rG s ` r Ú_create_delegator_methodzHPandasDelegate._add_delegate_accessors.<locals>._create_delegator_methodn s1 ù ô Dð AJÜ Ñ*:¸4Ó*@ÓA×IÑIAIàHr NrC ©r+ Ústr)rD r Úsetattr) ÚclsrG Ú accessorsÚtypÚ overwriterF Úraise_on_missingrH rL r+ rK s ` ` r Ú_add_delegate_accessorsz&PandasDelegate._add_delegate_accessors? so ù ö> ö ð ò &Dá$ÜHÑ&6°tÓ&<¸dÓCÐKààjÒ Ù.¨tÓ4á,¨TÓ2ñ ¤¨¨TÕ 2ÜT 1Õ%ñ &r NrM ) rQ r rR rN rS ÚboolrF úCallable[[str], str]rT rV r ÚNone) r r r! rE r. r1 r3 Ú classmethodrU r6 r r r& r& 1 sz ñóBó>ó:ð ð Ù1<Ø!%ðE&ð ðE&ð ð E&ð
|
ð E&ð /ð E&ð ðE&ð
|
òE&ó ñE&r r& Fc ó | S r5 r6 r7 s r r9 r9 s °q r Tc ó& fd}|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.
|
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.
|
|
Returns
|
-------
|
callable
|
A class decorator.
|
|
Examples
|
--------
|
@delegate_names(Categorical, ["categories", "ordered"], "property")
|
class CategoricalAccessor(PandasDelegate):
|
[...]
|
c ó6 | j ¬« | S )N)rS rF rT )rU )rP rF rQ rG rS rT rR s r Úadd_delegate_accessorsz.delegate_names.<locals>.add_delegate_accessors° s/ ø Ø ×#Ñ#Ø Ø Ø Ø Ø -Ø -ð $ô
|
ð
|
r r6 )rG rQ rR rS rF rT r] s `````` r Údelegate_namesr^ s ý ÷P ñ ð "Ð!r c ó e Zd ZdZddZd Zy)Ú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 ó || _ || _ y r5 )Ú_nameÚ _accessor)r r+ r s r Ú__init__zCachedAccessor.__init__Ø s Ø
|
Ø!r c ó | | j S | j |« }t j || j |« |S r5 )rc ÚobjectÚ __setattr__rb )r ÚobjrP Ú accessor_objs r Ú__get__zCachedAccessor.__get__Ü s= Ø ;à>>Ð !Ø~~ cÓ* ô
|
×Ñ3 §
|
¡
|
¨LÔ9ØÐr N)r+ rN r rX )r r r! rE rd rj r6 r r r` r` Ä s ñó&"ó
|
r r` Ú )ÚklassÚothersc ó fd}|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
|
ó t « rIt j dt | « dt « dt « dt t « ¬« t t | « « j j « | S )Nzregistration of accessor z under name z
|
for type z: is overriding a preexisting attribute with the same name.)Ú
|
stacklevel)
|
r ÚwarningsÚwarnÚreprÚ UserWarningr rO r` r Úadd)r rP r+ s r Ú decoratorz%_register_accessor.<locals>.decorator2 s{ ø Ü 3Ô Ü MMØ+¬D°«NÐ+;¸<Ü:,j¬¨c«¨ ð 40ð1ô Ü+Ó-õ ô T>¨$°Ó9Ô:Ø ×Ñ4Ô Ør r6 )r+ rP rv s `` r Ú_register_accessorrw é s ù õR ð Ðr Ú DataFrame)rl c ó& ddl m} t | |« S )Nr )rx )Úpandasrx rw )r+ rx s r Úregister_dataframe_accessorr{ B s å ä d IÓ .Ð.r ÚSeriesc ó& ddl m} t | |« S )Nr )r| )rz r| rw )r+ r| s r Úregister_series_accessorr~ I s å ä d FÓ +Ð+r ÚIndexc ó& ddl m} t | |« S )Nr )r )rz r rw )r+ r s r Úregister_index_accessorr P s å ä d EÓ *Ð*r )
|
rQ r rR rN rS rV rF rW rT rV rM )rE Ú
|
__future__r Útypingr r rq Úpandas.util._decoratorsr Úpandas.util._exceptionsr r r& r^ r` rw r{ r~ r r6 r r ú<module>r sô ðñõ #÷ó å 'Ý 4÷ñ ÷<T&ñ T&ðv Ù-8Ø !ð 3"àð3"ð
|
ð3"ð ð 3"ð
|
+ð 3"ð ó 3"÷x" ñ " ñJ 2bÔòUó ðUñp Ð{Ô+ò/ó ,ð/ñ ÐxÔ(ò,ó )ð,ñ ÐwÔ'ò+ó (ñ+r
|
