numbers-parser 4.11.5__py3-none-any.whl → 4.12.1__py3-none-any.whl

numbers_parser/cell.py

@@ -993,7 +993,7 @@ class Cell(CellStorageFlags, Cacheable):
                 )
                 self._model.add_component_reference(
                     self._style._text_style_obj_id,
-                    parent_id=self._model._table_styles.id(self._table_id),
+                    component_id=self._model._table_styles.id(self._table_id),
                 )
 
             if self._style._cell_style_obj_id is not None:
@@ -1003,7 +1003,7 @@ class Cell(CellStorageFlags, Cacheable):
                 )
                 self._model.add_component_reference(
                     self._style._cell_style_obj_id,
-                    parent_id=self._model._table_styles.id(self._table_id),
+                    component_id=self._model._table_styles.id(self._table_id),
                 )
 
         length = 12

numbers_parser/model.py

@@ -331,15 +331,159 @@ class _NumbersModel(Cacheable):
         else:
             return not table_info.super.caption_hidden
 
+    def find_style_id(self, style_substr: str):
+        stylesheet = self.objects[self.stylesheet_id()]
+        caption_styles = [
+            x for x in stylesheet.identifier_to_style_map if style_substr in x.identifier.lower()
+        ]
+        return caption_styles[0].style.identifier
+
+    def caption_paragraph_style_id(self):
+        style_map = {
+            id: self.objects[id]
+            for id in self.find_refs("ParagraphStyleArchive")
+            if "Caption" in self.objects[id].super.name
+        }
+        return list(style_map.keys())[0]
+
+    @cache(num_args=0)
+    def stylesheet_id(self):
+        return self.find_refs("StylesheetArchive")[0]
+
+    def set_reference(self, obj: object, id: int):
+        obj.MergeFrom(TSPMessages.Reference(identifier=id))
+
+    def create_path_source_archive(self, table_id):
+        box_size = 100.0
+        return TSDArchives.PathSourceArchive(
+            horizontalFlip=False,
+            verticalFlip=False,
+            bezier_path_source=TSDArchives.BezierPathSourceArchive(
+                naturalSize=TSPMessages.Size(width=self.table_width(table_id), height=0.0),
+                path=TSPMessages.Path(
+                    elements=[
+                        TSPMessages.Path.Element(
+                            type=TSPMessages.Path.ElementType.moveTo,
+                            points=[TSPMessages.Point(x=0.0, y=0.0)],
+                        ),
+                        TSPMessages.Path.Element(
+                            type=TSPMessages.Path.ElementType.lineTo,
+                            points=[TSPMessages.Point(x=box_size, y=0.0)],
+                        ),
+                        TSPMessages.Path.Element(
+                            type=TSPMessages.Path.ElementType.lineTo,
+                            points=[TSPMessages.Point(x=box_size, y=box_size)],
+                        ),
+                        TSPMessages.Path.Element(
+                            type=TSPMessages.Path.ElementType.lineTo,
+                            points=[TSPMessages.Point(x=0.0, y=box_size)],
+                        ),
+                        TSPMessages.Path.Element(
+                            type=TSPMessages.Path.ElementType.closeSubpath,
+                        ),
+                        TSPMessages.Path.Element(
+                            type=TSPMessages.Path.ElementType.moveTo,
+                            points=[TSPMessages.Point(x=0.0, y=0.0)],
+                        ),
+                    ]
+                ),
+            ),
+        )
+
+    def create_caption_archive(self, table_id):
+        table_info_id = self.table_info_id(table_id)
+        table_info = self.objects[table_info_id]
+        caption_placement_id, _ = self.objects.create_object_from_dict(
+            "CalculationEngine",
+            {
+                "caption_anchor_location": 1,  # UPPER_LEFT
+                "drawable_anchor_location": 7,  # LOWER_LEFT
+            },
+            TSAArchives.CaptionPlacementArchive,
+        )
+        caption_info_id, caption_info = self.objects.create_object_from_dict(
+            "CalculationEngine",
+            {"childInfoKind": "Caption", "placement": {"identifier": caption_placement_id}},
+            TSAArchives.CaptionInfoArchive,
+        )
+        storage_id, storage = self.objects.create_object_from_dict(
+            "CalculationEngine",
+            {
+                "text": ["Caption"],
+                "in_document": True,
+                "style_sheet": {"identifier": self.stylesheet_id()},
+                "table_para_style": {
+                    "entries": [
+                        {
+                            "character_index": 0,
+                            "object": {"identifier": self.caption_paragraph_style_id()},
+                        }
+                    ]
+                },
+                "table_list_style": {
+                    "entries": [
+                        {
+                            "character_index": 0,
+                            "object": {"identifier": self.find_style_id("liststyle")},
+                        }
+                    ]
+                },
+                "table_para_starts": {"entries": [{"character_index": 0, "first": 0, "second": 0}]},
+                "table_para_bidi": {"entries": [{"character_index": 0, "first": 0, "second": 0}]},
+                "table_drop_cap_style": {"entries": [{"character_index": 0}]},
+            },
+            TSWPArchives.StorageArchive,
+        )
+        for object_id in [
+            storage_id,
+            self.find_style_id("caption"),
+            self.find_style_id("liststyle"),
+            self.caption_paragraph_style_id(),
+        ]:
+            self.add_component_reference(
+                object_id, location="CalculationEngine", component_id=self.stylesheet_id()
+            )
+        caption_info.super.MergeFrom(
+            TSWPArchives.ShapeInfoArchive(
+                is_text_box=True,
+                owned_storage=TSPMessages.Reference(identifier=storage_id),
+                deprecated_storage=TSPMessages.Reference(identifier=storage_id),
+                super=TSDArchives.ShapeArchive(
+                    super=self.create_drawable(table_info_id, 0, 500, flags=1),
+                    style={"identifier": self.find_style_id("caption")},
+                    strokePatternOffsetDistance=0.0,
+                    pathsource=self.create_path_source_archive(table_id),
+                ),
+            )
+        )
+
+        self.set_reference(table_info.super.caption, caption_info_id)
+        component = self.metadata_component(self.calc_engine_id())
+        component.object_uuid_map_entries.append(
+            TSPArchiveMessages.ObjectUUIDMapEntry(
+                identifier=caption_info_id, uuid=NumbersUUID().protobuf2
+            )
+        )
+
     def caption_text(self, table_id: int, caption: str = None) -> str:
         table_info = self.objects[self.table_info_id(table_id)]
         caption_info_id = table_info.super.caption.identifier
-        caption_storage_id = self.objects[caption_info_id].super.owned_storage.identifier
-        caption_text = self.objects[caption_storage_id].text
+        caption_archive = self.objects[caption_info_id]
+
+        if caption_archive.DESCRIPTOR.name == "StandinCaptionArchive":
+            if caption is None:
+                return "Caption"
+            else:
+                self.create_caption_archive(table_id)
+                caption_info_id = table_info.super.caption.identifier
+                caption_archive = self.objects[caption_info_id]
+
+        caption_storage_id = caption_archive.super.owned_storage.identifier
         if caption is not None:
-            caption_text[0] = caption
+            clear_field_container(self.objects[caption_storage_id].text)
+            self.objects[caption_storage_id].text.append(caption)
         else:
-            return caption_text[0]
+            return self.objects[caption_storage_id].text[0]
 
     @cache()
     def table_tiles(self, table_id):
@@ -882,7 +1026,7 @@ class _NumbersModel(Cacheable):
             merge_map.cell_range.append(cell_range)
 
         base_data_store = self.objects[table_id].base_data_store
-        base_data_store.merge_region_map.CopyFrom(TSPMessages.Reference(identifier=merge_map_id))
+        self.set_reference(base_data_store.merge_region_map, merge_map_id)
 
     def recalculate_row_info(
         self,
@@ -943,19 +1087,19 @@ class _NumbersModel(Cacheable):
             save_token=1,
         )
         self.objects[PACKAGE_ID].components.append(component_info)
-        self.add_component_reference(object_id, parent)
+        self.add_component_reference(object_id, location=parent)
 
     def add_component_reference(
         self,
         object_id: int,
         location: Optional[str] = None,
-        parent_id: Optional[int] = None,
+        component_id: Optional[int] = None,
         is_weak: bool = False,
     ):
         """Add an external reference to an object in a metadata component."""
-        component = self.metadata_component(location or parent_id)
-        if parent_id is not None:
-            params = {"object_identifier": object_id, "component_identifier": parent_id}
+        component = self.metadata_component(location or component_id)
+        if component_id is not None:
+            params = {"object_identifier": object_id, "component_identifier": component_id}
         else:
             params = {"component_identifier": object_id}
         if is_weak:
@@ -1175,7 +1319,15 @@ class _NumbersModel(Cacheable):
 
         return self.table_height(table_id) + y_offset
 
-    def create_drawable(self, sheet_id: int, x: float, y: float) -> object:
+    def create_drawable(
+        self,
+        sheet_id: int,
+        x: float,
+        y: float,
+        flags: int = 3,
+        height: float = 231.0,
+        width: float = 494.0,
+    ) -> object:
         """Create a DrawableArchive for a new table in a sheet."""
         table_x = x if x is not None else 0.0
         table_y = y if y is not None else self.last_table_offset(sheet_id) + DEFAULT_TABLE_OFFSET
@@ -1183,9 +1335,9 @@ class _NumbersModel(Cacheable):
             parent=TSPMessages.Reference(identifier=sheet_id),
             geometry=TSDArchives.GeometryArchive(
                 angle=0.0,
-                flags=3,
+                flags=flags,
                 position=TSPMessages.Point(x=table_x, y=table_y),
-                size=TSPMessages.Size(height=231.0, width=494.0),
+                size=TSPMessages.Size(height=height, width=width),
             ),
         )
 
@@ -1239,35 +1391,12 @@ class _NumbersModel(Cacheable):
             "Tables/HeaderStorageBucket-{}",
         )
 
-        from_table_info = self.objects[self.table_info_id(from_table_id)]
-        from_caption_info = self.objects[from_table_info.super.caption.identifier]
-        caption_storage_id, caption_storage = self.objects.create_object_from_dict(
-            "CalculationEngine",
-            {"text": ["Caption"]},
-            TSWPArchives.StorageArchive,
-        )
-        caption_storage.MergeFrom(self.objects[from_caption_info.super.owned_storage.identifier])
-        caption_info_id, caption_info = self.objects.create_object_from_dict(
-            "CalculationEngine",
-            {},
-            TSAArchives.CaptionInfoArchive,
-        )
-        caption_info.super.CopyFrom(from_caption_info.super)
-        caption_info.super.super.CopyFrom(from_caption_info.super.super)
-        caption_info.super.super.super.CopyFrom(from_caption_info.super.super.super)
-        caption_info.super.deprecated_storage.MergeFrom(
-            TSPMessages.Reference(identifier=caption_storage_id)
-        )
-        caption_info.super.owned_storage.MergeFrom(
-            TSPMessages.Reference(identifier=caption_storage_id)
-        )
-
         sidecar_id, _ = self.objects.create_object_from_dict(
             "CalculationEngine",
             {"max_order": 1, "column_count": 0, "row_count": 0},
             TSTArchives.StrokeSidecarArchive,
         )
-        table_model.stroke_sidecar.MergeFrom(TSPMessages.Reference(identifier=sidecar_id))
+        self.set_reference(table_model.stroke_sidecar, sidecar_id)
 
         style_table_id, _ = self.objects.create_object_from_dict(
             "Index/Tables/DataList-{}",
@@ -1347,11 +1476,11 @@ class _NumbersModel(Cacheable):
         )
         table_info.tableModel.MergeFrom(TSPMessages.Reference(identifier=table_model_id))
         table_info.super.MergeFrom(self.create_drawable(sheet_id, x, y))
-        caption_info.super.super.super.parent.MergeFrom(
-            TSPMessages.Reference(identifier=table_info_id)
+
+        self.add_component_reference(
+            table_info_id, location="Document", component_id=self.calc_engine_id()
         )
-        table_info.super.caption.MergeFrom(TSPMessages.Reference(identifier=caption_info_id))
-        self.add_component_reference(table_info_id, "Document", self.calc_engine_id())
+        self.create_caption_archive(table_model_id)
 
         self.add_formula_owner(
             table_info_id,
@@ -1452,7 +1581,9 @@ class _NumbersModel(Cacheable):
             TNArchives.SheetArchive,
         )
 
-        self.add_component_reference(sheet_id, "CalculationEngine", DOCUMENT_ID, is_weak=True)
+        self.add_component_reference(
+            sheet_id, location="CalculationEngine", component_id=DOCUMENT_ID, is_weak=True
+        )
 
         self.objects[DOCUMENT_ID].sheets.append(TSPMessages.Reference(identifier=sheet_id))
 

{numbers_parser-4.11.5.dist-info → numbers_parser-4.12.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: numbers-parser
-Version: 4.11.5
+Version: 4.12.1
 Summary: Read and write Apple Numbers spreadsheets
 Home-page: https://github.com/masaccio/numbers-parser
 License: MIT
@@ -15,6 +15,7 @@ Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
+Requires-Dist: colorama (>=0.4.6,<0.5.0)
 Requires-Dist: compact-json (>=1.1.3,<2.0.0)
 Requires-Dist: enum-tools (>=0.11)
 Requires-Dist: importlib-resources (>=6.1)
@@ -383,9 +384,12 @@ Current known limitations of `numbers-parser` which may be implemented in the fu
 - 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
 - Formulas cannot be written to a document
 - Pivot tables are unsupported and saving a document with a pivot table issues
-  a UnsupportedWarning.
+  a UnsupportedWarning (see [issue 73](https://github.com/masaccio/numbers-parser/issues/73) for details).
 
 The following limitations are expected to always remain:
 
@@ -396,7 +400,9 @@ The following limitations are expected to always remain:
   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/ssues/69) for details).
+  (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).
 
 ## License
 

{numbers_parser-4.11.5.dist-info → numbers_parser-4.12.1.dist-info}/RECORD

@@ -2,7 +2,7 @@ numbers_parser/__init__.py,sha256=1guReSiMinXSKkip4UoC-a1X9OAgdiYTTDiZ03FDmqE,14
 numbers_parser/_cat_numbers.py,sha256=3tLvBQEagGcNL26XxfqguNim0JDtTNgEbiGKpLjBxLI,4623
 numbers_parser/_unpack_numbers.py,sha256=7B6AJ2GB-MzFdrKal_GMMgUWzVUZ5h9PsPJecGk2ppY,7032
 numbers_parser/bullets.py,sha256=OnVVMPjhTDrC-ncw52Gb00UEXNmn2Rvd3xi7lfqW3hk,2616
-numbers_parser/cell.py,sha256=18xi25ZoIOEwuOEX8T1FyLQBt0lx9jURE0gDIKjyGnI,76340
+numbers_parser/cell.py,sha256=mPSuRAXPx3SW6xUDhYj7T3Y5P9qmUaXL8rXXfZn8GpQ,76346
 numbers_parser/constants.py,sha256=L9_UhsWMqswsn1sCr-aAx_7mR2k8IHYdhpe8t_CP6lM,9924
 numbers_parser/containers.py,sha256=j0FhaXPUG5YSRK5_3WIxXQOeckHVu24KMlYetWIZ_Xg,4882
 numbers_parser/currencies.py,sha256=8k4a3WKmDoHeurkDICymHX13N7ManHSTaka_JNXCZYA,3767
@@ -50,11 +50,11 @@ numbers_parser/generated/functionmap.py,sha256=VdZo0ERMYONcrnJFwABcSCHb8pjA4wY2o
 numbers_parser/generated/mapping.py,sha256=xt1NaZtTse1OX3vBizENKkWl-0OgNb4SMJ0Uo-rRz0U,32342
 numbers_parser/iwafile.py,sha256=4_MMtHdWMAfIzwODyaM7DsWKh-8yJ2blTfbues8sbdI,11915
 numbers_parser/iwork.py,sha256=CXXM797MqcIokovrIBAx--LNG7tIVpKqeBwR4V2OrzQ,9141
-numbers_parser/model.py,sha256=OP11pcTZeDUKynoNRvVA5CCkprag_QBal1zULhTgb6E,101421
+numbers_parser/model.py,sha256=Pmk-EDAru0zSmdzlA21yi2ASzz8W-aXWnRiMFOfnaDE,106550
 numbers_parser/numbers_cache.py,sha256=1ghEBghQAYFpPiEeOtb74i016mXc039v1pOubbqvaLs,1141
 numbers_parser/numbers_uuid.py,sha256=q0IbHFKuBXC7MnZN3g55dgCVKOLD-4SO4MdXeN6dt0g,2699
-numbers_parser-4.11.5.dist-info/LICENSE.rst,sha256=8vTa1-5KSdHrTpU9rlheO5005EWReEPMpjV7BjSaMc4,1050
-numbers_parser-4.11.5.dist-info/METADATA,sha256=9_q8XcLwLgdMu30GSGrLCEAu_CgjpRXWEgb3GgnOeuw,16212
-numbers_parser-4.11.5.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
-numbers_parser-4.11.5.dist-info/entry_points.txt,sha256=V91uB9vBPxf3eCY1h-0syv21imYCT0MJfMxf87DmwIk,115
-numbers_parser-4.11.5.dist-info/RECORD,,
+numbers_parser-4.12.1.dist-info/LICENSE.rst,sha256=8vTa1-5KSdHrTpU9rlheO5005EWReEPMpjV7BjSaMc4,1050
+numbers_parser-4.12.1.dist-info/METADATA,sha256=8QSGsiUju4R9rYJ0nz2PrCe31_M0ZRj7z7SiHx0keSM,16697
+numbers_parser-4.12.1.dist-info/WHEEL,sha256=FMvqSimYX_P7y0a7UY-_Mc83r5zkBZsCYPm7Lr0Bsq4,88
+numbers_parser-4.12.1.dist-info/entry_points.txt,sha256=V91uB9vBPxf3eCY1h-0syv21imYCT0MJfMxf87DmwIk,115
+numbers_parser-4.12.1.dist-info/RECORD,,