DOC: Set __module__ attributes and remove core from documentation

ci/code_checks.sh

@@ -73,10 +73,12 @@ if [[ -z "$CHECK" || "$CHECK" == "docstrings" ]]; then
         -i "pandas.Period.freq GL08" \
         -i "pandas.Period.ordinal GL08" \
         -i "pandas.errors.IncompatibleFrequency SA01,SS06,EX01" \
+        -i "pandas.errors.InvalidVersion GL08" \
         -i "pandas.api.extensions.ExtensionArray.value_counts EX01,RT03,SA01" \
-        -i "pandas.core.groupby.DataFrameGroupBy.plot PR02" \
-        -i "pandas.core.groupby.SeriesGroupBy.plot PR02" \
-        -i "pandas.core.resample.Resampler.quantile PR01,PR07" \
+        -i "pandas.api.typing.DataFrameGroupBy.plot PR02" \
+        -i "pandas.api.typing.SeriesGroupBy.plot PR02" \
+        -i "pandas.api.typing.Resampler.quantile PR01,PR07" \
+        -i "pandas.arrays.NumpyExtensionArray GL08" \
         -i "pandas.tseries.offsets.BDay PR02,SA01" \
         -i "pandas.tseries.offsets.BHalfYearBegin.is_on_offset GL08" \
         -i "pandas.tseries.offsets.BHalfYearBegin.n GL08" \

doc/source/reference/groupby.rst

@@ -5,7 +5,7 @@
 =======
 GroupBy
 =======
-.. currentmodule:: pandas.core.groupby
+.. currentmodule:: pandas.api.typing
 
 :class:`pandas.api.typing.DataFrameGroupBy` and :class:`pandas.api.typing.SeriesGroupBy`
 instances are returned by groupby calls :func:`pandas.DataFrame.groupby` and
@@ -40,7 +40,7 @@ Function application helper
 
    NamedAgg
 
-.. currentmodule:: pandas.core.groupby
+.. currentmodule:: pandas.api.typing
 
 Function application
 --------------------

doc/source/reference/resampling.rst

@@ -5,7 +5,7 @@
 ==========
 Resampling
 ==========
-.. currentmodule:: pandas.core.resample
+.. currentmodule:: pandas.api.typing
 
 :class:`pandas.api.typing.Resampler` instances are returned by
 resample calls: :func:`pandas.DataFrame.resample`, :func:`pandas.Series.resample`.

doc/source/reference/window.rst

@@ -17,7 +17,7 @@ calls: :func:`pandas.DataFrame.ewm` and :func:`pandas.Series.ewm`.
 
 Rolling window functions
 ------------------------
-.. currentmodule:: pandas.core.window.rolling
+.. currentmodule:: pandas.api.typing
 
 .. autosummary::
    :toctree: api/
@@ -48,7 +48,8 @@ Rolling window functions
 
 Weighted window functions
 -------------------------
-.. currentmodule:: pandas.core.window.rolling
+.. currentmodule:: pandas.api.typing
+
 
 .. autosummary::
    :toctree: api/
@@ -62,7 +63,8 @@ Weighted window functions
 
 Expanding window functions
 --------------------------
-.. currentmodule:: pandas.core.window.expanding
+.. currentmodule:: pandas.api.typing
+
 
 .. autosummary::
    :toctree: api/
@@ -93,7 +95,8 @@ Expanding window functions
 
 Exponentially-weighted window functions
 ---------------------------------------
-.. currentmodule:: pandas.core.window.ewm
+.. currentmodule:: pandas.api.typing
+
 
 .. autosummary::
    :toctree: api/

doc/source/user_guide/enhancingperf.rst

@@ -455,7 +455,7 @@ by evaluate arithmetic and boolean expression all at once for large :class:`~pan
    :func:`~pandas.eval` is many orders of magnitude slower for
    smaller expressions or objects than plain Python. A good rule of thumb is
    to only use :func:`~pandas.eval` when you have a
-   :class:`~pandas.core.frame.DataFrame` with more than 10,000 rows.
+   :class:`~pandas.DataFrame` with more than 10,000 rows.
 
 Supported syntax
 ~~~~~~~~~~~~~~~~

pandas/_config/config.py

@@ -101,7 +101,6 @@ class RegisteredOption(NamedTuple):
 
 
 class OptionError(AttributeError, KeyError):
-    __module__ = "pandas.errors"
     """
     Exception raised for pandas.options.
 
@@ -118,6 +117,8 @@ class OptionError(AttributeError, KeyError):
     OptionError: No such option
     """
 
+    __module__ = "pandas.errors"
+
 
 #
 # User API
@@ -412,6 +413,10 @@ def __init__(self, d: dict[str, Any], prefix: str = "") -> None:
         object.__setattr__(self, "prefix", prefix)
 
     def __setattr__(self, key: str, val: Any) -> None:
+        if key == "__module__":
+            # Need to be able to set __module__ to pandas for pandas.options
+            super().__setattr__(key, val)
+            return
         prefix = object.__getattribute__(self, "prefix")
         if prefix:
             prefix += "."
@@ -442,6 +447,7 @@ def __dir__(self) -> list[str]:
 
 
 options = DictWrapper(_global_config)
+options.__module__ = "pandas"
 
 #
 # Functions for use by pandas developers, in addition to User - api

pandas/_libs/lib.pyx

@@ -2944,7 +2944,9 @@ class _NoDefault(Enum):
 
 # Note: no_default is exported to the public API in pandas.api.extensions
 no_default = _NoDefault.no_default  # Sentinel indicating the default value.
+no_default.__module__ = "pandas.api.extensions"
 NoDefault = Literal[_NoDefault.no_default]
+NoDefault.__module__ = "pandas.api.typing"
 
 
 @cython.boundscheck(False)

pandas/_libs/missing.pyx

@@ -546,3 +546,4 @@ class NAType(C_NAType):
 
 C_NA = NAType()   # C-visible
 NA = C_NA         # Python-visible
+NA.__module__ = "pandas"

pandas/_libs/tslibs/nattype.pyx

@@ -1871,6 +1871,7 @@ default 'raise'
 
 c_NaT = NaTType()  # C-visible
 NaT = c_NaT        # Python-visible
+NaT.__module__ = "pandas"
 
 
 # ----------------------------------------------------------------------

pandas/_libs/tslibs/period.pyx

@@ -1627,11 +1627,11 @@ DIFFERENT_FREQ = ("Input has different freq={other_freq} "
 
 
 class IncompatibleFrequency(TypeError):
-    __module__ = "pandas.errors"
     """
     Raised when trying to compare or operate between Periods with different
     frequencies.
     """
+    __module__ = "pandas.errors"
     pass
 
 

pandas/_typing.py

@@ -107,7 +107,7 @@
 
 
 class SequenceNotStr(Protocol[_T_co]):
-    __module__ = "pandas.api.typing.aliases"
+    __module__: str = "pandas.api.typing.aliases"
 
     @overload
     def __getitem__(self, index: SupportsIndex, /) -> _T_co: ...
@@ -280,15 +280,15 @@ def tell(self) -> int:
 
 
 class ReadBuffer(BaseBuffer, Protocol[AnyStr_co]):
-    __module__ = "pandas.api.typing.aliases"
+    __module__: str = "pandas.api.typing.aliases"
 
     def read(self, n: int = ..., /) -> AnyStr_co:
         # for BytesIOWrapper, gzip.GzipFile, bz2.BZ2File
         ...
 
 
 class WriteBuffer(BaseBuffer, Protocol[AnyStr_contra]):
-    __module__ = "pandas.api.typing.aliases"
+    __module__: str = "pandas.api.typing.aliases"
 
     def write(self, b: AnyStr_contra, /) -> Any:
         # for gzip.GzipFile, bz2.BZ2File
@@ -300,19 +300,19 @@ def flush(self) -> Any:
 
 
 class ReadPickleBuffer(ReadBuffer[bytes], Protocol):
-    __module__ = "pandas.api.typing.aliases"
+    __module__: str = "pandas.api.typing.aliases"
 
     def readline(self) -> bytes: ...
 
 
 class WriteExcelBuffer(WriteBuffer[bytes], Protocol):
-    __module__ = "pandas.api.typing.aliases"
+    __module__: str = "pandas.api.typing.aliases"
 
     def truncate(self, size: int | None = ..., /) -> int: ...
 
 
 class ReadCsvBuffer(ReadBuffer[AnyStr_co], Protocol):
-    __module__ = "pandas.api.typing.aliases"
+    __module__: str = "pandas.api.typing.aliases"
 
     def __iter__(self) -> Iterator[AnyStr_co]:
         # for engine=python

pandas/core/apply.py

@@ -76,7 +76,6 @@
 
 
 class BaseExecutionEngine(abc.ABC):
-    __module__ = "pandas.api.executors"
     """
     Base class for execution engines for map and apply methods.
 
@@ -89,6 +88,8 @@ class BaseExecutionEngine(abc.ABC):
     simply runs the code with the Python interpreter and pandas.
     """
 
+    __module__ = "pandas.api.executors"
+
     @staticmethod
     @abc.abstractmethod
     def map(

pandas/core/arrays/arrow/array.py

@@ -246,7 +246,6 @@ class ArrowExtensionArray(
     ExtensionArraySupportsAnyAll,
     ArrowStringArrayMixin,
 ):
-    __module__ = "pandas.arrays"
     """
     Pandas ExtensionArray backed by a PyArrow ChunkedArray.
 
@@ -297,6 +296,8 @@ class ArrowExtensionArray(
     Length: 3, dtype: int64[pyarrow]
     """  # noqa: E501 (http link too long)
 
+    __module__ = "pandas.arrays"
+
     _pa_array: pa.ChunkedArray
     _dtype: ArrowDtype
 

pandas/core/arrays/base.py

@@ -106,7 +106,6 @@
 
 
 class ExtensionArray:
-    __module__ = "pandas.api.extensions"
     """
     Abstract base class for custom 1-D array types.
 
@@ -257,6 +256,8 @@ class ExtensionArray:
     https://github.com/pandas-dev/pandas/blob/main/pandas/tests/extension/list/array.py
     """
 
+    __module__ = "pandas.api.extensions"
+
     # '_typ' is for pandas.core.dtypes.generic.ABCExtensionArray.
     # Don't override this.
     _typ = "extension"
@@ -1807,7 +1808,7 @@ def take(
         .. code-block:: python
 
            def take(self, indices, allow_fill=False, fill_value=None):
-               from pandas.core.algorithms import take
+               from pandas.api.extensions import take
 
                # If the ExtensionArray is backed by an ndarray, then
                # just pass that here instead of coercing to object.
@@ -2788,7 +2789,6 @@ def _add_logical_ops(cls) -> None:
 
 
 class ExtensionScalarOpsMixin(ExtensionOpsMixin):
-    __module__ = "pandas.api.extensions"
     """
     A mixin for defining ops on an ExtensionArray.
 
@@ -2814,6 +2814,8 @@ class ExtensionScalarOpsMixin(ExtensionOpsMixin):
        with NumPy arrays.
     """
 
+    __module__ = "pandas.api.extensions"
+
     @classmethod
     def _create_method(cls, op, coerce_to_dtype: bool = True, result_dtype=None):
         """

pandas/core/arrays/boolean.py

@@ -246,7 +246,6 @@ def coerce_to_array(
 
 
 class BooleanArray(BaseMaskedArray):
-    __module__ = "pandas.arrays"
     """
     Array of boolean (True/False) data with missing values.
 
@@ -305,6 +304,8 @@ class BooleanArray(BaseMaskedArray):
     Length: 3, dtype: boolean
     """
 
+    __module__ = "pandas.arrays"
+
     _TRUE_VALUES = {"True", "TRUE", "true", "1", "1.0"}
     _FALSE_VALUES = {"False", "FALSE", "false", "0", "0.0"}
 

pandas/core/arrays/categorical.py

@@ -246,7 +246,6 @@ def contains(cat, key, container) -> bool:
 
 
 class Categorical(NDArrayBackedExtensionArray, PandasObject, ObjectStringArrayMixin):
-    __module__ = "pandas"
     """
     Represent a categorical variable in classic R / S-plus fashion.
 
@@ -362,6 +361,8 @@ class Categorical(NDArrayBackedExtensionArray, PandasObject, ObjectStringArrayMi
     'c'
     """
 
+    __module__ = "pandas"
+
     # For comparisons, so that numpy uses our implementation if the compare
     # ops, which raise
     __array_priority__ = 1000

pandas/core/arrays/datetimes.py

@@ -172,7 +172,6 @@ def f(self):
 
 
 class DatetimeArray(dtl.TimelikeOps, dtl.DatelikeOps):
-    __module__ = "pandas.arrays"
     """
     Pandas ExtensionArray for tz-naive or tz-aware datetime data.
 
@@ -224,6 +223,8 @@ class DatetimeArray(dtl.TimelikeOps, dtl.DatelikeOps):
     Length: 2, dtype: datetime64[s]
     """
 
+    __module__ = "pandas.arrays"
+
     _typ = "datetimearray"
     _internal_fill_value = np.datetime64("NaT", "ns")
     _recognized_scalars = (datetime, np.datetime64)

pandas/core/arrays/floating.py

@@ -64,7 +64,6 @@ def _safe_cast(cls, values: np.ndarray, dtype: np.dtype, copy: bool) -> np.ndarr
 
 
 class FloatingArray(NumericArray):
-    __module__ = "pandas.arrays"
     """
     Array of floating (optional missing) values.
 
@@ -130,6 +129,8 @@ class FloatingArray(NumericArray):
     Length: 3, dtype: Float32
     """
 
+    __module__ = "pandas.arrays"
+
     _dtype_cls = FloatingDtype
 
 

pandas/core/arrays/integer.py

@@ -72,7 +72,6 @@ def _safe_cast(cls, values: np.ndarray, dtype: np.dtype, copy: bool) -> np.ndarr
 
 
 class IntegerArray(NumericArray):
-    __module__ = "pandas.arrays"
     """
     Array of integer (optional missing) values.
 
@@ -143,6 +142,8 @@ class IntegerArray(NumericArray):
     Length: 3, dtype: UInt16
     """
 
+    __module__ = "pandas.arrays"
+
     _dtype_cls = IntegerDtype
 
 

pandas/core/arrays/interval.py

@@ -177,7 +177,6 @@
 
 
 class IntervalArray(IntervalMixin, ExtensionArray):
-    __module__ = "pandas.arrays"
     """
     Pandas array for interval data that are closed on the same side.
 
@@ -244,6 +243,8 @@ class IntervalArray(IntervalMixin, ExtensionArray):
     :meth:`IntervalArray.from_breaks`, and :meth:`IntervalArray.from_tuples`.
     """
 
+    __module__ = "pandas.arrays"
+
     can_hold_na = True
     _na_value = _fill_value = np.nan