Release Notes

---

0.2.0 (2025-07-28)

Added:

• read_table supports dtype="header"
• the dimensions method to ExcelReader
• the merged keyword argument to Spreadsheet.read
• ODSReader for reading OpenDocument Spreadsheet files
• GSheetsReader and ExcelReader can now be used as a context manager
• PEP-484 type annotations
• a TEXT member to the GCellType enum
• support for Python 3.12 and 3.13

Changed:

• implement the __init_subclass__ method to register Reader subclasses instead of using the @register decorator (PEP-487)
• move the static get_bytes, get_lines and get_extension methods from the Reader class to the utils module
• convert to an implicit namespace package (PEP-420)
• utils.git_head now returns a GitHead dataclass with the datetime key replaced with a timestamp attribute
• the names of the keyword arguments to utils.search

Fixed:

• specifying only the top-left cell to read_table returned the wrong cells from the spreadsheet

Removed:

• the workbook property to ExcelReader
• support for Python ≤ 3.8

0.1.0 (2023-06-16)

Initial release.