Documenting the enhancement for this GH issue

Author: rmhowe425

doc/source/user_guide/io.rst

@@ -3761,6 +3761,15 @@ one can pass an :class:`~pandas.io.excel.ExcelWriter`.
 
 .. _io.excel_writing_buffer:
 
+When using the ``engine_kwargs`` parameter, pandas will pass these arguments to the
+engine.For this, it is important to know which function pandas is using internally.
+
+* For the engine openpyxl, pandas is using :func:`openpyxl.Workbook` to create a new sheet and :func:`openpyxl.load_workbook` to append data to an existing sheet. The openpyxl engine writes to (``.xlsx``) and (``.xlsm``) files.
+
+* For the engine xlsxwriter, pandas is using :func:`xlsxwriter.Workbook` to write to (``.xlsx``) files.
+
+* For the engine odf, pandas is using :func:`odf.opendocument.OpenDocumentSpreadsheet` to write to (``.ods``) files.
+
 Writing Excel files to memory
 +++++++++++++++++++++++++++++
 

doc/source/whatsnew/v2.1.0.rst

@@ -87,6 +87,7 @@ Other enhancements
 - :meth:`DataFrame.applymap` now uses the :meth:`~api.extensions.ExtensionArray.map` method of underlying :class:`api.extensions.ExtensionArray` instances (:issue:`52219`)
 - :meth:`arrays.SparseArray.map` now supports ``na_action`` (:issue:`52096`).
 - Add dtype of categories to ``repr`` information of :class:`CategoricalDtype` (:issue:`52179`)
+- Adding ``engine_kwargs`` parameter to :meth:`DataFrame.to_excel` (:issue:`52368`)
 -
 
 .. ---------------------------------------------------------------------------

pandas/tests/io/excel/test_writers.py

@@ -1119,20 +1119,25 @@ def test_engine_kwargs(self, engine, path):
         df = DataFrame([{"A": 1, "B": 2}, {"A": 3, "B": 4}])
 
         msgs = {
-            "odf": r"OpenDocumentSpreadsheet() got an unexpected keyword argument 'foo'",
+            "odf": r"OpenDocumentSpreadsheet() got an unexpected keyword "
+            r"argument 'foo'",
             "openpyxl": r"load_workbook() got an unexpected keyword argument 'foo'",
-            "xlsxwriter": r"Workbook.__init__() got an unexpected keyword argument 'foo'",
+            "xlsxwriter": r"Workbook.__init__() got an unexpected keyword "
+            r"argument 'foo'",
         }
 
         # Handle change in error message for openpyxl (write and append mode)
         if engine == "openpyxl" and os.path.exists(path):
-            msgs["openpyxl"] = r"Workbook.__init__() got an unexpected keyword argument 'foo'"
+            msgs[
+                "openpyxl"
+            ] = r"Workbook.__init__() got an unexpected keyword argument 'foo'"
 
         else:
             with pytest.raises(TypeError, match=re.escape(msgs[engine])):
-                df.to_excel(path,
-                            engine_kwargs={"foo": "bar"},
-                            )
+                df.to_excel(
+                    path,
+                    engine_kwargs={"foo": "bar"},
+                )
 
     def test_write_lists_dict(self, path):
         # see gh-8188.