projektAI/venv/Lib/site-packages/pandas/core/strings/base.py
2021-06-06 22:13:05 +02:00

226 lines
4.6 KiB
Python

import abc
from typing import Pattern, Union
import numpy as np
from pandas._typing import Scalar
class BaseStringArrayMethods(abc.ABC):
"""
Base class for extension arrays implementing string methods.
This is where our ExtensionArrays can override the implementation of
Series.str.<method>. We don't expect this to work with
3rd-party extension arrays.
* User calls Series.str.<method>
* pandas extracts the extension array from the Series
* pandas calls ``extension_array._str_<method>(*args, **kwargs)``
* pandas wraps the result, to return to the user.
See :ref:`Series.str` for the docstring of each method.
"""
def _str_getitem(self, key):
if isinstance(key, slice):
return self._str_slice(start=key.start, stop=key.stop, step=key.step)
else:
return self._str_get(key)
@abc.abstractmethod
def _str_count(self, pat, flags=0):
pass
@abc.abstractmethod
def _str_pad(self, width, side="left", fillchar=" "):
pass
@abc.abstractmethod
def _str_contains(self, pat, case=True, flags=0, na=None, regex=True):
pass
@abc.abstractmethod
def _str_startswith(self, pat, na=None):
pass
@abc.abstractmethod
def _str_endswith(self, pat, na=None):
pass
@abc.abstractmethod
def _str_replace(self, pat, repl, n=-1, case=None, flags=0, regex=True):
pass
@abc.abstractmethod
def _str_repeat(self, repeats):
pass
@abc.abstractmethod
def _str_match(
self,
pat: Union[str, Pattern],
case: bool = True,
flags: int = 0,
na: Scalar = np.nan,
):
pass
@abc.abstractmethod
def _str_fullmatch(
self,
pat: Union[str, Pattern],
case: bool = True,
flags: int = 0,
na: Scalar = np.nan,
):
pass
@abc.abstractmethod
def _str_encode(self, encoding, errors="strict"):
pass
@abc.abstractmethod
def _str_find(self, sub, start=0, end=None):
pass
@abc.abstractmethod
def _str_rfind(self, sub, start=0, end=None):
pass
@abc.abstractmethod
def _str_findall(self, pat, flags=0):
pass
@abc.abstractmethod
def _str_get(self, i):
pass
@abc.abstractmethod
def _str_index(self, sub, start=0, end=None):
pass
@abc.abstractmethod
def _str_rindex(self, sub, start=0, end=None):
pass
@abc.abstractmethod
def _str_join(self, sep):
pass
@abc.abstractmethod
def _str_partition(self, sep, expand):
pass
@abc.abstractmethod
def _str_rpartition(self, sep, expand):
pass
@abc.abstractmethod
def _str_len(self):
pass
@abc.abstractmethod
def _str_slice(self, start=None, stop=None, step=None):
pass
@abc.abstractmethod
def _str_slice_replace(self, start=None, stop=None, repl=None):
pass
@abc.abstractmethod
def _str_translate(self, table):
pass
@abc.abstractmethod
def _str_wrap(self, width, **kwargs):
pass
@abc.abstractmethod
def _str_get_dummies(self, sep="|"):
pass
@abc.abstractmethod
def _str_isalnum(self):
pass
@abc.abstractmethod
def _str_isalpha(self):
pass
@abc.abstractmethod
def _str_isdecimal(self):
pass
@abc.abstractmethod
def _str_isdigit(self):
pass
@abc.abstractmethod
def _str_islower(self):
pass
@abc.abstractmethod
def _str_isnumeric(self):
pass
@abc.abstractmethod
def _str_isspace(self):
pass
@abc.abstractmethod
def _str_istitle(self):
pass
@abc.abstractmethod
def _str_isupper(self):
pass
@abc.abstractmethod
def _str_capitalize(self):
pass
@abc.abstractmethod
def _str_casefold(self):
pass
@abc.abstractmethod
def _str_title(self):
pass
@abc.abstractmethod
def _str_swapcase(self):
pass
@abc.abstractmethod
def _str_lower(self):
pass
@abc.abstractmethod
def _str_upper(self):
pass
@abc.abstractmethod
def _str_normalize(self, form):
pass
@abc.abstractmethod
def _str_strip(self, to_strip=None):
pass
@abc.abstractmethod
def _str_lstrip(self, to_strip=None):
pass
@abc.abstractmethod
def _str_rstrip(self, to_strip=None):
pass
@abc.abstractmethod
def _str_split(self, pat=None, n=-1, expand=False):
pass
@abc.abstractmethod
def _str_rsplit(self, pat=None, n=-1):
pass