feat: If reset_dimensions is set, recalculate the worksheet's dimensions. Only reset dimensions if read_only is set.

Author: jpmckinney

CHANGELOG.rst

@@ -1,6 +1,8 @@
-Unreleased
-----------
+0.3.0 - October 30, 2023
+------------------------
 
+* If the ``reset_dimensions`` argument to :meth:`.Table.from_xlsx` is set, recalculate the worksheet's dimensions, instead of assuming that the table's width matches the first row's.
+* The ``reset_dimensions`` argument to :meth:`.Table.from_xlsx` is ignored if the ``read_only`` argument is false.
 * Add Python 3.8, 3.9, 3.10, 3.11, 3.12 support.
 * Drop support for 3.5 (2020-09-13), 3.6 (2021-12-23), 3.7 (2023-06-27).
 

agateexcel/table_xlsx.py

@@ -25,6 +25,9 @@ def from_xlsx(cls, path, sheet=None, skip_lines=0, header=True, read_only=True,
         The number of rows to skip from the top of the sheet.
     :param header:
         If :code:`True`, the first row is assumed to contain column names.
+    :param read_only:
+        If :code:`True`, the XLSX file is opened in read-only mode, to reduce
+        memory consumption.
     :param reset_dimensions:
         If :code:`True`, do not trust the dimensions in the file's properties,
         and recalculate them based on the data in the file.
@@ -69,8 +72,9 @@ def from_xlsx(cls, path, sheet=None, skip_lines=0, header=True, read_only=True,
         offset = 0
         rows = []
 
-        if reset_dimensions:
+        if read_only and reset_dimensions:
             sheet.reset_dimensions()
+            sheet.calculate_dimension(force=True)
 
         if header:
             sheet_header = sheet.iter_rows(min_row=1 + skip_lines, max_row=1 + skip_lines)

docs/conf.py

@@ -12,7 +12,7 @@
 
 project = 'agate-excel'
 copyright = '2017, Christopher Groskopf'
-version = '0.2.5'
+version = '0.3.0'
 release = version
 
 # -- General configuration ---------------------------------------------------

setup.py

@@ -5,7 +5,7 @@
 
 setup(
     name='agate-excel',
-    version='0.2.5',
+    version='0.3.0',
     description='agate-excel adds read support for Excel files (xls and xlsx) to agate.',
     long_description=long_description,
     long_description_content_type='text/x-rst',