numbers-parser 4.22.2__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.2/src/numbers_parser.egg-info → numbers_parser-4.23.0}/PKG-INFO +5 -5
  2. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/README.md +2 -2
  3. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/pyproject.toml +97 -71
  4. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/__init__.py +10 -6
  5. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/_cat_numbers.py +29 -13
  6. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/_csv2numbers.py +71 -71
  7. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/_unpack_numbers.py +59 -42
  8. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/bullets.py +1 -0
  9. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/cell.py +499 -277
  10. {numbers_parser-4.22.2 → 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.2 → numbers_parser-4.23.0}/src/numbers_parser/currencies.py +1 -0
  13. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/document.py +404 -137
  14. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/exceptions.py +4 -1
  15. {numbers_parser-4.22.2 → 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.2 → 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.2 → 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.2 → 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.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/fontmap.py +187 -180
  57. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/iwafile.py +170 -79
  58. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/iwork.py +93 -50
  59. {numbers_parser-4.22.2 → 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.2 → 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.2 → numbers_parser-4.23.0}/src/numbers_parser/roman.py +4 -1
  64. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/xrefs.py +248 -148
  65. {numbers_parser-4.22.2 → numbers_parser-4.23.0/src/numbers_parser.egg-info}/PKG-INFO +5 -5
  66. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/SOURCES.txt +36 -2
  67. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/requires.txt +1 -1
  68. {numbers_parser-4.22.2 → 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.2 → numbers_parser-4.23.0}/tests/test_borders.py +126 -64
  71. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_bullets.py +31 -10
  72. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_cat_numbers.py +43 -22
  73. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_categories.py +70 -16
  74. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_comments.py +16 -7
  75. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_coverage.py +122 -66
  76. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_create_cells.py +19 -17
  77. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_csv2numbers.py +16 -14
  78. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_currency.py +4 -1
  79. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_encrypted.py +75 -25
  80. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_folder.py +4 -1
  81. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_formatting.py +65 -46
  82. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_formulas.py +23 -11
  83. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_issues.py +310 -170
  84. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_large.py +20 -11
  85. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_local_docs.py +20 -46
  86. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_memory_leaks.py +5 -1
  87. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_merges.py +16 -10
  88. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_package.py +16 -6
  89. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_properties.py +6 -2
  90. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_roman.py +6 -5
  91. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_save.py +32 -21
  92. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_slices.py +49 -25
  93. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_styles.py +173 -126
  94. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_table_size.py +32 -24
  95. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_tables.py +35 -19
  96. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_unpack_numbers.py +45 -24
  97. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_unsupported.py +4 -1
  98. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_uuids.py +16 -8
  99. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/tests/test_version.py +19 -6
  100. numbers_parser-4.22.2/src/numbers_parser/containers.py +0 -174
  101. numbers_parser-4.22.2/src/numbers_parser/formula.py +0 -283
  102. numbers_parser-4.22.2/src/numbers_parser/generated/TSKArchives_pb2.py +0 -161
  103. numbers_parser-4.22.2/src/numbers_parser/generated/TSSArchives_pb2.py +0 -74
  104. numbers_parser-4.22.2/src/numbers_parser/numbers_cache.py +0 -39
  105. numbers_parser-4.22.2/tests/test_api_change.py +0 -28
  106. numbers_parser-4.22.2/tests/test_write_empty_cell.py +0 -25
  107. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/LICENSE.rst +0 -0
  108. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/setup.cfg +0 -0
  109. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/data/empty.numbers +0 -0
  110. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNArchives_sos_pb2.py +0 -0
  111. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNCommandArchives_pb2.py +0 -0
  112. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TNCommandArchives_sos_pb2.py +0 -0
  113. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSAArchives_pb2.py +0 -0
  114. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSAArchives_sos_pb2.py +0 -0
  115. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSACommandArchives_sos_pb2.py +0 -0
  116. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCEArchives_pb2.py +0 -0
  117. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCH3DArchives_pb2.py +0 -0
  118. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_Common_pb2.py +0 -0
  119. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_GEN_pb2.py +0 -0
  120. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_pb2.py +0 -0
  121. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHArchives_sos_pb2.py +0 -0
  122. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCHCommandArchives_pb2.py +0 -0
  123. /numbers_parser-4.22.2/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.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCKArchives_pb2.py +0 -0
  125. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSCKArchives_sos_pb2.py +0 -0
  126. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDArchives_sos_pb2.py +0 -0
  127. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSDCommandArchives_pb2.py +0 -0
  128. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPDatabaseMessages_pb2.py +0 -0
  129. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSPMessages_pb2.py +0 -0
  130. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSSArchives_sos_pb2.py +0 -0
  131. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTArchives_pb2.py +0 -0
  132. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTArchives_sos_pb2.py +0 -0
  133. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTCommandArchives_pb2.py +0 -0
  134. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSTStylePropertyArchiving_pb2.py +0 -0
  135. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPArchives_pb2.py +0 -0
  136. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPArchives_sos_pb2.py +0 -0
  137. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/TSWPCommandArchives_pb2.py +0 -0
  138. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/__init__.py +0 -0
  139. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/functionmap.py +0 -0
  140. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser/generated/mapping.py +0 -0
  141. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/dependency_links.txt +0 -0
  142. {numbers_parser-4.22.2 → numbers_parser-4.23.0}/src/numbers_parser.egg-info/entry_points.txt +0 -0
  143. {numbers_parser-4.22.2 → 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.2
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
 
@@ -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
 
@@ -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.2"
27
+ version = "4.23.0"
28
28
 
29
29
  [project.urls]
30
30
  repository = "https://github.com/masaccio/numbers-parser"
@@ -49,10 +49,12 @@ dev = [
49
49
  "colorama<1.0.0,>=0.4.6",
50
50
  "pympler<2.0,>=1.1",
51
51
  "pre-commit>=4.6.2",
52
+ "pylint>=4.1.3",
53
+ "mypy>=2.4.1",
54
+ "types-protobuf>=7.35.1.20260906",
52
55
  ]
53
56
  docs = [
54
- "sphinx<9.0,>=7.3",
55
- "enum-tools>=0.11",
57
+ "sphinx>=7.3,<10.0",
56
58
  "sphinx-toolbox>=3.5",
57
59
  "sphinx-nefertiti>=0.7",
58
60
  "sphinx-markdown-builder>=0.6",
@@ -75,10 +77,11 @@ bootstrap = [
75
77
  "pyobjc-core>=12.0",
76
78
  "pyobjc-framework-Cocoa>=10.2",
77
79
  "py2app>=0.28",
80
+ "mypy-protobuf>=5.1.0",
78
81
  ]
79
82
  visualcheck = [
80
83
  "osascript>=0.0.27",
81
- "pillow>=12.3.0",
84
+ "pillow>=13.0.0",
82
85
  "pixelmatch>=0.4.0",
83
86
  "pymupdf>=1.28.2",
84
87
  "rich>=15.0.0",
@@ -95,7 +98,7 @@ exclude = ["*tests*", "numbers_parser.data"]
95
98
  namespaces = false # disable scanning PEP 420 namespaces
96
99
 
97
100
  [tool.setuptools.package-data]
98
- "numbers_parser" = ["data/*"]
101
+ "numbers_parser" = ["data/*", "py.typed"]
99
102
 
100
103
  [tool.coverage.run]
101
104
  branch = true
@@ -107,8 +110,10 @@ show_contexts = false
107
110
 
108
111
  [tool.coverage.report]
109
112
  exclude_lines = [
110
- "pragma: no cover",
111
- "raise NotImplementedError",
113
+ "overload",
114
+ "pragma: no cover",
115
+ "raise NotImplementedError",
116
+ "TYPE_CHECKING",
112
117
  ]
113
118
 
114
119
  [tool.pytest.ini_options]
@@ -116,7 +121,7 @@ addopts = "--cov=src/numbers_parser --cov-report=html --cov-report=term-missing:
116
121
 
117
122
  [tool.tox]
118
123
  requires = ["tox>=4.0"]
119
- env_list = ["py310", "py311", "py312", "py313", "py314", "py315"]
124
+ env_list = ["py311", "py312", "py313", "py314", "py315"]
120
125
 
121
126
  [tool.tox.env_run_base]
122
127
  deps = [
@@ -130,7 +135,7 @@ deps = [
130
135
  "colorama"
131
136
  ]
132
137
  commands = [
133
- ["pytest", "tests/", "--import-mode", "importlib", "-n", "logical", "--no-cov"]
138
+ ["pytest", "-qq", "tests/", "--import-mode", "importlib", "-n", "logical", "--no-cov"]
134
139
  ]
135
140
 
136
141
  [tool.isort]
@@ -145,66 +150,29 @@ exclude = [
145
150
  "**/src/numbers_parser/generated/*",
146
151
  # Third-party files not to lint
147
152
  "**/src/debug/lldbutil.py",
153
+ "**/src/build/protodump.py",
148
154
  ]
149
155
  fix = true
156
+ lint.select = [ "ALL" ]
150
157
  lint.ignore = [
151
- "T201", # Allow print()
152
- # To fix:
153
- "ANN001", # Missing type annotation
154
- "ANN002", # Missing type annotation
155
- "ANN003", # Missing type annotation
156
- "ANN201", # Missing return type annotation
157
- "ANN202", # Missing return type annotation
158
- "ANN204", # Missing return type annotation
159
- "ANN205", # Missing return type annotation
160
- "ANN206", # Missing return type annotation
161
- "ANN401", # Dynamically typed expressions
162
- "ARG001", # Unused function argument
163
- "ARG002", # Unused method argument
164
- "ARG003", # Unused class method argument
165
- "BLE001", # Do not catch blind exception
166
- "CPY001", # Copyright
167
- "COM812", # Conflicts
168
- "C901", # Code too complex
169
- "D100", # Missing docstring
170
- "D101", # Missing docstring
171
- "D102", # Missing docstring
172
- "D103", # Missing docstring
173
- "D105", # Missing docstring
174
- "D107", # Missing docstring
175
- "D205", # Blank line - conflicts with black
176
- "D210", # No whitespaces allowed surrounding docstring text
177
- "D400", # First line should end with a period
178
- "D401", # First line of docstring should be in imperative mood
179
- "D415", # First line should end with a period, question mark, or exclamation point
180
- "E501", # Line too long
181
- "ERA001", #  Remove commented out code
182
- "FBT001", # Boolean-typed positional argument in function definition
183
- "FBT002", # Boolean default positional argument in function definition
184
- "FBT003", # Boolean positional value in function call
185
- "FIX002", # Line contains TODO, consider resolving the issue
186
- "ISC003", # Explicitly concatenated string should be implicitly concatenated
187
- "PERF401", # Use a list comprehension to create a transformed list
188
- "PLR0913", # Too many arguments
189
- "PLR2004", # Magic value used
190
- "PLW0603", # Using the global statement
191
- "PTH103", # Use of os.makedirs()
192
- "PTH118", # Use of os.path.join()
193
- "PTH119", # Use of os.path.basename()
194
- "PTH123", # Use of open()
195
- "RUF001", # String contains ambiguous
196
- "RUF002", # Docstring contains ambiguous
197
- "RUF003", # Comment contains ambiguous
198
- "SIM115", # Use a context manager for opening files
199
- "SLF001", # Private member accessed
200
- "TD002", # TODO author
201
- "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
202
171
  # Conflicts with other rules
203
- "D212", # Multiline summary first line
204
- "D203", # Blank lines before class docstrings
205
- "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
206
175
  ]
207
- lint.select = [ "ALL" ]
208
176
  lint.unfixable = [
209
177
  "ERA", # do not autoremove commented out code
210
178
  ]
@@ -213,6 +181,7 @@ src = ["src", "tests"]
213
181
  target-version = "py310"
214
182
 
215
183
  [tool.ruff.lint.pylint]
184
+ extend-allow-magic-values = [2, 3]
216
185
  max-statements = 100
217
186
  max-branches = 20
218
187
 
@@ -220,9 +189,66 @@ max-branches = 20
220
189
  ban-relative-imports = "all"
221
190
 
222
191
  [tool.ruff.lint.per-file-ignores]
223
- "docs/conf.py" = ["INP001"]
224
- "src/build/**" = ["PLR2004", "INP001", "PTH"]
225
- "src/build/protodump.py" = ["PLR2004", "INP001", "PTH", "S110", "N806"]
226
- "src/debug/**" = ["INP001"]
227
- "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
+ ]
228
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