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.
Files changed (143) hide show
  1. {numbers_parser-4.22.0/src/numbers_parser.egg-info → numbers_parser-4.23.0}/PKG-INFO +8 -9
  2. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/README.md +5 -6
  3. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/pyproject.toml +99 -71
  4. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/__init__.py +10 -6
  5. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/_cat_numbers.py +29 -13
  6. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/_csv2numbers.py +71 -71
  7. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/_unpack_numbers.py +66 -41
  8. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/bullets.py +1 -0
  9. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/cell.py +517 -299
  10. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/constants.py +49 -6
  11. numbers_parser-4.23.0/src/numbers_parser/containers.py +262 -0
  12. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/currencies.py +1 -0
  13. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/document.py +411 -137
  14. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/exceptions.py +4 -1
  15. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/experimental.py +9 -2
  16. numbers_parser-4.23.0/src/numbers_parser/formula.py +429 -0
  17. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNArchives_pb2.py +42 -42
  18. numbers_parser-4.23.0/src/numbers_parser/generated/TNArchives_pb2.pyi +906 -0
  19. numbers_parser-4.23.0/src/numbers_parser/generated/TNArchives_sos_pb2.pyi +48 -0
  20. numbers_parser-4.23.0/src/numbers_parser/generated/TNCommandArchives_pb2.pyi +1335 -0
  21. numbers_parser-4.23.0/src/numbers_parser/generated/TNCommandArchives_sos_pb2.pyi +69 -0
  22. numbers_parser-4.23.0/src/numbers_parser/generated/TSAArchives_pb2.pyi +1285 -0
  23. numbers_parser-4.23.0/src/numbers_parser/generated/TSAArchives_sos_pb2.pyi +88 -0
  24. numbers_parser-4.23.0/src/numbers_parser/generated/TSACommandArchives_sos_pb2.pyi +226 -0
  25. numbers_parser-4.23.0/src/numbers_parser/generated/TSCEArchives_pb2.pyi +4697 -0
  26. numbers_parser-4.23.0/src/numbers_parser/generated/TSCH3DArchives_pb2.pyi +753 -0
  27. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_Common_pb2.pyi +571 -0
  28. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_GEN_pb2.pyi +2124 -0
  29. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_pb2.pyi +1197 -0
  30. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHArchives_sos_pb2.pyi +3001 -0
  31. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHCommandArchives_pb2.pyi +1848 -0
  32. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHPreUFFArchives_pb2.py +68 -0
  33. numbers_parser-4.23.0/src/numbers_parser/generated/TSCHPreUFFArchives_pb2.pyi +1491 -0
  34. numbers_parser-4.23.0/src/numbers_parser/generated/TSCKArchives_pb2.pyi +1788 -0
  35. numbers_parser-4.23.0/src/numbers_parser/generated/TSCKArchives_sos_pb2.pyi +95 -0
  36. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDArchives_pb2.py +83 -81
  37. numbers_parser-4.23.0/src/numbers_parser/generated/TSDArchives_pb2.pyi +2886 -0
  38. numbers_parser-4.23.0/src/numbers_parser/generated/TSDArchives_sos_pb2.pyi +395 -0
  39. numbers_parser-4.23.0/src/numbers_parser/generated/TSDCommandArchives_pb2.pyi +2015 -0
  40. numbers_parser-4.23.0/src/numbers_parser/generated/TSKArchives_pb2.py +161 -0
  41. numbers_parser-4.23.0/src/numbers_parser/generated/TSKArchives_pb2.pyi +1850 -0
  42. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPArchiveMessages_pb2.py +32 -32
  43. numbers_parser-4.23.0/src/numbers_parser/generated/TSPArchiveMessages_pb2.pyi +1013 -0
  44. numbers_parser-4.23.0/src/numbers_parser/generated/TSPDatabaseMessages_pb2.pyi +112 -0
  45. numbers_parser-4.23.0/src/numbers_parser/generated/TSPMessages_pb2.pyi +1220 -0
  46. numbers_parser-4.23.0/src/numbers_parser/generated/TSSArchives_pb2.py +74 -0
  47. numbers_parser-4.23.0/src/numbers_parser/generated/TSSArchives_pb2.pyi +696 -0
  48. numbers_parser-4.23.0/src/numbers_parser/generated/TSSArchives_sos_pb2.pyi +229 -0
  49. numbers_parser-4.23.0/src/numbers_parser/generated/TSTArchives_pb2.pyi +6084 -0
  50. numbers_parser-4.23.0/src/numbers_parser/generated/TSTArchives_sos_pb2.pyi +572 -0
  51. numbers_parser-4.23.0/src/numbers_parser/generated/TSTCommandArchives_pb2.pyi +3998 -0
  52. numbers_parser-4.23.0/src/numbers_parser/generated/TSTStylePropertyArchiving_pb2.pyi +620 -0
  53. numbers_parser-4.23.0/src/numbers_parser/generated/TSWPArchives_pb2.pyi +3732 -0
  54. numbers_parser-4.23.0/src/numbers_parser/generated/TSWPArchives_sos_pb2.pyi +1817 -0
  55. numbers_parser-4.23.0/src/numbers_parser/generated/TSWPCommandArchives_pb2.pyi +1580 -0
  56. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/fontmap.py +187 -180
  57. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/iwafile.py +170 -79
  58. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/iwork.py +94 -51
  59. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/model.py +970 -600
  60. numbers_parser-4.23.0/src/numbers_parser/numbers_cache.py +74 -0
  61. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/numbers_uuid.py +23 -6
  62. numbers_parser-4.23.0/src/numbers_parser/py.typed +0 -0
  63. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/roman.py +4 -1
  64. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/xrefs.py +248 -148
  65. {numbers_parser-4.22.0 → numbers_parser-4.23.0/src/numbers_parser.egg-info}/PKG-INFO +8 -9
  66. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/SOURCES.txt +36 -2
  67. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/requires.txt +1 -1
  68. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_all_formulas.py +42 -16
  69. numbers_parser-4.23.0/tests/test_api_change.py +45 -0
  70. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_borders.py +126 -64
  71. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_bullets.py +31 -10
  72. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_cat_numbers.py +43 -22
  73. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_categories.py +70 -16
  74. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_comments.py +16 -7
  75. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_coverage.py +122 -66
  76. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_create_cells.py +19 -17
  77. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_csv2numbers.py +16 -14
  78. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_currency.py +4 -1
  79. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_encrypted.py +75 -25
  80. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_folder.py +4 -1
  81. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_formatting.py +90 -44
  82. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_formulas.py +23 -11
  83. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_issues.py +316 -169
  84. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_large.py +20 -11
  85. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_local_docs.py +20 -46
  86. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_memory_leaks.py +5 -1
  87. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_merges.py +16 -10
  88. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_package.py +16 -6
  89. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_properties.py +6 -2
  90. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_roman.py +6 -5
  91. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_save.py +32 -21
  92. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_slices.py +49 -25
  93. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_styles.py +173 -126
  94. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_table_size.py +32 -24
  95. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_tables.py +35 -19
  96. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_unpack_numbers.py +74 -24
  97. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_unsupported.py +4 -1
  98. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_uuids.py +16 -8
  99. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/tests/test_version.py +19 -6
  100. numbers_parser-4.22.0/src/numbers_parser/containers.py +0 -174
  101. numbers_parser-4.22.0/src/numbers_parser/formula.py +0 -283
  102. numbers_parser-4.22.0/src/numbers_parser/generated/TSKArchives_pb2.py +0 -161
  103. numbers_parser-4.22.0/src/numbers_parser/generated/TSSArchives_pb2.py +0 -74
  104. numbers_parser-4.22.0/src/numbers_parser/numbers_cache.py +0 -39
  105. numbers_parser-4.22.0/tests/test_api_change.py +0 -28
  106. numbers_parser-4.22.0/tests/test_write_empty_cell.py +0 -25
  107. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/LICENSE.rst +0 -0
  108. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/setup.cfg +0 -0
  109. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/data/empty.numbers +0 -0
  110. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNArchives_sos_pb2.py +0 -0
  111. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNCommandArchives_pb2.py +0 -0
  112. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNCommandArchives_sos_pb2.py +0 -0
  113. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSAArchives_pb2.py +0 -0
  114. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSAArchives_sos_pb2.py +0 -0
  115. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSACommandArchives_sos_pb2.py +0 -0
  116. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCEArchives_pb2.py +0 -0
  117. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCH3DArchives_pb2.py +0 -0
  118. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_Common_pb2.py +0 -0
  119. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_GEN_pb2.py +0 -0
  120. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_pb2.py +0 -0
  121. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_sos_pb2.py +0 -0
  122. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHCommandArchives_pb2.py +0 -0
  123. /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
  124. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCKArchives_pb2.py +0 -0
  125. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCKArchives_sos_pb2.py +0 -0
  126. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDArchives_sos_pb2.py +0 -0
  127. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDCommandArchives_pb2.py +0 -0
  128. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPDatabaseMessages_pb2.py +0 -0
  129. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPMessages_pb2.py +0 -0
  130. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSSArchives_sos_pb2.py +0 -0
  131. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTArchives_pb2.py +0 -0
  132. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTArchives_sos_pb2.py +0 -0
  133. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTCommandArchives_pb2.py +0 -0
  134. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTStylePropertyArchiving_pb2.py +0 -0
  135. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPArchives_pb2.py +0 -0
  136. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPArchives_sos_pb2.py +0 -0
  137. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPCommandArchives_pb2.py +0 -0
  138. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/__init__.py +0 -0
  139. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/functionmap.py +0 -0
  140. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser/generated/mapping.py +0 -0
  141. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/dependency_links.txt +0 -0
  142. {numbers_parser-4.22.0 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/entry_points.txt +0 -0
  143. {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.22.0
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.10
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>=2.9.0.post0
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
  [![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)
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.4 (the last version of Numbers) and Numbers Creator Studio up to version 15.1, which the most current as of February 2026.
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.10 onwards. It is not compatible with earlier versions of Python.
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] [--rename COLUMNS-MAP]
317
- [--transform COLUMNS-MAP] [--delete COLUMNS]
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
  [![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)
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.4 (the last version of Numbers) and Numbers Creator Studio up to version 15.1, which the most current as of February 2026.
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.10 onwards. It is not compatible with earlier versions of Python.
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] [--rename COLUMNS-MAP]
291
- [--transform COLUMNS-MAP] [--delete COLUMNS]
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.10"
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>=2.9.0.post0",
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.22.0"
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<9.0,>=7.3",
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>=12.3.0",
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
- "pragma: no cover",
109
- "raise NotImplementedError",
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 = ["py310", "py311", "py312", "py313", "py314", "py315"]
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
- "T201", # Allow print()
150
- # To fix:
151
- "ANN001", # Missing type annotation
152
- "ANN002", # Missing type annotation
153
- "ANN003", # Missing type annotation
154
- "ANN201", # Missing return type annotation
155
- "ANN202", # Missing return type annotation
156
- "ANN204", # Missing return type annotation
157
- "ANN205", # Missing return type annotation
158
- "ANN206", # Missing return type annotation
159
- "ANN401", # Dynamically typed expressions
160
- "ARG001", # Unused function argument
161
- "ARG002", # Unused method argument
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", # Multiline summary first line
202
- "D203", # Blank lines before class docstrings
203
- "D416", # Colon after after section titles
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
- "docs/conf.py" = ["INP001"]
222
- "src/build/**" = ["PLR2004", "INP001", "PTH"]
223
- "src/build/protodump.py" = ["PLR2004", "INP001", "PTH", "S110", "N806"]
224
- "src/debug/**" = ["INP001"]
225
- "tests/**" = ["PLR2004", "S101", "D103", "ANN201", "ANN001", "DTZ001"]
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
- fp = open(os.path.join(_DEFAULT_NUMBERS_INSTALL_PATH, _VERSION_PLIST_PATH), "rb")
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
- for sheet in Document(filename, password=password).sheets:
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
- for sheet in Document(filename, password=password).sheets:
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
- if isinstance(cell, ErrorCell) and not (args.formulas):
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.value is None:
124
+ if getattr(cell, "value", None) is None:
115
125
  return ""
116
- return str(cell.value)
126
+ return str(getattr(cell, "value", ""))
117
127
 
118
128
 
119
- def print_table(args, filename, password) -> None:
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