numbers-parser 4.22.0__tar.gz → 4.23.0__tar.gz
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- {numbers_parser-4.22.0/src/numbers_parser.egg-info → numbers_parser-4.23.0}/PKG-INFO +8 -9
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/README.md +5 -6
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/pyproject.toml +99 -71
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/__init__.py +10 -6
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/_cat_numbers.py +29 -13
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/_csv2numbers.py +71 -71
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/_unpack_numbers.py +66 -41
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/bullets.py +1 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/cell.py +517 -299
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/constants.py +49 -6
- numbers_parser-4.23.0/src/numbers_parser/containers.py +262 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/currencies.py +1 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/document.py +411 -137
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/exceptions.py +4 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/experimental.py +9 -2
- numbers_parser-4.23.0/src/numbers_parser/formula.py +429 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNArchives_pb2.py +42 -42
- numbers_parser-4.23.0/src/numbers_parser/generated/TNArchives_pb2.pyi +906 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TNArchives_sos_pb2.pyi +48 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TNCommandArchives_pb2.pyi +1335 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TNCommandArchives_sos_pb2.pyi +69 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSAArchives_pb2.pyi +1285 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSAArchives_sos_pb2.pyi +88 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSACommandArchives_sos_pb2.pyi +226 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCEArchives_pb2.pyi +4697 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCH3DArchives_pb2.pyi +753 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_Common_pb2.pyi +571 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_GEN_pb2.pyi +2124 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_pb2.pyi +1197 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_sos_pb2.pyi +3001 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHCommandArchives_pb2.pyi +1848 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHPreUFFArchives_pb2.py +68 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCHPreUFFArchives_pb2.pyi +1491 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCKArchives_pb2.pyi +1788 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSCKArchives_sos_pb2.pyi +95 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDArchives_pb2.py +83 -81
- numbers_parser-4.23.0/src/numbers_parser/generated/TSDArchives_pb2.pyi +2886 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSDArchives_sos_pb2.pyi +395 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSDCommandArchives_pb2.pyi +2015 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSKArchives_pb2.py +161 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSKArchives_pb2.pyi +1850 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPArchiveMessages_pb2.py +32 -32
- numbers_parser-4.23.0/src/numbers_parser/generated/TSPArchiveMessages_pb2.pyi +1013 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSPDatabaseMessages_pb2.pyi +112 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSPMessages_pb2.pyi +1220 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSSArchives_pb2.py +74 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSSArchives_pb2.pyi +696 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSSArchives_sos_pb2.pyi +229 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSTArchives_pb2.pyi +6084 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSTArchives_sos_pb2.pyi +572 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSTCommandArchives_pb2.pyi +3998 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSTStylePropertyArchiving_pb2.pyi +620 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSWPArchives_pb2.pyi +3732 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSWPArchives_sos_pb2.pyi +1817 -0
- numbers_parser-4.23.0/src/numbers_parser/generated/TSWPCommandArchives_pb2.pyi +1580 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/fontmap.py +187 -180
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/iwafile.py +170 -79
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/iwork.py +94 -51
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/model.py +970 -600
- numbers_parser-4.23.0/src/numbers_parser/numbers_cache.py +74 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/numbers_uuid.py +23 -6
- numbers_parser-4.23.0/src/numbers_parser/py.typed +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/roman.py +4 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/xrefs.py +248 -148
- {numbers_parser-4.22.0 → numbers_parser-4.23.0/src/numbers_parser.egg-info}/PKG-INFO +8 -9
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/SOURCES.txt +36 -2
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/requires.txt +1 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_all_formulas.py +42 -16
- numbers_parser-4.23.0/tests/test_api_change.py +45 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_borders.py +126 -64
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_bullets.py +31 -10
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_cat_numbers.py +43 -22
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_categories.py +70 -16
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_comments.py +16 -7
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_coverage.py +122 -66
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_create_cells.py +19 -17
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_csv2numbers.py +16 -14
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_currency.py +4 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_encrypted.py +75 -25
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_folder.py +4 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_formatting.py +90 -44
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_formulas.py +23 -11
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_issues.py +316 -169
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_large.py +20 -11
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_local_docs.py +20 -46
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_memory_leaks.py +5 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_merges.py +16 -10
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_package.py +16 -6
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_properties.py +6 -2
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_roman.py +6 -5
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_save.py +32 -21
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_slices.py +49 -25
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_styles.py +173 -126
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_table_size.py +32 -24
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_tables.py +35 -19
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_unpack_numbers.py +74 -24
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_unsupported.py +4 -1
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_uuids.py +16 -8
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_version.py +19 -6
- numbers_parser-4.22.0/src/numbers_parser/containers.py +0 -174
- numbers_parser-4.22.0/src/numbers_parser/formula.py +0 -283
- numbers_parser-4.22.0/src/numbers_parser/generated/TSKArchives_pb2.py +0 -161
- numbers_parser-4.22.0/src/numbers_parser/generated/TSSArchives_pb2.py +0 -74
- numbers_parser-4.22.0/src/numbers_parser/numbers_cache.py +0 -39
- numbers_parser-4.22.0/tests/test_api_change.py +0 -28
- numbers_parser-4.22.0/tests/test_write_empty_cell.py +0 -25
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/LICENSE.rst +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/setup.cfg +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/data/empty.numbers +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNCommandArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNCommandArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSAArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSAArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSACommandArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCEArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCH3DArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_Common_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_GEN_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHCommandArchives_pb2.py +0 -0
- /numbers_parser-4.22.0/src/numbers_parser/generated/TSCHPreUFFArchives_pb2.py → /numbers_parser-4.23.0/src/numbers_parser/generated/TSCHPreUFFArchives_pb2 2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCKArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCKArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDCommandArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPDatabaseMessages_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPMessages_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSSArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTCommandArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTStylePropertyArchiving_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPArchives_sos_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPCommandArchives_pb2.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/__init__.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/functionmap.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/mapping.py +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/dependency_links.txt +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/entry_points.txt +0 -0
- {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/top_level.txt +0 -0
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
Metadata-Version: 2.4
|
|
2
2
|
Name: numbers-parser
|
|
3
|
-
Version: 4.
|
|
3
|
+
Version: 4.23.0
|
|
4
4
|
Summary: Read and write Apple Numbers spreadsheets
|
|
5
5
|
Author-email: Jon Connell <python@figsandfudge.com>
|
|
6
6
|
License-Expression: MIT
|
|
@@ -9,7 +9,7 @@ Project-URL: documentation, https://github.com/masaccio/numbers-parser/blob/main
|
|
|
9
9
|
Classifier: Topic :: Office/Business :: Financial :: Spreadsheet
|
|
10
10
|
Classifier: Programming Language :: Python :: 3
|
|
11
11
|
Classifier: Operating System :: OS Independent
|
|
12
|
-
Requires-Python: >=3.
|
|
12
|
+
Requires-Python: >=3.11
|
|
13
13
|
Description-Content-Type: text/markdown
|
|
14
14
|
License-File: LICENSE.rst
|
|
15
15
|
Requires-Dist: compact-json>=1.1.3
|
|
@@ -19,7 +19,7 @@ Requires-Dist: sigfig>=1.3.3
|
|
|
19
19
|
Requires-Dist: setuptools>=70.0.0
|
|
20
20
|
Requires-Dist: importlib-resources>=6.1
|
|
21
21
|
Requires-Dist: enum-tools>=0.11
|
|
22
|
-
Requires-Dist: python-dateutil>=
|
|
22
|
+
Requires-Dist: python-dateutil>=4.0.0
|
|
23
23
|
Requires-Dist: security>=1.3.1
|
|
24
24
|
Requires-Dist: cryptography>=50.0.1
|
|
25
25
|
Dynamic: license-file
|
|
@@ -28,9 +28,9 @@ Dynamic: license-file
|
|
|
28
28
|
|
|
29
29
|
[](https://github.com/masaccio/numbers-parser/actions/workflows/run-all-tests.yml)[](https://github.com/masaccio/numbers-parser/actions/workflows/codeql.yml)[](https://codecov.io/gh/masaccio/numbers-parser)[](https://badge.fury.io/py/numbers-parser)
|
|
30
30
|
|
|
31
|
-
`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.
|
|
31
|
+
`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.5 (the last version of Numbers) and Numbers Creator Studio up to version 15.4, which the most current as of October 2026.
|
|
32
32
|
|
|
33
|
-
It supports and is tested against Python versions from 3.
|
|
33
|
+
It supports and is tested against Python versions from 3.11 onwards. It is not compatible with earlier versions of Python.
|
|
34
34
|
|
|
35
35
|
## Installation
|
|
36
36
|
|
|
@@ -313,9 +313,9 @@ Columns of data can have a number of transformations applied to them. The primar
|
|
|
313
313
|
|
|
314
314
|
```text
|
|
315
315
|
usage: csv2numbers [-h] [-V] [--whitespace] [--reverse] [--no-header]
|
|
316
|
-
[--day-first] [--date COLUMNS] [--
|
|
317
|
-
[--
|
|
318
|
-
[-o [FILENAME ...]]
|
|
316
|
+
[--day-first] [--date COLUMNS] [--encoding ENCODING]
|
|
317
|
+
[--rename COLUMNS-MAP] [--transform COLUMNS-MAP]
|
|
318
|
+
[--delete COLUMNS] [-o [FILENAME ...]]
|
|
319
319
|
[csvfile ...]
|
|
320
320
|
|
|
321
321
|
positional arguments:
|
|
@@ -404,7 +404,6 @@ Current known limitations of `numbers-parser` which may be implemented in the fu
|
|
|
404
404
|
- 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
|
|
405
405
|
- 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
|
|
406
406
|
- Formulas cannot be written to a document
|
|
407
|
-
- 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).
|
|
408
407
|
- 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.
|
|
409
408
|
|
|
410
409
|
The following limitations are expected to always remain:
|
|
@@ -2,9 +2,9 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://github.com/masaccio/numbers-parser/actions/workflows/run-all-tests.yml)[](https://github.com/masaccio/numbers-parser/actions/workflows/codeql.yml)[](https://codecov.io/gh/masaccio/numbers-parser)[](https://badge.fury.io/py/numbers-parser)
|
|
4
4
|
|
|
5
|
-
`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.
|
|
5
|
+
`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.5 (the last version of Numbers) and Numbers Creator Studio up to version 15.4, which the most current as of October 2026.
|
|
6
6
|
|
|
7
|
-
It supports and is tested against Python versions from 3.
|
|
7
|
+
It supports and is tested against Python versions from 3.11 onwards. It is not compatible with earlier versions of Python.
|
|
8
8
|
|
|
9
9
|
## Installation
|
|
10
10
|
|
|
@@ -287,9 +287,9 @@ Columns of data can have a number of transformations applied to them. The primar
|
|
|
287
287
|
|
|
288
288
|
```text
|
|
289
289
|
usage: csv2numbers [-h] [-V] [--whitespace] [--reverse] [--no-header]
|
|
290
|
-
[--day-first] [--date COLUMNS] [--
|
|
291
|
-
[--
|
|
292
|
-
[-o [FILENAME ...]]
|
|
290
|
+
[--day-first] [--date COLUMNS] [--encoding ENCODING]
|
|
291
|
+
[--rename COLUMNS-MAP] [--transform COLUMNS-MAP]
|
|
292
|
+
[--delete COLUMNS] [-o [FILENAME ...]]
|
|
293
293
|
[csvfile ...]
|
|
294
294
|
|
|
295
295
|
positional arguments:
|
|
@@ -378,7 +378,6 @@ Current known limitations of `numbers-parser` which may be implemented in the fu
|
|
|
378
378
|
- 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
|
|
379
379
|
- 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
|
|
380
380
|
- Formulas cannot be written to a document
|
|
381
|
-
- 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).
|
|
382
381
|
- 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.
|
|
383
382
|
|
|
384
383
|
The following limitations are expected to always remain:
|
|
@@ -3,7 +3,7 @@ authors = [
|
|
|
3
3
|
{name = "Jon Connell", email = "python@figsandfudge.com"},
|
|
4
4
|
]
|
|
5
5
|
license = "MIT"
|
|
6
|
-
requires-python = ">=3.
|
|
6
|
+
requires-python = ">=3.11"
|
|
7
7
|
dependencies = [
|
|
8
8
|
"compact-json>=1.1.3",
|
|
9
9
|
"protobuf>=7.36.0",
|
|
@@ -12,7 +12,7 @@ dependencies = [
|
|
|
12
12
|
"setuptools>=70.0.0",
|
|
13
13
|
"importlib-resources>=6.1",
|
|
14
14
|
"enum-tools>=0.11",
|
|
15
|
-
"python-dateutil>=
|
|
15
|
+
"python-dateutil>=4.0.0",
|
|
16
16
|
"security>=1.3.1",
|
|
17
17
|
"cryptography>=50.0.1",
|
|
18
18
|
]
|
|
@@ -24,7 +24,7 @@ classifiers = [
|
|
|
24
24
|
description = "Read and write Apple Numbers spreadsheets"
|
|
25
25
|
name = "numbers-parser"
|
|
26
26
|
readme = "README.md"
|
|
27
|
-
version = "4.
|
|
27
|
+
version = "4.23.0"
|
|
28
28
|
|
|
29
29
|
[project.urls]
|
|
30
30
|
repository = "https://github.com/masaccio/numbers-parser"
|
|
@@ -48,14 +48,18 @@ dev = [
|
|
|
48
48
|
"python-magic>=0.4",
|
|
49
49
|
"colorama<1.0.0,>=0.4.6",
|
|
50
50
|
"pympler<2.0,>=1.1",
|
|
51
|
+
"pre-commit>=4.6.2",
|
|
52
|
+
"pylint>=4.1.3",
|
|
53
|
+
"mypy>=2.4.1",
|
|
54
|
+
"types-protobuf>=7.35.1.20260906",
|
|
51
55
|
]
|
|
52
56
|
docs = [
|
|
53
|
-
"sphinx
|
|
54
|
-
"enum-tools>=0.11",
|
|
57
|
+
"sphinx>=7.3,<10.0",
|
|
55
58
|
"sphinx-toolbox>=3.5",
|
|
56
59
|
"sphinx-nefertiti>=0.7",
|
|
57
60
|
"sphinx-markdown-builder>=0.6",
|
|
58
61
|
"sphinx-copybutton>=0.5.2",
|
|
62
|
+
"sphinxcontrib-mermaid>=2.1.1",
|
|
59
63
|
# Security updates
|
|
60
64
|
"urllib3>=2.7.0",
|
|
61
65
|
"filelock>=3.20.1",
|
|
@@ -73,10 +77,11 @@ bootstrap = [
|
|
|
73
77
|
"pyobjc-core>=12.0",
|
|
74
78
|
"pyobjc-framework-Cocoa>=10.2",
|
|
75
79
|
"py2app>=0.28",
|
|
80
|
+
"mypy-protobuf>=5.1.0",
|
|
76
81
|
]
|
|
77
82
|
visualcheck = [
|
|
78
83
|
"osascript>=0.0.27",
|
|
79
|
-
"pillow>=
|
|
84
|
+
"pillow>=13.0.0",
|
|
80
85
|
"pixelmatch>=0.4.0",
|
|
81
86
|
"pymupdf>=1.28.2",
|
|
82
87
|
"rich>=15.0.0",
|
|
@@ -93,7 +98,7 @@ exclude = ["*tests*", "numbers_parser.data"]
|
|
|
93
98
|
namespaces = false # disable scanning PEP 420 namespaces
|
|
94
99
|
|
|
95
100
|
[tool.setuptools.package-data]
|
|
96
|
-
"numbers_parser" = ["data/*"]
|
|
101
|
+
"numbers_parser" = ["data/*", "py.typed"]
|
|
97
102
|
|
|
98
103
|
[tool.coverage.run]
|
|
99
104
|
branch = true
|
|
@@ -105,8 +110,10 @@ show_contexts = false
|
|
|
105
110
|
|
|
106
111
|
[tool.coverage.report]
|
|
107
112
|
exclude_lines = [
|
|
108
|
-
|
|
109
|
-
|
|
113
|
+
"overload",
|
|
114
|
+
"pragma: no cover",
|
|
115
|
+
"raise NotImplementedError",
|
|
116
|
+
"TYPE_CHECKING",
|
|
110
117
|
]
|
|
111
118
|
|
|
112
119
|
[tool.pytest.ini_options]
|
|
@@ -114,7 +121,7 @@ addopts = "--cov=src/numbers_parser --cov-report=html --cov-report=term-missing:
|
|
|
114
121
|
|
|
115
122
|
[tool.tox]
|
|
116
123
|
requires = ["tox>=4.0"]
|
|
117
|
-
env_list = ["
|
|
124
|
+
env_list = ["py311", "py312", "py313", "py314", "py315"]
|
|
118
125
|
|
|
119
126
|
[tool.tox.env_run_base]
|
|
120
127
|
deps = [
|
|
@@ -128,7 +135,7 @@ deps = [
|
|
|
128
135
|
"colorama"
|
|
129
136
|
]
|
|
130
137
|
commands = [
|
|
131
|
-
["pytest", "tests/", "--import-mode", "importlib", "-n", "logical", "--no-cov"]
|
|
138
|
+
["pytest", "-qq", "tests/", "--import-mode", "importlib", "-n", "logical", "--no-cov"]
|
|
132
139
|
]
|
|
133
140
|
|
|
134
141
|
[tool.isort]
|
|
@@ -143,66 +150,29 @@ exclude = [
|
|
|
143
150
|
"**/src/numbers_parser/generated/*",
|
|
144
151
|
# Third-party files not to lint
|
|
145
152
|
"**/src/debug/lldbutil.py",
|
|
153
|
+
"**/src/build/protodump.py",
|
|
146
154
|
]
|
|
147
155
|
fix = true
|
|
156
|
+
lint.select = [ "ALL" ]
|
|
148
157
|
lint.ignore = [
|
|
149
|
-
"
|
|
150
|
-
#
|
|
151
|
-
"
|
|
152
|
-
"
|
|
153
|
-
"
|
|
154
|
-
"
|
|
155
|
-
"
|
|
156
|
-
"
|
|
157
|
-
"
|
|
158
|
-
"
|
|
159
|
-
"
|
|
160
|
-
"
|
|
161
|
-
"
|
|
162
|
-
"ARG003", # Unused class method argument
|
|
163
|
-
"BLE001", # Do not catch blind exception
|
|
164
|
-
"CPY001", # Copyright
|
|
165
|
-
"COM812", # Conflicts
|
|
166
|
-
"C901", # Code too complex
|
|
167
|
-
"D100", # Missing docstring
|
|
168
|
-
"D101", # Missing docstring
|
|
169
|
-
"D102", # Missing docstring
|
|
170
|
-
"D103", # Missing docstring
|
|
171
|
-
"D105", # Missing docstring
|
|
172
|
-
"D107", # Missing docstring
|
|
173
|
-
"D205", # Blank line - conflicts with black
|
|
174
|
-
"D210", # No whitespaces allowed surrounding docstring text
|
|
175
|
-
"D400", # First line should end with a period
|
|
176
|
-
"D401", # First line of docstring should be in imperative mood
|
|
177
|
-
"D415", # First line should end with a period, question mark, or exclamation point
|
|
178
|
-
"E501", # Line too long
|
|
179
|
-
"ERA001", # Remove commented out code
|
|
180
|
-
"FBT001", # Boolean-typed positional argument in function definition
|
|
181
|
-
"FBT002", # Boolean default positional argument in function definition
|
|
182
|
-
"FBT003", # Boolean positional value in function call
|
|
183
|
-
"FIX002", # Line contains TODO, consider resolving the issue
|
|
184
|
-
"ISC003", # Explicitly concatenated string should be implicitly concatenated
|
|
185
|
-
"PERF401", # Use a list comprehension to create a transformed list
|
|
186
|
-
"PLR0913", # Too many arguments
|
|
187
|
-
"PLR2004", # Magic value used
|
|
188
|
-
"PLW0603", # Using the global statement
|
|
189
|
-
"PTH103", # Use of os.makedirs()
|
|
190
|
-
"PTH118", # Use of os.path.join()
|
|
191
|
-
"PTH119", # Use of os.path.basename()
|
|
192
|
-
"PTH123", # Use of open()
|
|
193
|
-
"RUF001", # String contains ambiguous
|
|
194
|
-
"RUF002", # Docstring contains ambiguous
|
|
195
|
-
"RUF003", # Comment contains ambiguous
|
|
196
|
-
"SIM115", # Use a context manager for opening files
|
|
197
|
-
"SLF001", # Private member accessed
|
|
198
|
-
"TD002", # TODO author
|
|
199
|
-
"TD003", # TODO author
|
|
158
|
+
"CPY001", # Missing copyright notice at top of file
|
|
159
|
+
"FIX002", # Line contains TODO
|
|
160
|
+
"FBT001", # Boolean-typed positional argument in function definition
|
|
161
|
+
"FBT002", # Boolean default positional argument in function definition
|
|
162
|
+
"PTH103", # os.makedirs() should be replaced by Path.mkdir(parents=True)
|
|
163
|
+
"PTH118", # os.path.join() should be replaced by Path.joinpath()
|
|
164
|
+
"PTH118", # os.path.join() should be replaced by Path with / operator
|
|
165
|
+
"PTH119", # os.path.basename() should be replaced by Path.name
|
|
166
|
+
"PTH123", # open() should be replaced by Path.open()
|
|
167
|
+
"PLR0913", # Too many arguments in function definition
|
|
168
|
+
"SIM115", # Use a context manager for opening files
|
|
169
|
+
"TD002", # Missing author in TODO
|
|
170
|
+
"TD003", # Missing issue link for this TODO
|
|
200
171
|
# Conflicts with other rules
|
|
201
|
-
"D212",
|
|
202
|
-
"D203",
|
|
203
|
-
"D416",
|
|
172
|
+
"D212", # Multiline summary first line
|
|
173
|
+
"D203", # Blank lines before class docstrings
|
|
174
|
+
"D416", # Colon after after section titles
|
|
204
175
|
]
|
|
205
|
-
lint.select = [ "ALL" ]
|
|
206
176
|
lint.unfixable = [
|
|
207
177
|
"ERA", # do not autoremove commented out code
|
|
208
178
|
]
|
|
@@ -211,6 +181,7 @@ src = ["src", "tests"]
|
|
|
211
181
|
target-version = "py310"
|
|
212
182
|
|
|
213
183
|
[tool.ruff.lint.pylint]
|
|
184
|
+
extend-allow-magic-values = [2, 3]
|
|
214
185
|
max-statements = 100
|
|
215
186
|
max-branches = 20
|
|
216
187
|
|
|
@@ -218,9 +189,66 @@ max-branches = 20
|
|
|
218
189
|
ban-relative-imports = "all"
|
|
219
190
|
|
|
220
191
|
[tool.ruff.lint.per-file-ignores]
|
|
221
|
-
"
|
|
222
|
-
"
|
|
223
|
-
"
|
|
224
|
-
"
|
|
225
|
-
|
|
192
|
+
"src/build/**" = [
|
|
193
|
+
"INP001", # Not a namespace; just a folder to hold non-production files
|
|
194
|
+
"PLR2004", # Allow checking for specific numbers
|
|
195
|
+
"PTH", # Build scripts are find to use os instead of Path
|
|
196
|
+
]
|
|
197
|
+
"src/debug/**" = [
|
|
198
|
+
"INP001", # Not a namespace; just a folder to hold non-production files
|
|
199
|
+
"SLF001", # Debug internal data
|
|
200
|
+
"T201", # print() allowed in debug scripts
|
|
201
|
+
]
|
|
202
|
+
"tests/**" = [
|
|
203
|
+
"C901", # Allow complex test functions
|
|
204
|
+
"DTZ001", # Numbers stores data in UTC
|
|
205
|
+
"PLR0911", # Allow complex test functions (returns)
|
|
206
|
+
"PLR0912", # Allow complex test functions (branches)
|
|
207
|
+
"PLR2004", # Allow checking for specific numbers
|
|
208
|
+
"S101", # Allow assert in tests
|
|
209
|
+
"SLF001", # Tests need to access internal data for coverage
|
|
210
|
+
]
|
|
211
|
+
|
|
212
|
+
[tool.pylint."messages control"]
|
|
213
|
+
disable = [
|
|
214
|
+
# Pylint cannot infer dynamic protobuf fields or internal model relationships.
|
|
215
|
+
"attribute-defined-outside-init",
|
|
216
|
+
"no-member",
|
|
217
|
+
"no-name-in-module",
|
|
218
|
+
"protected-access",
|
|
219
|
+
"too-many-lines",
|
|
220
|
+
# These checks duplicate Ruff or flag established implementation patterns.
|
|
221
|
+
"duplicate-code",
|
|
222
|
+
"fixme",
|
|
223
|
+
"redefined-builtin",
|
|
224
|
+
"too-few-public-methods",
|
|
225
|
+
"too-many-arguments",
|
|
226
|
+
"too-many-boolean-expressions",
|
|
227
|
+
"too-many-branches",
|
|
228
|
+
"too-many-instance-attributes",
|
|
229
|
+
"too-many-locals",
|
|
230
|
+
"too-many-nested-blocks",
|
|
231
|
+
"too-many-positional-arguments",
|
|
232
|
+
"too-many-public-methods",
|
|
233
|
+
"too-many-return-statements",
|
|
234
|
+
"too-many-statements",
|
|
235
|
+
]
|
|
226
236
|
|
|
237
|
+
[tool.pylint.main]
|
|
238
|
+
ignored-modules = ["Cocoa", "lldb"]
|
|
239
|
+
|
|
240
|
+
[tool.mypy]
|
|
241
|
+
mypy_path = "src"
|
|
242
|
+
exclude = [
|
|
243
|
+
"src/numbers_parser/generated/",
|
|
244
|
+
"src/debug/lldbutil.py",
|
|
245
|
+
]
|
|
246
|
+
|
|
247
|
+
[[tool.mypy.overrides]]
|
|
248
|
+
module = [
|
|
249
|
+
"Cocoa",
|
|
250
|
+
"snappy",
|
|
251
|
+
"compact_json",
|
|
252
|
+
"sigfig",
|
|
253
|
+
]
|
|
254
|
+
ignore_missing_imports = true
|
|
@@ -6,6 +6,8 @@ import plistlib
|
|
|
6
6
|
import re
|
|
7
7
|
import warnings
|
|
8
8
|
|
|
9
|
+
from numbers_parser.constants import SUPPORTED_NUMBERS_VERSIONS
|
|
10
|
+
|
|
9
11
|
with warnings.catch_warnings():
|
|
10
12
|
# Protobuf
|
|
11
13
|
warnings.filterwarnings("ignore", category=DeprecationWarning)
|
|
@@ -22,26 +24,28 @@ _VERSION_PLIST_PATH = "Contents/version.plist"
|
|
|
22
24
|
|
|
23
25
|
|
|
24
26
|
def _get_version() -> str:
|
|
27
|
+
"""Return the version."""
|
|
25
28
|
return __version__
|
|
26
29
|
|
|
27
30
|
|
|
28
|
-
def _check_installed_numbers_version() -> str:
|
|
31
|
+
def _check_installed_numbers_version() -> str | None:
|
|
32
|
+
"""Check installed numbers version."""
|
|
29
33
|
try:
|
|
30
|
-
|
|
34
|
+
with open(
|
|
35
|
+
os.path.join(_DEFAULT_NUMBERS_INSTALL_PATH, _VERSION_PLIST_PATH),
|
|
36
|
+
"rb",
|
|
37
|
+
) as fp:
|
|
38
|
+
version_dict = plistlib.load(fp)
|
|
31
39
|
except OSError:
|
|
32
40
|
return None
|
|
33
|
-
version_dict = plistlib.load(fp)
|
|
34
41
|
installed_version = version_dict["CFBundleShortVersionString"]
|
|
35
42
|
|
|
36
|
-
from numbers_parser.constants import SUPPORTED_NUMBERS_VERSIONS
|
|
37
|
-
|
|
38
43
|
installed_version = re.sub(r"(\d+)\.(\d+)\.\d+", r"\1.\2", installed_version)
|
|
39
44
|
if installed_version not in SUPPORTED_NUMBERS_VERSIONS:
|
|
40
45
|
warnings.warn(
|
|
41
46
|
f"Numbers version {installed_version} not tested with this version",
|
|
42
47
|
stacklevel=2,
|
|
43
48
|
)
|
|
44
|
-
fp.close()
|
|
45
49
|
return installed_version
|
|
46
50
|
|
|
47
51
|
|
|
@@ -1,3 +1,7 @@
|
|
|
1
|
+
"""cat numbers module helpers."""
|
|
2
|
+
|
|
3
|
+
# ruff: noqa: T201
|
|
4
|
+
|
|
1
5
|
import argparse
|
|
2
6
|
import csv
|
|
3
7
|
import logging
|
|
@@ -6,6 +10,7 @@ import sys
|
|
|
6
10
|
from sigfig import round as sigfig
|
|
7
11
|
|
|
8
12
|
from numbers_parser import (
|
|
13
|
+
Cell,
|
|
9
14
|
Document,
|
|
10
15
|
ErrorCell,
|
|
11
16
|
FileError,
|
|
@@ -22,14 +27,16 @@ logger = logging.getLogger(numbers_parser_name)
|
|
|
22
27
|
|
|
23
28
|
|
|
24
29
|
def experimental_feature_choice(s: str) -> ExperimentalFeatures:
|
|
30
|
+
"""Parse an experimental feature name supplied on the command line."""
|
|
25
31
|
try:
|
|
26
32
|
return ExperimentalFeatures[s]
|
|
27
33
|
except KeyError:
|
|
28
34
|
msg = f"invalid experimental feature: {s}"
|
|
29
|
-
raise argparse.ArgumentTypeError(msg) # noqa: B904
|
|
35
|
+
raise argparse.ArgumentTypeError(msg) # noqa: B904 # pylint: disable=raise-missing-from
|
|
30
36
|
|
|
31
37
|
|
|
32
|
-
def command_line_parser():
|
|
38
|
+
def command_line_parser() -> argparse.ArgumentParser:
|
|
39
|
+
"""Create the argument parser for the cat-numbers command."""
|
|
33
40
|
parser = argparse.ArgumentParser(
|
|
34
41
|
description="Export data from Apple Numbers spreadsheet tables",
|
|
35
42
|
)
|
|
@@ -85,25 +92,28 @@ def command_line_parser():
|
|
|
85
92
|
parser.add_argument(
|
|
86
93
|
"--experimental",
|
|
87
94
|
type=experimental_feature_choice,
|
|
88
|
-
choices=[ExperimentalFeatures[name] for name in experimental_choices],
|
|
95
|
+
choices=[ExperimentalFeatures[str(name)] for name in experimental_choices],
|
|
89
96
|
help=argparse.SUPPRESS,
|
|
90
97
|
)
|
|
91
98
|
return parser
|
|
92
99
|
|
|
93
100
|
|
|
94
|
-
def print_sheet_names(filename, password) -> None:
|
|
95
|
-
|
|
101
|
+
def print_sheet_names(filename: str, password: str | None) -> None:
|
|
102
|
+
"""Print sheet names."""
|
|
103
|
+
for sheet in Document(filename, password=password).sheets: # type: ignore[attr-defined]
|
|
96
104
|
print(f"{filename}: {sheet.name}")
|
|
97
105
|
|
|
98
106
|
|
|
99
|
-
def print_table_names(filename, password) -> None:
|
|
100
|
-
|
|
107
|
+
def print_table_names(filename: str, password: str | None) -> None:
|
|
108
|
+
"""Print table names."""
|
|
109
|
+
for sheet in Document(filename, password=password).sheets: # type: ignore[attr-defined]
|
|
101
110
|
for table in sheet.tables:
|
|
102
111
|
print(f"{filename}: {sheet.name}: {table.name}")
|
|
103
112
|
|
|
104
113
|
|
|
105
|
-
def cell_as_string(args, cell):
|
|
106
|
-
|
|
114
|
+
def cell_as_string(args: argparse.Namespace, cell: Cell) -> str:
|
|
115
|
+
"""Return the cell as string."""
|
|
116
|
+
if isinstance(cell, ErrorCell) and not args.formulas:
|
|
107
117
|
return "#REF!"
|
|
108
118
|
if args.formulas and cell.formula is not None:
|
|
109
119
|
return cell.formula
|
|
@@ -111,14 +121,19 @@ def cell_as_string(args, cell):
|
|
|
111
121
|
return cell.formatted_value
|
|
112
122
|
if isinstance(cell, NumberCell):
|
|
113
123
|
return sigfig(cell.value, sigfigs=MAX_SIGNIFICANT_DIGITS, warn=False)
|
|
114
|
-
if cell
|
|
124
|
+
if getattr(cell, "value", None) is None:
|
|
115
125
|
return ""
|
|
116
|
-
return str(cell
|
|
126
|
+
return str(getattr(cell, "value", ""))
|
|
117
127
|
|
|
118
128
|
|
|
119
|
-
def print_table(
|
|
129
|
+
def print_table(
|
|
130
|
+
args: argparse.Namespace,
|
|
131
|
+
filename: str,
|
|
132
|
+
password: str | None,
|
|
133
|
+
) -> None:
|
|
134
|
+
"""Print table."""
|
|
120
135
|
writer = csv.writer(sys.stdout, dialect="excel")
|
|
121
|
-
for sheet in Document(filename, password=password).sheets:
|
|
136
|
+
for sheet in Document(filename, password=password).sheets: # type: ignore[attr-defined]
|
|
122
137
|
if args.sheet is not None and sheet.name not in args.sheet:
|
|
123
138
|
continue
|
|
124
139
|
for table in sheet.tables:
|
|
@@ -132,6 +147,7 @@ def print_table(args, filename, password) -> None:
|
|
|
132
147
|
|
|
133
148
|
|
|
134
149
|
def main() -> None:
|
|
150
|
+
"""Run the command-line operation."""
|
|
135
151
|
parser = command_line_parser()
|
|
136
152
|
args = parser.parse_args()
|
|
137
153
|
|