refactor _create_delegator_method to use functools wrap

Author: saldanhad

pandas/core/accessor.py

@@ -116,12 +116,14 @@ def _setter(self, new_values):
                 doc=getattr(delegate, accessor_mapping(name)).__doc__,
             )
 
+        from functools import wraps
+
         def _create_delegator_method(name: str):
-            def f(self, *args, **kwargs):
-                return self._delegate_method(name, *args, **kwargs)
+            original_method = getattr(delegate, accessor_mapping(name))
 
-            f.__name__ = name
-            f.__doc__ = getattr(delegate, accessor_mapping(name)).__doc__
+            @wraps(original_method)
+            def f(self):
+                return self._delegate_method(name)
 
             return f
 

pandas/core/arrays/categorical.py

@@ -1155,6 +1155,12 @@ def rename_categories(self, new_categories) -> Self:
         """
         Rename categories.
 
+        This method is commonly used to re-label or adjust the
+        category names in categorical data without changing the
+        underlying data. It is useful in situations where you want
+        to modify the labels used for clarity, consistency,
+        or readability.
+
         Parameters
         ----------
         new_categories : list-like, dict-like or callable
@@ -1371,8 +1377,8 @@ def remove_categories(self, removals) -> Self:
         """
         Remove the specified categories.
 
-        `removals` must be included in the old categories. Values which were in
-        the removed categories will be set to NaN
+        ``removals`` must be included in the old categories,
+        values which were in the removed categories will be set to NaN
 
         Parameters
         ----------
@@ -1431,6 +1437,10 @@ def remove_unused_categories(self) -> Self:
         """
         Remove categories which are not used.
 
+        This method is useful when working with datasets
+        that undergo dynamic changes where categories may no longer be
+        relevant, allowing to maintain a clean, efficient data structure.
+
         Returns
         -------
         Categorical