Merge pull request #7565 from neirbowj/openpyxl2_issue7177

ENH: Implement _Openpyxl2Writer for pandas.io.excel

Author: jreback

doc/source/io.rst

@@ -2058,7 +2058,12 @@ files if `Xlsxwriter`_ is not available.
 .. _xlwt: http://www.python-excel.org
 
 To specify which writer you want to use, you can pass an engine keyword
-argument to ``to_excel`` and to ``ExcelWriter``.
+argument to ``to_excel`` and to ``ExcelWriter``. The built-in engines are:
+
+- `'openpyxl`': This includes stable support for OpenPyxl 1.6.1 up to but
+  not including 2.0.0, and experimental support for OpenPyxl 2.0.0 and later.
+- `'xlsxwriter'`
+- `'xlwt'`
 
 .. code-block:: python
 

doc/source/v0.15.0.txt

@@ -738,6 +738,12 @@ Enhancements
 
 
 
+- Added experimental compatibility with openpyxl v2. The ``DataFrame.to_excel``
+  method ``engine`` keyword now recognizes ``openpyxl1`` and ``openpyxl2``
+  which will explicitly require openpyxl v1 and v2 respectively, failing if
+  the requested version is not available. The ``openpyxl`` engine is a now a
+  meta-engine that automatically uses whichever version of openpyxl is
+  installed. (:issue:`7177`)
 
 
 

pandas/compat/openpyxl_compat.py

@@ -10,15 +10,26 @@
 stop_ver = '2.0.0'
 
 
-def is_compat():
-    """Detect whether the installed version of openpyxl is supported.
+def is_compat(major_ver=1):
+    """Detect whether the installed version of openpyxl is supported
 
+    Parameters
+    ----------
+    ver : int
+        1 requests compatibility status among the 1.x.y series
+        2 requests compatibility status of 2.0.0 and later
     Returns
     -------
     compat : bool
-        ``True`` if openpyxl is installed and is between versions 1.6.1 and
-        2.0.0, ``False`` otherwise.
+        ``True`` if openpyxl is installed and is a compatible version.
+        ``False`` otherwise.
     """
     import openpyxl
     ver = LooseVersion(openpyxl.__version__)
-    return LooseVersion(start_ver) <= ver < LooseVersion(stop_ver)
+    if major_ver == 1:
+        return LooseVersion(start_ver) <= ver < LooseVersion(stop_ver)
+    elif major_ver == 2:
+        return LooseVersion(stop_ver) <= ver
+    else:
+        raise ValueError('cannot test for openpyxl compatibility with ver {0}'
+                .format(major_ver))