TYP: Signature of "rename" incompatible with supertype "NDFrame"

pandas/core/frame.py

@@ -4957,10 +4957,6 @@ def drop(
             errors=errors,
         )
 
-    @rewrite_axis_style_signature(
-        "mapper",
-        [("copy", True), ("inplace", False), ("level", None), ("errors", "ignore")],
-    )
     def rename(
         self,
         mapper: Renamer | None = None,

pandas/core/groupby/groupby.py

@@ -2011,7 +2011,8 @@ def size(self) -> DataFrame | Series:
             result = self._obj_1d_constructor(result)
 
         if not self.as_index:
-            result = result.rename("size").reset_index()
+            # Item "None" of "Optional[Series]" has no attribute "reset_index"
+            result = result.rename("size").reset_index()  # type: ignore[union-attr]
 
         return self._reindex_output(result, fill_value=0)
 

pandas/core/series.py

@@ -4458,14 +4458,16 @@ def align(
 
     def rename(
         self,
-        index=None,
+        mapper=None,
         *,
+        index=None,
+        columns=None,
         axis=None,
         copy=True,
         inplace=False,
         level=None,
         errors="ignore",
-    ):
+    ) -> Series | None:
         """
         Alter Series index labels or name.
 
@@ -4481,7 +4483,7 @@ def rename(
         ----------
         axis : {0 or "index"}
             Unused. Accepted for compatibility with DataFrame method only.
-        index : scalar, hashable sequence, dict-like or function, optional
+        mapper : scalar, hashable sequence, dict-like or function, optional
             Functions or dict-like are transformations to apply to
             the index.
             Scalar or hashable sequence-like will alter the ``Series.name``
@@ -4525,12 +4527,16 @@ def rename(
         5    3
         dtype: int64
         """
-        if callable(index) or is_dict_like(index):
+        if index is not None and mapper is not None:
+            raise TypeError("Cannot specify both 'mapper' and 'index'")
+        if mapper is None:
+            mapper = index
+        if callable(mapper) or is_dict_like(mapper):
             return super().rename(
-                index, copy=copy, inplace=inplace, level=level, errors=errors
+                mapper, copy=copy, inplace=inplace, level=level, errors=errors
             )
         else:
-            return self._set_name(index, inplace=inplace)
+            return self._set_name(mapper, inplace=inplace)
 
     @overload
     def set_axis(

pandas/io/json/_normalize.py

@@ -515,7 +515,11 @@ def _recursive_extract(data, path, seen_meta, level=0):
     result = DataFrame(records)
 
     if record_prefix is not None:
-        result = result.rename(columns=lambda x: f"{record_prefix}{x}")
+        # Incompatible types in assignment (expression has type "Optional[DataFrame]",
+        # variable has type "DataFrame")
+        result = result.rename(  # type: ignore[assignment]
+            columns=lambda x: f"{record_prefix}{x}"
+        )
 
     # Data types, a problem
     for k, v in meta_vals.items():

pandas/tests/series/methods/test_rename.py

@@ -1,6 +1,7 @@
 from datetime import datetime
 
 import numpy as np
+import pytest
 
 from pandas import (
     Index,
@@ -103,6 +104,19 @@ def test_rename_callable(self):
 
         assert result.name == expected.name
 
+    def test_rename_method_and_index(self):
+        # GH 40977
+        ser = Series([1, 2])
+        with pytest.raises(TypeError, match="Cannot specify both 'mapper' and 'index'"):
+            ser.rename(str, index=str)
+
+    def test_rename_none(self):
+        # GH 40977
+        ser = Series([1, 2], name="foo")
+        result = ser.rename(None)
+        expected = Series([1, 2])
+        tm.assert_series_equal(result, expected)
+
     def test_rename_series_with_multiindex(self):
         # issue #43659
         arrays = [