Resolve GL03 docstring validation errors

Author: jamescobonkerr

pandas/_libs/tslibs/timedeltas.pyx

@@ -1156,7 +1156,6 @@ class Timedelta(_Timedelta):
     Notes
     -----
     The ``.value`` attribute is always in ns.
-
     """
     def __new__(cls, object value=_no_input, unit=None, **kwargs):
         cdef _Timedelta td_base

pandas/core/arrays/datetimes.py

@@ -119,7 +119,7 @@ def f(self):
         return result
 
     f.__name__ = name
-    f.__doc__ = "\n{}\n".format(docstring)
+    f.__doc__ = docstring
     return property(f)
 
 

pandas/core/arrays/sparse.py

@@ -541,7 +541,6 @@ class SparseArray(PandasObject, ExtensionArray, ExtensionOpsMixin):
         3. ``data.dtype.fill_value`` if `fill_value` is None and `dtype`
            is not a ``SparseDtype`` and `data` is a ``SparseArray``.
 
-
     kind : {'integer', 'block'}, default 'integer'
         The type of storage for sparse locations.
 

pandas/core/base.py

@@ -870,7 +870,6 @@ def to_numpy(self, dtype=None, copy=False):
 
         .. versionadded:: 0.24.0
 
-
         Parameters
         ----------
         dtype : str or numpy.dtype, optional

pandas/core/config.py

@@ -650,8 +650,8 @@ def _build_option_description(k):
         s += (u(', use `{rkey}` instead.')
               .format(rkey=d.rkey if d.rkey else ''))
         s += u(')')
+        s += '\n'
 
-    s += '\n\n'
     return s
 
 

pandas/core/frame.py

@@ -2184,7 +2184,6 @@ def to_html(self, buf=None, columns=None, col_space=None, header=True,
             Convert URLs to HTML links.
 
             .. versionadded:: 0.24.0
-
         %(returns)s
         See Also
         --------
@@ -6003,7 +6002,6 @@ def unstack(self, level=-1, fill_value=None):
     columns, considered measured variables (`value_vars`), are "unpivoted" to
     the row axis, leaving just two non-identifier columns, 'variable' and
     'value'.
-
     %(versionadded)s
     Parameters
     ----------

pandas/core/generic.py

@@ -948,7 +948,6 @@ def swaplevel(self, i=-2, j=-1, axis=0):
 
            The indexes ``i`` and ``j`` are now optional, and default to
            the two innermost levels of the index.
-
         """
         axis = self._get_axis_number(axis)
         result = self.copy()
@@ -4929,9 +4928,7 @@ def pipe(self, func, *args, **kwargs):
 
     _shared_docs['aggregate'] = dedent("""
     Aggregate using one or more operations over the specified axis.
-
     %(versionadded)s
-
     Parameters
     ----------
     func : function, str, list or dict
@@ -4961,16 +4958,13 @@ def pipe(self, func, *args, **kwargs):
         * DataFrame : when DataFrame.agg is called with several functions
 
         Return scalar, Series or DataFrame.
-
     %(see_also)s
-
     Notes
     -----
     `agg` is an alias for `aggregate`. Use the alias.
 
     A passed user-defined-function will be passed a Series for evaluation.
-
-    %(examples)s
+    %(examples)s\
     """)
 
     _shared_docs['transform'] = ("""
@@ -10285,7 +10279,7 @@ def _doc_parms(cls):
 
 Returns
 -------
-%(name1)s or %(name2)s (if level specified)
+%(name1)s or %(name2)s (if level specified)\
 %(see_also)s
 %(examples)s\
 """
@@ -10442,7 +10436,7 @@ def _doc_parms(cls):
 %(name2)s.cumsum : Return cumulative sum over %(name2)s axis.
 %(name2)s.cumprod : Return cumulative product over %(name2)s axis.
 
-%(examples)s
+%(examples)s\
 """
 
 _cummin_examples = """\

pandas/core/groupby/base.py

@@ -139,7 +139,7 @@ def %(name)s(self) :
         # ugly, but we need the name string itself in the method.
         f = getattr(klass, name)
         doc = f.__doc__
-        doc = doc if type(doc) == str else ''
+        doc = doc.strip() if type(doc) == str else ''
         if isinstance(f, types.MethodType):
             wrapper_template = method_wrapper_template
             decl, args = make_signature(f)

pandas/core/groupby/groupby.py

@@ -44,12 +44,12 @@ class providing the base-class of operations.
 from pandas.core.series import Series
 from pandas.core.sorting import get_group_index_sorter
 
-_common_see_also = """
+_common_see_also = """\
         See Also
         --------
         Series.%(name)s
         DataFrame.%(name)s
-        Panel.%(name)s
+        Panel.%(name)s\
 """
 
 _apply_docs = dict(
@@ -221,7 +221,7 @@ class providing the base-class of operations.
 
 Examples
 --------
-%(examples)s
+%(examples)s\
 """
 
 _transform_template = """

pandas/core/indexes/base.py

@@ -3104,7 +3104,6 @@ def reindex(self, target, method=None, level=None, limit=None,
             Resulting index.
         indexer : np.ndarray or None
             Indices of output values in original index.
-
         """
         # GH6552: preserve names when reindexing to non-named target
         # (i.e. neither Index nor Series).

pandas/io/feather_format.py

@@ -110,7 +110,6 @@ def read_feather(path, columns=None, use_threads=True):
     Returns
     -------
     type of object stored in file
-
     """
 
     feather, pyarrow = _try_import()

pandas/plotting/_misc.py

@@ -303,7 +303,6 @@ def andrews_curves(frame, class_column, ax=None, samples=200, color=None,
     Returns
     -------
     class:`matplotlip.axis.Axes`
-
     """
     from math import sqrt, pi
     import matplotlib.pyplot as plt