pandas-dev · jbrockmendel · Oct 19, 2025 · Oct 18, 2025 · Oct 18, 2025 · Oct 18, 2025
@@ -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" \

diff --git a/doc/source/reference/groupby.rst b/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
 --------------------

diff --git a/doc/source/reference/resampling.rst b/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`.

diff --git a/doc/source/reference/window.rst b/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/

diff --git a/doc/source/user_guide/enhancingperf.rst b/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
 ~~~~~~~~~~~~~~~~

diff --git a/meson.build b/meson.build
@@ -18,6 +18,9 @@ versioneer = files('generate_version.py')
 
 add_project_arguments('-DNPY_NO_DEPRECATED_API=0', language: 'c')
 add_project_arguments('-DNPY_NO_DEPRECATED_API=0', language: 'cpp')
+# Enables settings __module__ on cdef classes
+# https://github.com/cython/cython/issues/7231
+add_project_arguments('-DCYTHON_USE_TYPE_SPECS=1', language: 'c')
 
 # Allow supporting older numpys than the version compiled against
 # Set the define to the min supported version of numpy for pandas

diff --git a/pandas/_config/config.py b/pandas/_config/config.py
@@ -117,6 +117,8 @@ class OptionError(AttributeError, KeyError):
     OptionError: No such option
     """
 
+    __module__ = "pandas.errors"
+
 
 #
 # User API
@@ -441,6 +443,8 @@ def __dir__(self) -> list[str]:
 
 
 options = DictWrapper(_global_config)
+# DictWrapper defines a custom setattr
+object.__setattr__(options, "__module__", "pandas")
 
 #
 # Functions for use by pandas developers, in addition to User - api

diff --git a/pandas/_libs/interval.pyx b/pandas/_libs/interval.pyx
@@ -382,6 +382,7 @@ cdef class Interval(IntervalMixin):
     >>> year_2017.length
     Timedelta('365 days 00:00:00')
     """
+    __module__ = "pandas"
     _typ = "interval"
     __array_priority__ = 1000
 
@@ -444,6 +445,7 @@ cdef class Interval(IntervalMixin):
     >>> interval.closed
     'left'
     """
+    __module__ = "pandas"
 
     def __init__(self, left, right, str closed="right"):
         # note: it is faster to just do these checks than to use a special

diff --git a/pandas/_libs/lib.pyx b/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)

diff --git a/pandas/_libs/missing.pyx b/pandas/_libs/missing.pyx
@@ -393,7 +393,7 @@ class NAType(C_NAType):
     >>> True | pd.NA
     True
     """
-    __module__ = "pandas"
+    __module__ = "pandas.api.typing"
 
     _instance = None
 
@@ -546,3 +546,4 @@ class NAType(C_NAType):
 
 C_NA = NAType()   # C-visible
 NA = C_NA         # Python-visible
+NA.__module__ = "pandas"
diff --git a/pandas/_libs/tslibs/nattype.pyx b/pandas/_libs/tslibs/nattype.pyx
@@ -372,7 +372,7 @@ class NaTType(_NaT):
     1         NaT
     """
 
-    __module__ = "pandas"
+    __module__ = "pandas.api.typing"
 
     def __new__(cls):
         cdef _NaT base
@@ -1871,6 +1871,7 @@ default 'raise'
 
 c_NaT = NaTType()  # C-visible
 NaT = c_NaT        # Python-visible
+NaT.__module__ = "pandas"
 
 
 # ----------------------------------------------------------------------

diff --git a/pandas/_libs/tslibs/np_datetime.pyx b/pandas/_libs/tslibs/np_datetime.pyx
@@ -192,6 +192,7 @@ class OutOfBoundsDatetime(ValueError):
     OutOfBoundsDatetime: Parsing "08335394550" to datetime overflows,
     at position 0
     """
+    __module__ = "pandas.errors"
     pass
 
 
@@ -212,6 +213,7 @@ class OutOfBoundsTimedelta(ValueError):
     OutOfBoundsTimedelta: Cannot cast 139999 days 00:00:00
     to unit='ns' without overflow.
     """
+    __module__ = "pandas.errors"
     # Timedelta analogue to OutOfBoundsDatetime
     pass
 

diff --git a/pandas/_libs/tslibs/offsets.pyx b/pandas/_libs/tslibs/offsets.pyx
@@ -1819,6 +1819,8 @@ class DateOffset(RelativeDeltaOffset, metaclass=OffsetMeta):
     >>> ts + pd.DateOffset(hour=8)
     Timestamp('2017-01-01 08:10:11')
     """
+    __module__ = "pandas"
+
     def __setattr__(self, name, value):
         raise AttributeError("DateOffset objects are immutable.")
 

diff --git a/pandas/_libs/tslibs/period.pyx b/pandas/_libs/tslibs/period.pyx
@@ -1631,6 +1631,7 @@ class IncompatibleFrequency(TypeError):
     Raised when trying to compare or operate between Periods with different
     frequencies.
     """
+    __module__ = "pandas.errors"
     pass
 
 

@@ -107,6 +107,8 @@
 
 
 class SequenceNotStr(Protocol[_T_co]):
+    __module__: str = "pandas.api.typing.aliases"
+
     @overload
     def __getitem__(self, index: SupportsIndex, /) -> _T_co: ...
 
@@ -278,12 +280,16 @@ def tell(self) -> int:
 
 
 class ReadBuffer(BaseBuffer, Protocol[AnyStr_co]):
+    __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__: str = "pandas.api.typing.aliases"
+
     def write(self, b: AnyStr_contra, /) -> Any:
         # for gzip.GzipFile, bz2.BZ2File
         ...
@@ -294,14 +300,20 @@ def flush(self) -> Any:
 
 
 class ReadPickleBuffer(ReadBuffer[bytes], Protocol):
+    __module__: str = "pandas.api.typing.aliases"
+
     def readline(self) -> bytes: ...
 
 
 class WriteExcelBuffer(WriteBuffer[bytes], Protocol):
+    __module__: str = "pandas.api.typing.aliases"
+
     def truncate(self, size: int | None = ..., /) -> int: ...
 
 
 class ReadCsvBuffer(ReadBuffer[AnyStr_co], Protocol):
+    __module__: str = "pandas.api.typing.aliases"
+
     def __iter__(self) -> Iterator[AnyStr_co]:
         # for engine=python
         ...

diff --git a/pandas/core/apply.py b/pandas/core/apply.py
@@ -88,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(

diff --git a/pandas/core/arrays/arrow/array.py b/pandas/core/arrays/arrow/array.py
@@ -296,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
 

diff --git a/pandas/core/arrays/base.py b/pandas/core/arrays/base.py
@@ -256,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"
@@ -1806,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.
@@ -2812,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):
         """

diff --git a/pandas/core/arrays/boolean.py b/pandas/core/arrays/boolean.py
@@ -304,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"}
 

diff --git a/pandas/core/arrays/categorical.py b/pandas/core/arrays/categorical.py
@@ -361,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

diff --git a/pandas/core/arrays/datetimes.py b/pandas/core/arrays/datetimes.py
@@ -223,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)

diff --git a/pandas/core/arrays/floating.py b/pandas/core/arrays/floating.py
@@ -129,6 +129,8 @@ class FloatingArray(NumericArray):
     Length: 3, dtype: Float32
     """
 
+    __module__ = "pandas.arrays"
+
     _dtype_cls = FloatingDtype
 
 

diff --git a/pandas/core/arrays/integer.py b/pandas/core/arrays/integer.py
@@ -142,6 +142,8 @@ class IntegerArray(NumericArray):
     Length: 3, dtype: UInt16
     """
 
+    __module__ = "pandas.arrays"
+
     _dtype_cls = IntegerDtype
 
 

diff --git a/pandas/core/arrays/interval.py b/pandas/core/arrays/interval.py
@@ -243,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
 

diff --git a/pandas/core/arrays/numpy_.py b/pandas/core/arrays/numpy_.py
@@ -57,6 +57,7 @@ class NumpyExtensionArray(
     NDArrayBackedExtensionArray,
     ObjectStringArrayMixin,
 ):
+    __module__ = "pandas.arrays"
     """
     A pandas ExtensionArray for NumPy data.
 

diff --git a/pandas/core/arrays/period.py b/pandas/core/arrays/period.py
@@ -177,6 +177,8 @@ class PeriodArray(dtl.DatelikeOps, libperiod.PeriodMixin):  # type: ignore[misc]
     Length: 2, dtype: period[D]
     """
 
+    __module__ = "pandas.arrays"
+
     # array priority higher than numpy scalars
     __array_priority__ = 1000
     _typ = "periodarray"  # ABCPeriodArray

diff --git a/pandas/core/arrays/sparse/array.py b/pandas/core/arrays/sparse/array.py
@@ -380,6 +380,8 @@ class SparseArray(OpsMixin, PandasObject, ExtensionArray):
     Indices: array([2, 3], dtype=int32)
     """
 
+    __module__ = "pandas.arrays"
+
     _subtyp = "sparse_array"  # register ABCSparseArray
     _hidden_attrs = PandasObject._hidden_attrs | frozenset([])
     _sparse_index: SparseIndex

diff --git a/pandas/core/arrays/string_.py b/pandas/core/arrays/string_.py
@@ -633,6 +633,8 @@ class StringArray(BaseStringArray, NumpyExtensionArray):  # type: ignore[misc]
     Length: 3, dtype: boolean
     """
 
+    __module__ = "pandas.arrays"
+
     # undo the NumpyExtensionArray hack
     _typ = "extension"
 

diff --git a/pandas/core/arrays/string_arrow.py b/pandas/core/arrays/string_arrow.py
@@ -125,6 +125,8 @@ class ArrowStringArray(ObjectStringArrayMixin, ArrowExtensionArray, BaseStringAr
     Length: 4, dtype: string
     """
 
+    __module__ = "pandas.arrays"
+
     # error: Incompatible types in assignment (expression has type "StringDtype",
     # base class "ArrowExtensionArray" defined the type as "ArrowDtype")
     _dtype: StringDtype  # type: ignore[assignment]
-Original file line number
+Diff line change
@@ Expand Up / @@ -1631,6 +1631,7 @@ class IncompatibleFrequency(TypeError): @@
         Raised when trying to compare or operate between Periods with different
         frequencies.
         """
+        __module__ = "pandas.errors"
         pass
@@ Expand Down @@