Convert _get_grouper_for_level doc-strings on Index/MultiIndex to shared_doc (GH 14327)

Author: Jon M. Mease

pandas/indexes/base.py

@@ -432,26 +432,28 @@ def _update_inplace(self, result, **kwargs):
         # guard when called from IndexOpsMixin
         raise TypeError("Index can't be updated inplace")
 
-    def _get_grouper_for_level(self, mapper, level=None):
-        """
+    _index_shared_docs['_get_grouper_for_level'] = """
         Get index grouper corresponding to an index level
 
         Parameters
         ----------
         mapper: Group mapping function or None
             Function mapping index values to groups
-        level : int, default None
+        level : int or None
             Index level
 
         Returns
         -------
         grouper : Index
             Index of values to group on
-        labels : None
+        labels : ndarray of int or None
             Array of locations in level_index
-        level_index : None
+        uniques : Index or None
             Index of unique values for level
         """
+
+    @Appender(_index_shared_docs['_get_grouper_for_level'])
+    def _get_grouper_for_level(self, mapper, level=None):
         assert level is None or level == 0
         if mapper is None:
             grouper = self

pandas/indexes/multi.py

@@ -539,26 +539,8 @@ def _format_native_types(self, na_rep='nan', **kwargs):
 
         return mi.values
 
+    @Appender(_index_shared_docs['_get_grouper_for_level'])
     def _get_grouper_for_level(self, mapper, level):
-        """
-        Get index grouper corresponding to an index level
-
-        Parameters
-        ----------
-        mapper: Group mapping function or None
-            Function mapping index values to groups
-        level : int
-            Index level
-
-        Returns
-        -------
-        grouper : Index
-            Index of values to group on
-        labels : ndarray of int or None
-            Array of locations in level_index
-        uniques : Index or None
-            Index of unique values for level
-        """
         indexer = self.labels[level]
         level_index = self.levels[level]