ENH: add calamine excel reader (see also pandas-dev#50581)

Author: dimastbk

ci/deps/actions-310.yaml

@@ -60,4 +60,5 @@ dependencies:
 
   - pip:
     - pyqt5>=5.15.6
+    - python-calamine>=0.1.4
     - tzdata>=2022.1

ci/deps/actions-311-downstream_compat.yaml

@@ -74,4 +74,5 @@ dependencies:
   - py
   - pip:
     - pyqt5>=5.15.6
+    - python-calamine>=0.1.4
     - tzdata>=2022.1

ci/deps/actions-311.yaml

@@ -60,4 +60,5 @@ dependencies:
 
   - pip:
     - pyqt5>=5.15.6
+    - python-calamine>=0.1.4
     - tzdata>=2022.1

ci/deps/actions-39-minimum_versions.yaml

@@ -62,4 +62,5 @@ dependencies:
 
   - pip:
     - pyqt5==5.15.6
+    - python-calamine=0.1.4
     - tzdata==2022.1

ci/deps/actions-39.yaml

@@ -60,4 +60,5 @@ dependencies:
 
   - pip:
     - pyqt5>=5.15.6
+    - python-calamine>=0.1.4
     - tzdata>=2022.1

ci/deps/circle-310-arm64.yaml

@@ -58,3 +58,6 @@ dependencies:
   - xlrd>=2.0.1
   - xlsxwriter>=3.0.3
   - zstandard>=0.17.0
+
+  - pip:
+    - python-calamine>=0.1.4

doc/source/getting_started/install.rst

@@ -337,6 +337,7 @@ xlrd                      2.0.1              excel           Reading Excel
 xlsxwriter                3.0.3              excel           Writing Excel
 openpyxl                  3.0.10             excel           Reading / writing for xlsx files
 pyxlsb                    1.0.9              excel           Reading for xlsb files
+python-calamine           0.1.4              excel           Reading for xls/xlsx/xlsb/ods files
 ========================= ================== =============== =============================================================
 
 HTML

doc/source/user_guide/io.rst

@@ -3436,7 +3436,9 @@ Excel files
 The :func:`~pandas.read_excel` method can read Excel 2007+ (``.xlsx``) files
 using the ``openpyxl`` Python module. Excel 2003 (``.xls``) files
 can be read using ``xlrd``. Binary Excel (``.xlsb``)
-files can be read using ``pyxlsb``.
+files can be read using ``pyxlsb``. Also, all this formats can be read using ``python-calamine``,
+but this library has some limitation and different behavior from other libraries,
+for example, can't detect chartsheets.
 The :meth:`~DataFrame.to_excel` instance method is used for
 saving a ``DataFrame`` to Excel.  Generally the semantics are
 similar to working with :ref:`csv<io.read_csv_table>` data.

doc/source/whatsnew/v2.1.0.rst

@@ -164,6 +164,7 @@ Other enhancements
 - Added :meth:`ExtensionArray.interpolate` used by :meth:`Series.interpolate` and :meth:`DataFrame.interpolate` (:issue:`53659`)
 - Added ``engine_kwargs`` parameter to :meth:`DataFrame.to_excel` (:issue:`53220`)
 - Added a new parameter ``by_row`` to :meth:`Series.apply` and :meth:`DataFrame.apply`. When set to ``False`` the supplied callables will always operate on the whole Series or DataFrame (:issue:`53400`, :issue:`53601`).
+- Added ``calamine`` as an engine to ``read_excel`` (:issue:`50395`)
 - Groupby aggregations (such as :meth:`DataFrameGroupby.sum`) now can preserve the dtype of the input instead of casting to ``float64`` (:issue:`44952`)
 - Improved error message when :meth:`DataFrameGroupBy.agg` failed (:issue:`52930`)
 - Many read/to_* functions, such as :meth:`DataFrame.to_pickle` and :func:`read_csv`, support forwarding compression arguments to lzma.LZMAFile (:issue:`52979`)

environment.yml

@@ -117,3 +117,4 @@ dependencies:
       - sphinx-toggleprompt  # conda-forge version has stricter pins on jinja2
       - typing_extensions; python_version<"3.11"
       - tzdata>=2022.1
+      - python-calamine