numbers-parser 4.17.0.post1__py3-none-any.whl → 4.18.0__py3-none-any.whl

numbers_parser/model.py

@@ -807,38 +807,6 @@ class _NumbersModel(Cacheable):
         # Table can be empty if the document does not use FormulaOwnerDependenciesArchive
         return self._table_id_to_base_id.get(table_id)
 
-    def get_formula_owner(self, table_id: int) -> object:
-        table_uuid = self.table_base_id(table_id)
-        return self.objects[self._table_base_id_to_formula_owner_id[table_uuid]]
-
-    def add_formula_dependency(self, row: int, col: int, table_id: int) -> None:
-        calc_engine = self.calc_engine()
-        calc_engine.dependency_tracker.number_of_formulas += 1
-        internal_formula_id = calc_engine.dependency_tracker.number_of_formulas
-
-        formula_owner = self.get_formula_owner(table_id)
-        formula_owner.cell_dependencies.cell_record.append(
-            TSCEArchives.CellRecordExpandedArchive(column=col, row=row),
-        )
-        if len(formula_owner.tiled_cell_dependencies.cell_record_tiles) == 0:
-            cell_record_id, cell_record = self.objects.create_object_from_dict(
-                "CalculationEngine",
-                {
-                    "internal_owner_id": internal_formula_id,
-                    "tile_column_begin": 0,
-                    "tile_row_begin": 0,
-                },
-                TSCEArchives.CellRecordTileArchive,
-            )
-            formula_owner.tiled_cell_dependencies.cell_record_tiles.append(
-                TSPMessages.Reference(identifier=cell_record_id),
-            )
-        else:
-            cell_record_id = formula_owner.tiled_cell_dependencies.cell_record_tiles[0].identifier
-            cell_record = self.objects[cell_record_id]
-
-        cell_record.cell_records.append(formula_owner.cell_dependencies.cell_record[-1])
-
     @cache(num_args=0)
     def calc_engine_id(self):
         """Return the CalculationEngine ID for the current document."""
@@ -867,7 +835,7 @@ class _NumbersModel(Cacheable):
         self._merge_cells[table_id].add_anchor(row_start, col_start, size)
 
     @cache()
-    def calculate_new_merge_cell_ranges(self, table_id) -> None:
+    def calculate_merges_using_formula_stores(self, table_id) -> None:
         table_model = self.objects[table_id]
         formulas = table_model.merge_owner.formula_store.formulas
         if len(formulas) == 0:
@@ -887,7 +855,7 @@ class _NumbersModel(Cacheable):
             )
 
     @cache()
-    def calculate_merge_cell_ranges(self, table_id) -> None:
+    def calculate_merges_using_dependency_archives(self, table_id) -> None:
         """Extract all the merge cell ranges for the Table."""
         # See details in Numbers.md#merge-ranges.
         owner_id_map = self.owner_id_map()
@@ -910,6 +878,8 @@ class _NumbersModel(Cacheable):
                         record_range.bottom_right_column,
                     )
 
+    @cache()
+    def calculate_merges_using_region_map(self, table_id) -> None:
         base_data_store = self.objects[table_id].base_data_store
         if base_data_store.merge_region_map.identifier == 0:
             return
@@ -926,18 +896,12 @@ class _NumbersModel(Cacheable):
             )
             row_end = row_start + num_rows - 1
             col_end = col_start + num_columns - 1
-            for row in range(row_start, row_end + 1):
-                for col in range(col_start, col_end + 1):
-                    self._merge_cells[table_id].add_reference(
-                        row,
-                        col,
-                        (row_start, col_start, row_end, col_end),
-                    )
-            self._merge_cells[table_id].add_anchor(row_start, col_start, (num_rows, num_columns))
+            self.add_merge_range(table_id, row_start, row_end, col_start, col_end)
 
     def merge_cells(self, table_id):
-        self.calculate_new_merge_cell_ranges(table_id)
-        self.calculate_merge_cell_ranges(table_id)
+        self.calculate_merges_using_formula_stores(table_id)
+        self.calculate_merges_using_dependency_archives(table_id)
+        self.calculate_merges_using_region_map(table_id)
         return self._merge_cells[table_id]
 
     def table_id_to_sheet_id(self, table_id: int) -> int:
@@ -946,25 +910,14 @@ class _NumbersModel(Cacheable):
                 return sheet_id
         return None
 
-    def table_name_to_uuid(self, sheet_name: str, table_name: str) -> str:
-        table_ids = [tid for tid in self.table_ids() if table_name == self.table_name(tid)]
-        if len(table_ids) == 1:
-            return self.table_base_id(table_ids[0])
-
-        sheet_name_to_id = {self.sheet_name(x): x for x in self.sheet_ids()}
-        sheet_id = sheet_name_to_id[sheet_name]
-        table_name_to_id = {self.table_name(x): x for x in self.table_ids(sheet_id)}
-        table_id = table_name_to_id[table_name]
-        return self.table_base_id(table_id)
-
     @cache()
     def table_uuids_to_id(self, table_uuid) -> int | None:
-        for sheet_id in self.sheet_ids():  # pragma: no branch
+        for sheet_id in self.sheet_ids():  # pragma: no branch  # noqa: RET503
             for table_id in self.table_ids(sheet_id):
                 if table_uuid == self.table_base_id(table_id):
                     return table_id
 
-    def node_to_ref(self, table_id: int, row: int, col: int, node, merge_mode: bool = False):
+    def node_to_ref(self, table_id: int, row: int, col: int, node):
         def resolve_range(is_absolute, absolute_list, relative_list, offset, max_val):
             if is_absolute:
                 return absolute_list[0].range_begin
@@ -1030,7 +983,6 @@ class _NumbersModel(Cacheable):
                 col_end_is_abs=node.AST_sticky_bits.end_column_is_absolute,
                 from_table_id=table_id,
                 to_table_id=to_table_id,
-                _do_init=not merge_mode,
             )
 
         row = node.AST_row.row if node.AST_row.absolute else row + node.AST_row.row
@@ -1510,7 +1462,7 @@ class _NumbersModel(Cacheable):
             },
             TSTArchives.TableModelArchive,
         )
-        # Supresses Numbers assertions for tables sharing the same data
+        # Suppress Numbers assertions for tables sharing the same data
         table_model.category_owner.identifier = 0
 
         column_headers_id, column_headers = self.objects.create_object_from_dict(
@@ -1719,7 +1671,7 @@ class _NumbersModel(Cacheable):
             "bottom_right_column": 0x7FFF,
             "bottom_right_row": 0x7FFFFFFF,
         }
-        spanning_depdendencies = {
+        spanning_dependencies = {
             "total_range_for_table": null_range_ref,
             "body_range_for_table": null_range_ref,
         }
@@ -1732,8 +1684,8 @@ class _NumbersModel(Cacheable):
                 "cell_dependencies": {},
                 "range_dependencies": {},
                 "volatile_dependencies": volatile_dependencies,
-                "spanning_column_dependencies": spanning_depdendencies,
-                "spanning_row_dependencies": spanning_depdendencies,
+                "spanning_column_dependencies": spanning_dependencies,
+                "spanning_row_dependencies": spanning_dependencies,
                 "whole_owner_dependencies": {"dependent_cells": {}},
                 "cell_errors": {},
                 "base_owner_uid": base_owner_uuid.dict2,
@@ -1809,7 +1761,7 @@ class _NumbersModel(Cacheable):
             for k, v in presets_map.items()
         }
         for style in styles.values():
-            # Override __setattr__ behaviour for builtin styles
+            # Override __setattr__ behavior for builtin styles
             style.__dict__["_update_text_style"] = False
             style.__dict__["_update_cell_style"] = False
         return styles
@@ -2142,7 +2094,7 @@ class _NumbersModel(Cacheable):
         # a string with a new bullet character
         bds = self.objects[table_id].base_data_store
         rich_text_table = self.objects[bds.rich_text_table.identifier]
-        for entry in rich_text_table.entries:  # pragma: no branch
+        for entry in rich_text_table.entries:  # pragma: no branch  # noqa: RET503
             if string_key == entry.key:
                 payload = self.objects[entry.rich_text_payload.identifier]
                 payload_storage = self.objects[payload.storage.identifier]
@@ -2596,6 +2548,59 @@ class _NumbersModel(Cacheable):
         # datas never appears to be an empty list (default themes include images)
         return max(image_ids) + 1
 
+    @classmethod
+    def cell_value_to_key(
+        cls,
+        cell_value: TSCEArchives.CellValueArchive,
+    ) -> str | int | bool | datetime:
+        """Convert a CellValueArchive to a key."""
+        cell_value_type = cell_value.cell_value_type
+        if cell_value_type == CellValueType.STRING_TYPE:
+            return cell_value.string_value.value
+        if cell_value_type == CellValueType.NUMBER_TYPE:
+            return cell_value.number_value.value
+        if cell_value_type == CellValueType.BOOLEAN_TYPE:
+            return cell_value.boolean_value.value
+        # Must be DATE_TYPE
+        return cell_value.date_value.value
+
+    @cache(num_args=0)
+    def group_uuid_values(self):
+        return {
+            NumbersUUID(self.objects[_id].group_uid): _NumbersModel.cell_value_to_key(
+                self.objects[_id].group_cell_value,
+            )
+            for _id in self.find_refs("GroupNodeArchive")
+        }
+
+    @cache()
+    def table_category_row_map(self, table_id: int) -> dict[int, int] | None:
+        category_owner_id = self.objects[table_id].category_owner.identifier
+        if not category_owner_id:
+            return None
+        category_archive_id = self.objects[category_owner_id].group_by[0].identifier
+        category_archive = self.objects[category_archive_id]
+        if not category_archive.is_enabled:
+            return None
+
+        table_info = self.objects[self.table_info_id(table_id)]
+        category_order = self.objects[table_info.category_order.identifier]
+        row_uid_map = self.objects[category_order.uid_map.identifier]
+
+        group_uuids = self.group_uuid_values()
+        row_uuid_to_offset = {
+            NumbersUUID(uuid): row for row, uuid in enumerate(category_archive.row_uid_lookup.uuids)
+        }
+        row_uid_for_index = [
+            NumbersUUID(row_uid_map.sorted_row_uids[i]) for i in row_uid_map.row_uid_for_index
+        ]
+        return {
+            row: row_uuid_to_offset[uuid]
+            for row, uuid in enumerate(
+                uuid for uuid in row_uid_for_index if uuid not in group_uuids
+            )
+        }
+
     def table_category_data(self, table_id: int) -> dict | None:
         category_owner_id = self.objects[table_id].category_owner.identifier
         category_archive_id = self.objects[category_owner_id].group_by[0].identifier
@@ -2606,8 +2611,9 @@ class _NumbersModel(Cacheable):
         table_info = self.objects[self.table_info_id(table_id)]
         category_order = self.objects[table_info.category_order.identifier]
         row_uid_map = self.objects[category_order.uid_map.identifier]
+
         sorted_row_uuids = [
-            NumbersUUID(row_uid_map.sorted_row_uids[i]).hex for i in row_uid_map.row_uid_for_index
+            NumbersUUID(row_uid_map.sorted_row_uids[i]).hex for i in row_uid_map.row_index_for_uid
         ]
 
         data = self._table_data[table_id]
@@ -2623,22 +2629,8 @@ class _NumbersModel(Cacheable):
                     offsets += list(range(entry.range_begin, entry.range_begin + 1))
             return offsets
 
-        def cell_value_to_key(
-            cell_value: TSCEArchives.CellValueArchive,
-        ) -> str | int | bool | datetime:
-            """Convert a CellValueArchive to a key."""
-            cell_value_type = cell_value.cell_value_type
-            if cell_value_type == CellValueType.STRING_TYPE:
-                return cell_value.string_value.value
-            if cell_value_type == CellValueType.NUMBER_TYPE:
-                return cell_value.number_value.value
-            if cell_value_type == CellValueType.BOOLEAN_TYPE:
-                return cell_value.boolean_value.value
-            # Must be DATE_TYPE
-            return cell_value.date_value.value
-
         group_node_to_key = {
-            NumbersUUID(self.objects[_id].group_uid).hex: cell_value_to_key(
+            NumbersUUID(self.objects[_id].group_uid).hex: _NumbersModel.cell_value_to_key(
                 self.objects[_id].group_cell_value,
             )
             for _id in self.find_refs("GroupNodeArchive")
@@ -2660,7 +2652,7 @@ class _NumbersModel(Cacheable):
             for child in children:
                 group_uuid = NumbersUUID(child.group_uid).hex
                 if len(child.child) == 0:
-                    key = cell_value_to_key(child.group_cell_value)
+                    key = _NumbersModel.cell_value_to_key(child.group_cell_value)
 
                     row_offsets = index_set_to_offsets(child.row_lookup_uids)
                     categories[group_uuid] = {

numbers_parser/xrefs.py

@@ -67,8 +67,6 @@ class CellRange:
     _table_names: list[str] = field(init=False, default=None, repr=False)
 
     def __post_init__(self):
-        if not self._do_init:
-            return
         if self._table_names is None:
             self._initialize_table_data()
         self.model.name_ref_cache.refresh()

{numbers_parser-4.17.0.post1.dist-info → numbers_parser-4.18.0.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: numbers-parser
-Version: 4.17.0.post1
+Version: 4.18.0
 Summary: Read and write Apple Numbers spreadsheets
 Author-email: Jon Connell <python@figsandfudge.com>
 License-Expression: MIT
@@ -26,20 +26,15 @@ Dynamic: license-file
 
 [![Test Status](https://github.com/masaccio/numbers-parser/actions/workflows/run-all-tests.yml/badge.svg)](https://github.com/masaccio/numbers-parser/actions/workflows/run-all-tests.yml)[![Security Checks](https://github.com/masaccio/numbers-parser/actions/workflows/codeql.yml/badge.svg)](https://github.com/masaccio/numbers-parser/actions/workflows/codeql.yml)[![Code Coverage](https://codecov.io/gh/masaccio/numbers-parser/branch/main/graph/badge.svg?token=EKIUFGT05E)](https://codecov.io/gh/masaccio/numbers-parser)[![PyPI Version](https://badge.fury.io/py/numbers-parser.svg)](https://badge.fury.io/py/numbers-parser)
 
-`numbers-parser` is a Python module for parsing [Apple Numbers](https://www.apple.com/numbers/)`.numbers` files. It supports Numbers files
-generated by Numbers version 10.3, and up with the latest tested version being 14.1
-(current as of June 2024).
+`numbers-parser` is a Python module for reading and editing [Apple Numbers](https://www.apple.com/numbers/)`.numbers` files. It supports Numbers files generated by Numbers versions 3.x and later. It is tested against Numbers documents from 10.0 through to 14.4 (the last version of Numbers) and Numbers Creator Studio up to version 15.1, which the most current as of February 2026.
 
-It supports and is tested against Python versions from 3.10 onwards. It is not compatible
-with earlier versions of Python.
+It supports and is tested against Python versions from 3.10 onwards. It is not compatible with earlier versions of Python.
 
 ## Installation
 
 A pre-requisite for this package is [python-snappy](https://pypi.org/project/python-snappy/) which will be installed by Python automatically, but python-snappy also requires binary libraries for snappy compression.
 
-The most straightforward way to install the binary dependencies is to use
-[Homebrew](https://brew.sh) and source Python from Homebrew rather than from macOS as described
-in the [python-snappy github](https://github.com/andrix/python-snappy). Using [pipx](https://pipx.pypa.io/stable/installation/) for package management is also strongly recommended:
+The most straightforward way to install the binary dependencies is to use [Homebrew](https://brew.sh) and source Python from Homebrew rather than from macOS as described in the [python-snappy github](https://github.com/andrix/python-snappy). Using [pipx](https://pipx.pypa.io/stable/installation/) for package management is also strongly recommended:
 
 ```bash
 brew install snappy python3 pipx
@@ -52,9 +47,7 @@ For Linux (your package manager may be different):
 sudo apt-get -y install libsnappy-dev
 ```
 
-On Windows, you will need to either arrange for snappy to be found for VSC++ or you can install python
-[pre-compiled binary libraries](https://github.com/cgohlke/win_arm64-wheels/) which are only available
-for Windows on Arm. There appear to be no x86 pre-compiled packages for Windows.
+On Windows, you will need to either arrange for snappy to be found for VSC++ or you can install python [pre-compiled binary libraries](https://github.com/cgohlke/win_arm64-wheels/) which are only available for Windows on Arm. There appear to be no x86 pre-compiled packages for Windows.
 
 ```text
 pip install python_snappy-0.6.1-cp312-cp312-win_arm64.whl
@@ -118,12 +111,7 @@ python datatype. Available cell types are:
 | ErrorCell    | `None`               |                                                                                                        |
 | MergedCell   | `None`               | See [Merged cells](https://masaccio.github.io/numbers-parser/api/cells.html#numbers_parser.MergedCell) |
 
-Cell references can be either zero-offset row/column integers or an
-Excel/Numbers A1 notation. Where cell values are not `None` the
-property `formatted_value` returns the cell value as a `str` as
-displayed in Numbers. Cells that have no values in a table are
-represented as `EmptyCell` and cells containing evaluation errors of
-any kind `ErrorCell`.
+Cell references can be either zero-offset row/column integers or an Excel/Numbers A1 notation. Where cell values are not `None` the property `formatted_value` returns the cell value as a `str` as displayed in Numbers. Cells that have no values in a table are represented as `EmptyCell` and cells containing evaluation errors of any kind `ErrorCell`.
 
 ```python
 >>> table.cell(1,0)
@@ -140,10 +128,7 @@ any kind `ErrorCell`.
 
 ### Pandas Support
 
-Since the return value of `rows()` is a list of lists, you can pass
-this directly to pandas. Assuming you have a Numbers table with a single
-header which contains the names of the pandas series you want to create
-you can construct a pandas dataframe using:
+Since the return value of `rows()` is a list of lists, you can pass this directly to pandas. Assuming you have a Numbers table with a single header which contains the names of the pandas series you want to create you can construct a pandas dataframe using:
 
 ```python
 import pandas as pd
@@ -157,14 +142,9 @@ df = pd.DataFrame(data[1:], columns=data[0])
 
 ### Writing Numbers Documents
 
-Whilst support for writing numbers files has been stable since version
-3.4.0, you are highly recommended not to overwrite working Numbers files
-and instead save data to a new file.
+Whilst support for writing numbers files has been stable since version 3.4.0, you are highly recommended not to overwrite working Numbers files and instead save data to a new file.
 
-Cell values are written using
-[Table.write()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.write) and
-`numbers-parser` will automatically create empty rows and columns
-for any cell references that are out of range of the current table.
+Cell values are written using [Table.write()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.write) and `numbers-parser` will automatically create empty rows and columns for any cell references that are out of range of the current table.
 
 ```python
 doc = Document("write.numbers")
@@ -176,9 +156,7 @@ table.write("B7", datetime(2020, 12, 25))
 doc.save("new-sheet.numbers")
 ```
 
-Additional tables and worksheets can be added to a `Document` before saving using
-[Document.add_sheet()](https://masaccio.github.io/numbers-parser/api/document.html#numbers_parser.Document.add_sheet) and
-[Sheet.add_table()](https://masaccio.github.io/numbers-parser/api/sheet.html#numbers_parser.Sheet.add_table) respectively:
+Additional tables and worksheets can be added to a `Document` before saving using [Document.add_sheet()](https://masaccio.github.io/numbers-parser/api/document.html#numbers_parser.Document.add_sheet) and [Sheet.add_table()](https://masaccio.github.io/numbers-parser/api/sheet.html#numbers_parser.Sheet.add_table) respectively:
 
 ```python
 doc = Document()
@@ -204,19 +182,11 @@ styles. The following styles are supported:
 - cell background images
 - cell indents (first line, left, right, and text inset)
 
-Numbers conflates style attributes that can be stored in paragraph
-styles (the style menu in the text panel) with the settings that are
-available on the Style tab of the Text panel. Some attributes in Numbers
-are not applied to new cells when a style is applied.
+Numbers conflates style attributes that can be stored in paragraph styles (the style menu in the text panel) with the settings that are available on the Style tab of the Text panel. Some attributes in Numbers are not applied to new cells when a style is applied.
 
-To keep the API simple, `numbers-parser` packs all styling into a single
-[Style](https://masaccio.github.io/numbers-parser/api/style.html) object. When a document is saved, the attributes
-not stored in a paragraph style are applied to each cell that includes it.
+To keep the API simple, `numbers-parser` packs all styling into a single [Style](https://masaccio.github.io/numbers-parser/api/style.html) object. When a document is saved, the attributes not stored in a paragraph style are applied to each cell that includes it.
 
-Styles are read from cells using the
-[Cell.style](https://masaccio.github.io/numbers-parser/api/cells.html#numbers_parser.Cell.style) property and you can
-add new styles with
-[Document.add_style](https://masaccio.github.io/numbers-parser/api/document.html#numbers_parser.Document.add_style).
+Styles are read from cells using the [Cell.style](https://masaccio.github.io/numbers-parser/api/cells.html#numbers_parser.Cell.style) property and you can add new styles with [Document.add_style](https://masaccio.github.io/numbers-parser/api/document.html#numbers_parser.Document.add_style).
 
 ```python
 red_text = doc.add_style(
@@ -234,18 +204,11 @@ table.set_cell_style("C2", red_text)
 
 ### Cell Data Formatting
 
-Numbers has two different cell formatting types: data formats and custom
-formats.
+Numbers has two different cell formatting types: data formats and custom formats.
 
-Data formats are presented in Numbers in the Cell tab of the Format pane
-and are applied to individual cells. Like Numbers, `numbers-parsers`
-caches formatting information that is identical across multiple cells.
-You do not need to take any action for this to happen; this is handled
-internally by the package. Changing a data format for cell has no impact
-on any other cells.
+Data formats are presented in Numbers in the Cell tab of the Format pane and are applied to individual cells. Like Numbers, `numbers-parsers` caches formatting information that is identical across multiple cells. You do not need to take any action for this to happen; this is handled internally by the package. Changing a data format for cell has no impact on any other cells.
 
-Cell formats are changed using
-[Table.set_cell_formatting()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.set_cell_formatting):
+Cell formats are changed using [Table.set_cell_formatting()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.set_cell_formatting):
 
 ```python
 table.set_cell_formatting(
@@ -262,13 +225,7 @@ table.set_cell_formatting(
 )
 ```
 
-Custom formats are shared across a Document and can be applied to
-multiple cells in multiple tables. Editing a custom format changes the
-appearance of data in all cells that share that format. You must first
-add a custom format to the document using
-[Document.add_custom_format()](https://masaccio.github.io/numbers-parser/api/document.html#numbers_parser.Document.add_custom_format)
-before assigning it to cells using
-[Table.set_cell_formatting()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.set_cell_formatting):
+Custom formats are shared across a Document and can be applied to multiple cells in multiple tables. Editing a custom format changes the appearance of data in all cells that share that format. You must first add a custom format to the document using [Document.add_custom_format()](https://masaccio.github.io/numbers-parser/api/document.html#numbers_parser.Document.add_custom_format) before assigning it to cells using [Table.set_cell_formatting()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.set_cell_formatting):
 
 ```python
 long_date = doc.add_custom_format(
@@ -279,33 +236,17 @@ long_date = doc.add_custom_format(
 table.set_cell_formatting("C1", "custom", format=long_date)
 ```
 
-A limited number of currencies are formatted using symbolic notation
-rather than an ISO code. These are defined in
-`numbers_parser.currencies` and match the ones chosen by Numbers. For
-example, US dollars are referred to as `US$` whereas Euros and British
-Pounds are referred to using their symbols of `€` and `£`
-respectively.
+A limited number of currencies are formatted using symbolic notation rather than an ISO code. These are defined in `numbers_parser.currencies` and match the ones chosen by Numbers. For example, US dollars are referred to as `US$` whereas Euros and British Pounds are referred to using their symbols of `€` and `£` respectively.
 
 ### Borders
 
-`numbers-parser` supports reading and writing cell borders, though the
-interface for each differs. Individual cells can have each of their four
-borders tested, but when drawing new borders, these are set for the
-table to allow for drawing borders across multiple cells. Setting the
-border of merged cells is not possible unless the edge of the cells is
-at the end of the merged region.
+`numbers-parser` supports reading and writing cell borders, though the interface for each differs. Individual cells can have each of their four borders tested, but when drawing new borders, these are set for the table to allow for drawing borders across multiple cells. Setting the border of merged cells is not possible unless the edge of the cells is at the end of the merged region.
 
-Borders are represented using the [Border](https://masaccio.github.io/numbers-parser/api/border.html) class
-that can be initialized with line width, color and line style. The
-current state of a cell border is read using the
-[Cell.border](https://masaccio.github.io/numbers-parser/api/cells.html#numbers_parser.Cell.border) property
-and [Table.set_cell_border()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.set_cell_border)
-sets the border for a cell edge or a range of cells.
+Borders are represented using the [Border](https://masaccio.github.io/numbers-parser/api/border.html) class that can be initialized with line width, color and line style. The current state of a cell border is read using the [Cell.border](https://masaccio.github.io/numbers-parser/api/cells.html#numbers_parser.Cell.border) property and [Table.set_cell_border()](https://masaccio.github.io/numbers-parser/api/table.html#numbers_parser.Table.set_cell_border) sets the border for a cell edge or a range of cells.
 
 ## API
 
-For more examples and details of all available classes and methods,
-see the [full API docs](https://masaccio.github.io/numbers-parser/).
+For more examples and details of all available classes and methods, see the [full API docs](https://masaccio.github.io/numbers-parser/).
 
 ## Command-line scripts
 
@@ -318,9 +259,7 @@ a number of command-line scripts are installed:
 
 ### cat-numbers
 
-This script dumps Numbers spreadsheets into Excel-compatible CSV
-format, iterating through all the spreadsheets passed on the
-command-line.
+This script dumps Numbers spreadsheets into Excel-compatible CSV format, iterating through all the spreadsheets passed on the command-line.
 
 ```text
 usage: cat-numbers [-h] [-T | -S | -b] [-V] [--formulas] [--formatting]
@@ -349,25 +288,17 @@ options:
   --debug               Enable debug logging
 ```
 
-Note: `--formatting` will return different capitalization for 12-hour
-times due to differences between Numbers’ representation of these dates
-and `datetime.strftime`. Numbers in English locales displays 12-hour
-times with ‘am’ and ‘pm’, but `datetime.strftime` on macOS at least
-cannot return lower-case versions of AM/PM.
+Note: `--formatting` will return different capitalization for 12-hour times due to differences between Numbers’ representation of these dates and `datetime.strftime`. Numbers in English locales displays 12-hour times with ‘am’ and ‘pm’, but `datetime.strftime` on macOS at least cannot return lower-case versions of AM/PM.
 
 ### csv2numbers
 
-This script converts Excel-compatible CSV files into Numbers documents. Output files
-can optionally be provided, but is none are provided, the output is created by replacing
-the input’s files suffix with .numbers. For example:
+This script converts Excel-compatible CSV files into Numbers documents. Output files can optionally be provided, but is none are provided, the output is created by replacing the input’s files suffix with .numbers. For example:
 
 ```text
 csv2numbers file1.csv file2.csv -o file1.numbers file2.numbers
 ```
 
-Columns of data can have a number of transformations applied to them. The primary use-
-case intended for `csv2numbers` is converting banking exports to well-formatted
-spreadsheets.
+Columns of data can have a number of transformations applied to them. The primary use- case intended for `csv2numbers` is converting banking exports to well-formatted spreadsheets.
 
 ```text
 usage: csv2numbers [-h] [-V] [--whitespace] [--reverse] [--no-header]
@@ -455,39 +386,22 @@ csv2numbers --transform='Category=LOOKUP:Transaction;mapping.numbers' file1.csv
 
 Current known limitations of `numbers-parser` which may be implemented in the future are:
 
-- Table styles that allow new tables to adopt a style across the whole
-  table are not suppported
+- Table styles that allow new tables to adopt a style across the whole table are not supported
 - Creating cells of type `BulletedTextCell` is not supported
-- New tables are inserted with a fixed offset below the last table in a
-  worksheet which does not take into account title or caption size
-- Captions can be created and edited as of numbers-parser version 4.12, but cannot
-  be styled. New captions adopt the first caption style available in the current
-  document
+- New tables are inserted with a fixed offset below the last table in a worksheet which does not take into account title or caption size
+- Captions can be created and edited as of numbers-parser version 4.12, but cannot be styled. New captions adopt the first caption style available in the current document
 - Formulas cannot be written to a document
-- Pivot tables are unsupported and saving a document with a pivot table issues
-  a UnsupportedWarning (see [issue 73](https://github.com/masaccio/numbers-parser/issues/73) for details).
+- Pivot tables are unsupported and saving a document with a pivot table issues a UnsupportedWarning (see [issue 73](https://github.com/masaccio/numbers-parser/issues/73) for details).
+- Tables which have been saved grouped cannot be safely edited as references to written cells refer to the ungrouped cell rows rather than the row number in the groups.
 
 The following limitations are expected to always remain:
 
-- New sheets insert tables with formats copied from the first table in
-  the previous sheet rather than default table formats
-- Due to a limitation in Python’s
-  [ZipFile](https://docs.python.org/3/library/zipfile.html), Python
-  versions older than 3.11 do not support image filenames with UTF-8 characters
-  [Cell.add_style.bg_image()](https://masaccio.github.io/numbers-parser/api/sheet.html#numbers_parser.Style) returns
-  `None` for such files and issues a `RuntimeWarning`
-  (see [issue 69](https://github.com/masaccio/numbers-parser/issues/69) for details).
-- Password-encrypted documents cannot be opened. You must first re-save without
-  a password to read (see [issue 88](https://github.com/masaccio/numbers-parser/issues/88) for details).
-  A UnsupportedError exception is raised when such documents are opened.
-- Due to changes in the format of Numbers documents, decoding of category groups
-  (introduced in `numbers-parser` version 4.16) is supported only for documents
-  created by Numbers 12.0 and later. No warnings are issued for earlier
+- New sheets insert tables with formats copied from the first table in the previous sheet rather than default table formats
+- Due to a limitation in Python’s [ZipFile](https://docs.python.org/3/library/zipfile.html), Python versions older than 3.11 do not support image filenames with UTF-8 characters [Cell.add_style.bg_image()](https://masaccio.github.io/numbers-parser/api/sheet.html#numbers_parser.Style) returns `None` for such files and issues a `RuntimeWarning` (see [issue 69](https://github.com/masaccio/numbers-parser/issues/69) for details).
+- Password-encrypted documents cannot be opened. You must first re-save without a password to read (see [issue 88](https://github.com/masaccio/numbers-parser/issues/88) for details).  A UnsupportedError exception is raised when such documents are opened.
+- Due to changes in the format of Numbers documents, decoding of category groups (introduced in `numbers-parser` version 4.16) is supported only for documents created by Numbers 12.0 and later. No warnings are issued for earlier
   Numbers documents.
-- Only standard macOS fonts are not supported. If a document includes a non-standard
-  font, numbers-parser will issue a UnsupportedWarning and default styles to
-  Helvetica Neue. Reading font names from the system would add additional system-specific
-  dependencies to the package and so this is not planned to changed.
+- Only standard macOS fonts are not supported. If a document includes a non-standard font, numbers-parser will issue a UnsupportedWarning and default styles to Helvetica Neue. Reading font names from the system would add additional system-specific dependencies to the package and so this is not planned to changed.
 
 ## License
 

{numbers_parser-4.17.0.post1.dist-info → numbers_parser-4.18.0.dist-info}/RECORD

@@ -1,24 +1,23 @@
 numbers_parser/__init__.py,sha256=fKvZmUi_UsY3DMwt54s7G20DCwUTuG28B7kGsQRw3wU,1481
-numbers_parser/_cat_numbers.py,sha256=LQDBHLdVP8JIk0heV50T0Xz1oOMVNGILaX2mk8pVhCg,4846
+numbers_parser/_cat_numbers.py,sha256=6JR69SW3yNx1zOPfxpd0QA8mb9XGnIQckzl5O1L-pK4,5311
 numbers_parser/_csv2numbers.py,sha256=R_13gVe_RfLWLOv-DzVJ60xkqhdOA-RKna-Ce5ud4V8,14624
 numbers_parser/_unpack_numbers.py,sha256=x4Od4qEruPpzkoOq_i_zOFiNbNonlSRHBT3WGwZGYo8,6685
 numbers_parser/bullets.py,sha256=CKMjSYRzLM123wQNDG8B5vfodRLjW5UOc2HDPlvfNr4,2637
-numbers_parser/cell.py,sha256=RSjzkYWTUN753Q6V5xIQZ0GC2gkZDmnpB6uz4GJGZ0U,72311
+numbers_parser/cell.py,sha256=l0r7n0QX-MrPNo5DoHNrtn4iJYidpHHGfW3ioyhE2tw,71955
 numbers_parser/constants.py,sha256=FPkKRrkPtiV_KX9SWjR6DLlkDw644lmMw8GOBEG6Gsc,10658
 numbers_parser/containers.py,sha256=SBD99t0ABHraGA8729jPXy5VcRHT21U_WM3ijOIiwd4,4886
 numbers_parser/currencies.py,sha256=8k4a3WKmDoHeurkDICymHX13N7ManHSTaka_JNXCZYA,3767
-numbers_parser/document.py,sha256=6eCNbLRUmNoNEim8Wbk9DkhuhWHAtTmbexKDvld8Bp4,60866
-numbers_parser/exceptions.py,sha256=51yJTYm0X2am4YK-F6sVYOHmlYrBex_e4lYtbmiQX3I,611
-numbers_parser/experimental.py,sha256=WARjTa-2ePb8Ga8Q6oDP6EJCs12ofLRF2YpwzUu66ZI,374
-numbers_parser/formula.py,sha256=XC6maWkkQ-LKByiBQDIhzHOwvQIu-df6MN-vh4EETH8,26459
+numbers_parser/document.py,sha256=i0Bta5JtXYHRCcoARH6Yos2ZASugqv8RJIqLEpamWOc,61610
+numbers_parser/exceptions.py,sha256=aTpY9FMXa7RgsazJ8WEPxgA9qOzYd3lC5BK1TfcgCTs,612
+numbers_parser/experimental.py,sha256=Pox7smoekWsa4-TO0IN05-omE7HMf9PViWr_swf_B40,807
+numbers_parser/formula.py,sha256=0X5BsRzotN5ktPoafJITNo3mHTLjtasZ0PiBkiiHMFQ,9260
 numbers_parser/iwafile.py,sha256=nVwCcXvx8TgX-DkYqSbcJQzKyXR1Z8_y547XeY7Y-fs,11948
 numbers_parser/iwork.py,sha256=Qx1Izf9cfQKnLTDiJyeCOsmL9PSsfV-XOf0Kkb2oPMo,9396
-numbers_parser/model.py,sha256=VFD9CR33jKVCbsXFUrKV2elACQEnq8Ykhi5cqKvchlo,116600
+numbers_parser/model.py,sha256=WPVWnd8_QgBsMyi_sqdy1ML8WfxKAvBjyh_1lXavTfs,115812
 numbers_parser/numbers_cache.py,sha256=uGngtJmP_AEDGZphyJpOMJ1dq8VGEeDyPdyrVy1E7lU,1100
 numbers_parser/numbers_uuid.py,sha256=vVTgXgmtGx6PdbHfwyi82oRsZccmP7IW_o2q-6PGUNg,2880
 numbers_parser/roman.py,sha256=CErv1uRp8eE9Bsuh_QsrBAzKFsfHSEs8CHpfFW0Gd70,725
-numbers_parser/tokenizer.py,sha256=4pGdzX9zoxSYzaP7ywLwq8lOpVAm8hk96tMg9em7S6o,19804
-numbers_parser/xrefs.py,sha256=Oq-EL5bSSmXvJGSX-MPtXDcX-EROX859knm9y_Zz568,30043
+numbers_parser/xrefs.py,sha256=JZXH1FssaLVZL9tX8rvrdM6PfoM9Cte5F-hUxZVw-ZI,29994
 numbers_parser/data/empty.numbers,sha256=zQjVqcNGN-xNZh51_eAxD8Zxmxh88Sd7kpf4JygUA_E,90601
 numbers_parser/generated/TNArchives_pb2.py,sha256=ACEMFxxhu7QpKJT9bhx6k2WZMs_qBin-csiAiUi0YNc,17387
 numbers_parser/generated/TNArchives_sos_pb2.py,sha256=kBurQK0i7wFZ6nIh3we0n7xHbOTLJ6IYx2yZzF336G4,1534
@@ -57,9 +56,9 @@ numbers_parser/generated/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZ
 numbers_parser/generated/fontmap.py,sha256=N7RelrdanYW9mK7mcl42THasVcw0uQ9XeZ3wn4rOfKo,23586
 numbers_parser/generated/functionmap.py,sha256=7GzgkZfONzhI35pnByINiIGCbhMxhNz6EWiJEBX4s1g,6672
 numbers_parser/generated/mapping.py,sha256=W6fEWqar3TFvx2wyWgK4NutIz9EYKtjChhSfho2FGQQ,32266
-numbers_parser-4.17.0.post1.dist-info/licenses/LICENSE.rst,sha256=8vTa1-5KSdHrTpU9rlheO5005EWReEPMpjV7BjSaMc4,1050
-numbers_parser-4.17.0.post1.dist-info/METADATA,sha256=NdWr7x7X9xlPL-nkHopaz_xn0FkpP5aWzBiWEdu6G-8,23099
-numbers_parser-4.17.0.post1.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
-numbers_parser-4.17.0.post1.dist-info/entry_points.txt,sha256=_5biENfY3S-XG8BZL2AuE7Gvrw0zBwGjF6Un52u7FAk,165
-numbers_parser-4.17.0.post1.dist-info/top_level.txt,sha256=EOag5_Q4xjG7gstnrNVeAF_CLUAJBR_HDvciqMQ9RQo,15
-numbers_parser-4.17.0.post1.dist-info/RECORD,,
+numbers_parser-4.18.0.dist-info/licenses/LICENSE.rst,sha256=8vTa1-5KSdHrTpU9rlheO5005EWReEPMpjV7BjSaMc4,1050
+numbers_parser-4.18.0.dist-info/METADATA,sha256=5wcfPZkOtf-S2t-YsNxDhQ12lqc9h45nDZUiy7TVzKc,23358
+numbers_parser-4.18.0.dist-info/WHEEL,sha256=wUyA8OaulRlbfwMtmQsvNngGrxQHAvkKcvRmdizlJi0,92
+numbers_parser-4.18.0.dist-info/entry_points.txt,sha256=_5biENfY3S-XG8BZL2AuE7Gvrw0zBwGjF6Un52u7FAk,165
+numbers_parser-4.18.0.dist-info/top_level.txt,sha256=EOag5_Q4xjG7gstnrNVeAF_CLUAJBR_HDvciqMQ9RQo,15
+numbers_parser-4.18.0.dist-info/RECORD,,