Extract INFO_DOCSTRING to fix doc decorator

Author: ivanovmg

pandas/core/frame.py

@@ -201,7 +201,10 @@
     console,
     format as fmt,
 )
-from pandas.io.formats.info import DataFrameInfo
+from pandas.io.formats.info import (
+    DataFrameInfo,
+    frame_sub_kwargs,
+)
 import pandas.plotting
 
 if TYPE_CHECKING:
@@ -3000,7 +3003,7 @@ def to_xml(
         return xml_formatter.write_output()
 
     # ----------------------------------------------------------------------
-    @doc(DataFrameInfo.render)
+    @doc(DataFrameInfo.render, **frame_sub_kwargs)
     def info(
         self,
         verbose: bool | None = None,

pandas/io/formats/info.py

@@ -53,6 +53,13 @@
 )
 
 
+show_counts_sub = dedent(
+    """\
+    show_counts : bool, optional
+        Whether to show the non-null counts."""
+)
+
+
 frame_examples_sub = dedent(
     """\
     >>> int_values = [1, 2, 3, 4, 5]
@@ -147,6 +154,69 @@
 )
 
 
+frame_sub_kwargs = dict(
+    klass="DataFrame",
+    type_sub=" and columns",
+    max_cols_sub=frame_max_cols_sub,
+    null_counts_sub=frame_null_counts_sub,
+    show_counts_sub=show_counts_sub,
+    examples_sub=frame_examples_sub,
+    see_also_sub=frame_see_also_sub,
+    version_added_sub="",
+)
+
+
+INFO_DOCSTRING = dedent(
+    """\
+    Print a concise summary of a {klass}.
+
+    This method prints information about a {klass} including
+    the index dtype{type_sub}, non-null values and memory usage.
+    {version_added_sub}\
+
+    Parameters
+    ----------
+    data : {klass}
+        {klass} to print information about.
+    verbose : bool, optional
+        Whether to print the full summary. By default, the setting in
+        ``pandas.options.display.max_info_columns`` is followed.
+    buf : writable buffer, defaults to sys.stdout
+        Where to send the output. By default, the output is printed to
+        sys.stdout. Pass a writable buffer if you need to further process
+        the output.
+    {max_cols_sub}
+    memory_usage : bool, str, optional
+        Specifies whether total memory usage of the {klass}
+        elements (including the index) should be displayed. By default,
+        this follows the ``pandas.options.display.memory_usage`` setting.
+
+        True always show memory usage. False never shows memory usage.
+        A value of 'deep' is equivalent to "True with deep introspection".
+        Memory usage is shown in human-readable units (base-2
+        representation). Without deep introspection a memory estimation is
+        made based in column dtype and number of rows assuming values
+        consume the same memory amount for corresponding dtypes. With deep
+        memory introspection, a real memory usage calculation is performed
+        at the cost of computational resources.
+    {show_counts_sub}s
+
+    Returns
+    -------
+    None
+        This method prints a summary of a {klass} and returns None.
+
+    See Also
+    --------
+    {see_also_sub}
+
+    Examples
+    --------
+    {examples_sub}
+    """
+)
+
+
 def _put_str(s: str | Dtype, space: int) -> str:
     """
     Make string of specified length, padding to the right if necessary.
@@ -293,53 +363,7 @@ def render(
         verbose: bool | None,
         show_counts: bool | None,
     ) -> None:
-        """
-        Print a concise summary of a {klass}.
-
-        This method prints information about a {klass} including
-        the index dtype{type_sub}, non-null values and memory usage.
-        {version_added_sub}\
-
-        Parameters
-        ----------
-        data : {klass}
-            {klass} to print information about.
-        verbose : bool, optional
-            Whether to print the full summary. By default, the setting in
-            ``pandas.options.display.max_info_columns`` is followed.
-        buf : writable buffer, defaults to sys.stdout
-            Where to send the output. By default, the output is printed to
-            sys.stdout. Pass a writable buffer if you need to further process
-            the output.
-        {max_cols_sub}
-        memory_usage : bool, str, optional
-            Specifies whether total memory usage of the {klass}
-            elements (including the index) should be displayed. By default,
-            this follows the ``pandas.options.display.memory_usage`` setting.
-
-            True always show memory usage. False never shows memory usage.
-            A value of 'deep' is equivalent to "True with deep introspection".
-            Memory usage is shown in human-readable units (base-2
-            representation). Without deep introspection a memory estimation is
-            made based in column dtype and number of rows assuming values
-            consume the same memory amount for corresponding dtypes. With deep
-            memory introspection, a real memory usage calculation is performed
-            at the cost of computational resources.
-        %(show_counts_sub)s
-
-        Returns
-        -------
-        None
-            This method prints a summary of a {klass} and returns None.
-
-        See Also
-        --------
-        {see_also_sub}
-
-        Examples
-        --------
-        {examples_sub}
-        """
+        pass
 
 
 class DataFrameInfo(BaseInfo):
@@ -402,11 +426,12 @@ def memory_usage_bytes(self) -> int:
         return self.data.memory_usage(index=True, deep=deep).sum()
 
     @doc(
-        BaseInfo.render,
+        INFO_DOCSTRING,
         klass="DataFrame",
         type_sub=" and columns",
         max_cols_sub=frame_max_cols_sub,
         null_counts_sub=frame_null_counts_sub,
+        show_counts_sub=show_counts_sub,
         examples_sub=frame_examples_sub,
         see_also_sub=frame_see_also_sub,
         version_added_sub="",