FIX: Fix docstring formatting, missing imports, and undefined variables

- Escape curly braces in to_excel docstring example to prevent KeyError
- Add missing pandas import in test_xlsxwriter.py for MultiIndex usage
- Add missing ExcelFormatter import in generic.py
- Move ExcelWriter import out of TYPE_CHECKING block (used at runtime)
- Remove undefined variables from ExcelWriter call
- Fix line length in docstring

Author: antznette1

pandas/core/generic.py

@@ -182,15 +182,17 @@
     Window,
 )
 
+# Import ExcelFormatter at runtime since it's used in to_excel method
+from pandas.io.formats.excel import ExcelFormatter
 from pandas.io.formats.format import (
     DataFrameFormatter,
     DataFrameRenderer,
 )
 from pandas.io.formats.printing import pprint_thing
 
 if TYPE_CHECKING:
-    from collections.abc import Callable
     from collections.abc import (
+        Callable,
         Hashable,
         Iterator,
         Mapping,
@@ -202,15 +204,17 @@
 
     from pandas import (
         DataFrame,
-        ExcelWriter,
         HDFStore,
         Series,
     )
     from pandas.core.indexers.objects import BaseIndexer
     from pandas.core.resample import Resampler
 
+# Import ExcelWriter at runtime since it's used in to_excel method
 import textwrap
 
+from pandas import ExcelWriter
+
 # goal is to be able to define the docs close to function, while still being
 # able to share
 _shared_docs = {**_shared_docs}
@@ -773,6 +777,7 @@ def _set_axis(self, axis: AxisInt, labels: AnyArrayLike | list) -> None:
         """
         labels = ensure_index(labels)
         self._mgr.set_axis(axis, labels)
+
     @final
     @doc(klass=_shared_doc_kwargs["klass"])
     def droplevel(self, level: IndexLabel, axis: Axis = 0) -> Self:
@@ -1514,6 +1519,7 @@ def __bool__(self) -> NoReturn:
             f"The truth value of a {type(self).__name__} is ambiguous. "
             "Use a.empty, a.bool(), a.item(), a.any() or a.all()."
         )
+
     @final
     def abs(self) -> Self:
         """
@@ -2265,7 +2271,7 @@ def to_excel(
 
         Examples
         --------
-        >>> df = pd.DataFrame({"A": [1, 2, 3], "B": [4, 5, 6]})
+        >>> df = pd.DataFrame({{"A": [1, 2, 3], "B": [4, 5, 6]}})
         >>> df.to_excel("pandas_simple.xlsx")
         >>> df.to_excel("pandas_simple.xlsx", engine="openpyxl")
         """
@@ -2279,11 +2285,7 @@ def to_excel(
             excel_writer = ExcelWriter(
                 excel_writer,
                 engine=engine,
-                mode=mode,
-                if_sheet_exists=if_sheet_exists,
                 engine_kwargs=engine_kwargs,
-                date_format=date_format,
-                datetime_format=datetime_format,
                 storage_options=storage_options,
             )
 
@@ -5624,6 +5626,7 @@ def f(x) -> bool:
             return self.loc(axis=axis)[values]
         else:
             raise TypeError("Must pass either `items`, `like`, or `regex`")
+
     @final
     def head(self, n: int = 5) -> Self:
         """
@@ -6101,7 +6104,8 @@ def __finalize__(self, other, method: str | None = None, **kwargs) -> Self:
         ----------
         other : the object from which to get the attributes that we are going
             to propagate. If ``other`` has an ``input_objs`` attribute, then
-            this attribute must contain an iterable of objects, each with an ``attrs`` attribute.
+            this attribute must contain an iterable of objects, each with an
+            ``attrs`` attribute.
         method : str, optional
             A passed method name providing context on where ``__finalize__``
             was called.
@@ -9706,6 +9710,7 @@ def align(
         left = left.__finalize__(self)
         right = right.__finalize__(other)
         return left, right
+
     @final
     def _align_frame(
         self,
@@ -12824,6 +12829,8 @@ def last_valid_index(self) -> Hashable:
     The required number of valid values to perform the operation. If fewer than
     ``min_count`` non-NA values are present the result will be NA.
 """
+
+
 def make_doc(name: str, ndim: int) -> str:
     """
     Generate the docstring for a Series/DataFrame reduction.
@@ -13190,4 +13197,4 @@ def make_doc(name: str, ndim: int) -> str:
         examples=examples,
         **kwargs,
     )
-    return docstr
+    return docstr

pandas/tests/io/excel/test_xlsxwriter.py

@@ -3,6 +3,7 @@
 
 import pytest
 
+import pandas as pd
 from pandas import DataFrame
 
 from pandas.io.excel import ExcelWriter
@@ -179,4 +180,4 @@ def test_to_excel_autofilter_multiindex_no_merge_xlsxwriter(tmp_excel):
         assert ws.auto_filter is not None
         assert ws.auto_filter.ref is not None
     finally:
-        wb.close()
+        wb.close()