PyStormTracker 0.5.0__tar.gz → 0.8.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 (294) hide show
  1. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/.dockerignore +1 -2
  2. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/.gitattributes +2 -5
  3. pystormtracker-0.8.0/.github/dependabot.yml +36 -0
  4. pystormtracker-0.8.0/.github/pull_request_template.md +17 -0
  5. pystormtracker-0.8.0/.github/workflows/ci.yml +526 -0
  6. pystormtracker-0.8.0/.github/workflows/dependency-review.yml +19 -0
  7. pystormtracker-0.8.0/.github/workflows/docker-build.yml +214 -0
  8. pystormtracker-0.8.0/.github/workflows/docker-publish.yml +167 -0
  9. pystormtracker-0.8.0/.github/workflows/python-publish.yml +123 -0
  10. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/.gitignore +2 -2
  11. pystormtracker-0.8.0/.pre-commit-config.yaml +57 -0
  12. pystormtracker-0.8.0/.python-version +1 -0
  13. pystormtracker-0.8.0/.readthedocs.yaml +25 -0
  14. pystormtracker-0.8.0/.zenodo.json +36 -0
  15. pystormtracker-0.8.0/AGENTS.md +153 -0
  16. pystormtracker-0.8.0/CITATION.cff +108 -0
  17. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/CONTRIBUTING.md +46 -20
  18. pystormtracker-0.8.0/Dockerfile +52 -0
  19. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/LICENSE +1 -1
  20. pystormtracker-0.8.0/PKG-INFO +144 -0
  21. pystormtracker-0.8.0/README.md +90 -0
  22. pystormtracker-0.8.0/codecov.yml +20 -0
  23. pystormtracker-0.8.0/docs/_static/explorer.png +0 -0
  24. pystormtracker-0.8.0/docs/_static/layout.css +25 -0
  25. pystormtracker-0.8.0/docs/algorithms.md +9 -0
  26. pystormtracker-0.8.0/docs/api.md +258 -0
  27. pystormtracker-0.8.0/docs/architecture.md +316 -0
  28. pystormtracker-0.8.0/docs/benchmark.md +71 -0
  29. pystormtracker-0.8.0/docs/changelog.md +246 -0
  30. pystormtracker-0.8.0/docs/cli.md +162 -0
  31. pystormtracker-0.8.0/docs/conf.py +106 -0
  32. pystormtracker-0.8.0/docs/development/testing.md +84 -0
  33. pystormtracker-0.8.0/docs/development.md +11 -0
  34. pystormtracker-0.8.0/docs/healpix.md +129 -0
  35. pystormtracker-0.8.0/docs/hodges.md +612 -0
  36. pystormtracker-0.8.0/docs/index.md +18 -0
  37. pystormtracker-0.8.0/docs/puppeteer-config.json +3 -0
  38. pystormtracker-0.8.0/docs/quickstart.md +251 -0
  39. pystormtracker-0.8.0/docs/reference.md +10 -0
  40. pystormtracker-0.8.0/docs/roadmap.md +84 -0
  41. pystormtracker-0.8.0/docs/trackjson.md +249 -0
  42. pystormtracker-0.8.0/pyproject.toml +193 -0
  43. pystormtracker-0.8.0/scripts/generate_trackjson_schema.py +53 -0
  44. pystormtracker-0.8.0/src/pystormtracker/__init__.py +31 -0
  45. pystormtracker-0.8.0/src/pystormtracker/backends.py +357 -0
  46. pystormtracker-0.8.0/src/pystormtracker/cli.py +117 -0
  47. pystormtracker-0.8.0/src/pystormtracker/compare.py +208 -0
  48. pystormtracker-0.8.0/src/pystormtracker/convert.py +118 -0
  49. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/src/pystormtracker/healpix/__init__.py +4 -0
  50. pystormtracker-0.8.0/src/pystormtracker/healpix/constants.py +15 -0
  51. pystormtracker-0.8.0/src/pystormtracker/healpix/detector.py +565 -0
  52. pystormtracker-0.8.0/src/pystormtracker/healpix/tracker.py +747 -0
  53. pystormtracker-0.8.0/src/pystormtracker/hodges/__init__.py +7 -0
  54. pystormtracker-0.8.0/src/pystormtracker/hodges/constants.py +45 -0
  55. pystormtracker-0.8.0/src/pystormtracker/hodges/detections.py +121 -0
  56. pystormtracker-0.8.0/src/pystormtracker/hodges/detector.py +2095 -0
  57. pystormtracker-0.8.0/src/pystormtracker/hodges/linker.py +1232 -0
  58. pystormtracker-0.8.0/src/pystormtracker/hodges/mge.py +879 -0
  59. pystormtracker-0.8.0/src/pystormtracker/hodges/progress.py +398 -0
  60. pystormtracker-0.8.0/src/pystormtracker/hodges/rsplice.py +100 -0
  61. pystormtracker-0.8.0/src/pystormtracker/hodges/segments.py +364 -0
  62. pystormtracker-0.8.0/src/pystormtracker/hodges/tracker.py +1151 -0
  63. pystormtracker-0.8.0/src/pystormtracker/io/__init__.py +21 -0
  64. pystormtracker-0.8.0/src/pystormtracker/io/data_loader.py +515 -0
  65. pystormtracker-0.8.0/src/pystormtracker/io/format.py +170 -0
  66. pystormtracker-0.8.0/src/pystormtracker/io/imilast.py +120 -0
  67. pystormtracker-0.8.0/src/pystormtracker/io/track.py +254 -0
  68. pystormtracker-0.8.0/src/pystormtracker/io/trackjson.py +738 -0
  69. pystormtracker-0.8.0/src/pystormtracker/metrics/__init__.py +19 -0
  70. pystormtracker-0.8.0/src/pystormtracker/metrics/compare.py +1035 -0
  71. pystormtracker-0.8.0/src/pystormtracker/metrics/cross_validation.py +386 -0
  72. pystormtracker-0.8.0/src/pystormtracker/metrics/eulerian.py +169 -0
  73. pystormtracker-0.8.0/src/pystormtracker/metrics/lagrangian.py +606 -0
  74. pystormtracker-0.8.0/src/pystormtracker/metrics/weighting.py +79 -0
  75. pystormtracker-0.8.0/src/pystormtracker/models/__init__.py +28 -0
  76. pystormtracker-0.8.0/src/pystormtracker/models/_cftime.py +98 -0
  77. pystormtracker-0.8.0/src/pystormtracker/models/center.py +43 -0
  78. pystormtracker-0.8.0/src/pystormtracker/models/geo.py +239 -0
  79. pystormtracker-0.8.0/src/pystormtracker/models/time.py +400 -0
  80. pystormtracker-0.8.0/src/pystormtracker/models/tracker.py +46 -0
  81. pystormtracker-0.8.0/src/pystormtracker/models/tracks.py +763 -0
  82. pystormtracker-0.8.0/src/pystormtracker/models/units.py +133 -0
  83. pystormtracker-0.8.0/src/pystormtracker/preprocessing/__init__.py +18 -0
  84. pystormtracker-0.8.0/src/pystormtracker/preprocessing/kinematics.py +464 -0
  85. pystormtracker-0.8.0/src/pystormtracker/preprocessing/regrid.py +521 -0
  86. pystormtracker-0.8.0/src/pystormtracker/preprocessing/spectral.py +803 -0
  87. pystormtracker-0.8.0/src/pystormtracker/preprocessing/spherical_geometry.py +128 -0
  88. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/src/pystormtracker/preprocessing/taper.py +12 -13
  89. pystormtracker-0.8.0/src/pystormtracker/preprocessing/tracking.py +358 -0
  90. pystormtracker-0.8.0/src/pystormtracker/refinement/__init__.py +43 -0
  91. pystormtracker-0.8.0/src/pystormtracker/refinement/bspline.py +2148 -0
  92. pystormtracker-0.8.0/src/pystormtracker/refinement/quadratic.py +929 -0
  93. pystormtracker-0.8.0/src/pystormtracker/sample.py +345 -0
  94. pystormtracker-0.8.0/src/pystormtracker/schemas/__init__.py +5 -0
  95. pystormtracker-0.8.0/src/pystormtracker/schemas/generate.py +34 -0
  96. pystormtracker-0.8.0/src/pystormtracker/schemas/trackjson.schema.json +511 -0
  97. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/src/pystormtracker/simple/__init__.py +4 -0
  98. pystormtracker-0.8.0/src/pystormtracker/simple/constants.py +18 -0
  99. pystormtracker-0.8.0/src/pystormtracker/simple/detector.py +515 -0
  100. pystormtracker-0.8.0/src/pystormtracker/simple/linker.py +217 -0
  101. pystormtracker-0.8.0/src/pystormtracker/simple/tracker.py +639 -0
  102. pystormtracker-0.8.0/src/pystormtracker/track.py +780 -0
  103. pystormtracker-0.8.0/src/pystormtracker/utils/cli.py +86 -0
  104. pystormtracker-0.8.0/src/pystormtracker/utils/docs.py +26 -0
  105. pystormtracker-0.8.0/src/pystormtracker/utils/logging.py +128 -0
  106. pystormtracker-0.8.0/tests/__init__.py +3 -0
  107. pystormtracker-0.8.0/tests/conftest.py +30 -0
  108. pystormtracker-0.8.0/tests/data/era5/era5_msl_2025-12_2.5x2.5.nc +0 -0
  109. pystormtracker-0.8.0/tests/data/ncl/era5_msl_2025-12-01_0000_2.5x2.5_t5-42.nc +0 -0
  110. pystormtracker-0.8.0/tests/integration/__init__.py +3 -0
  111. pystormtracker-0.8.0/tests/integration/test_cli_extra.py +114 -0
  112. pystormtracker-0.8.0/tests/integration/test_hodges.py +116 -0
  113. pystormtracker-0.8.0/tests/integration/test_io.py +60 -0
  114. pystormtracker-0.8.0/tests/integration/test_parallel_backends.py +609 -0
  115. pystormtracker-0.8.0/tests/integration/test_projection.py +77 -0
  116. pystormtracker-0.8.0/tests/integration/test_reduced_gaussian.py +264 -0
  117. pystormtracker-0.8.0/tests/integration/test_simple.py +264 -0
  118. pystormtracker-0.8.0/tests/integration/test_trackjson.py +32 -0
  119. pystormtracker-0.8.0/tests/parity/__init__.py +3 -0
  120. pystormtracker-0.8.0/tests/parity/legacy/__init__.py +3 -0
  121. pystormtracker-0.8.0/tests/parity/legacy/test_simple_v0_0_2_parity.py +115 -0
  122. pystormtracker-0.8.0/tests/parity/ncl_spherepack/__init__.py +3 -0
  123. pystormtracker-0.8.0/tests/parity/ncl_spherepack/test_spectral_ncl.py +55 -0
  124. pystormtracker-0.8.0/tests/unit/__init__.py +3 -0
  125. pystormtracker-0.8.0/tests/unit/healpix/__init__.py +3 -0
  126. pystormtracker-0.8.0/tests/unit/healpix/test_detector.py +407 -0
  127. pystormtracker-0.8.0/tests/unit/healpix/test_tracker.py +48 -0
  128. pystormtracker-0.8.0/tests/unit/hodges/__init__.py +3 -0
  129. pystormtracker-0.8.0/tests/unit/hodges/test_detector.py +789 -0
  130. pystormtracker-0.8.0/tests/unit/hodges/test_linker.py +1067 -0
  131. pystormtracker-0.8.0/tests/unit/hodges/test_mge.py +179 -0
  132. pystormtracker-0.8.0/tests/unit/hodges/test_progress.py +176 -0
  133. pystormtracker-0.8.0/tests/unit/hodges/test_segments.py +106 -0
  134. pystormtracker-0.8.0/tests/unit/hodges/test_tracker.py +386 -0
  135. pystormtracker-0.8.0/tests/unit/io/__init__.py +3 -0
  136. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/tests/unit/io/test_data_loader.py +103 -19
  137. pystormtracker-0.8.0/tests/unit/io/test_format.py +180 -0
  138. pystormtracker-0.8.0/tests/unit/io/test_imilast.py +43 -0
  139. pystormtracker-0.8.0/tests/unit/io/test_track.py +89 -0
  140. pystormtracker-0.8.0/tests/unit/io/test_trackjson.py +301 -0
  141. pystormtracker-0.8.0/tests/unit/metrics/test_cross_validation.py +293 -0
  142. pystormtracker-0.8.0/tests/unit/metrics/test_eulerian.py +83 -0
  143. pystormtracker-0.8.0/tests/unit/metrics/test_lagrangian.py +529 -0
  144. pystormtracker-0.8.0/tests/unit/metrics/test_rsplice.py +145 -0
  145. pystormtracker-0.8.0/tests/unit/metrics/test_weighting.py +58 -0
  146. pystormtracker-0.8.0/tests/unit/models/__init__.py +3 -0
  147. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/tests/unit/models/test_center.py +8 -5
  148. pystormtracker-0.8.0/tests/unit/models/test_geo.py +99 -0
  149. pystormtracker-0.8.0/tests/unit/models/test_tracks.py +239 -0
  150. pystormtracker-0.8.0/tests/unit/models/test_units.py +57 -0
  151. pystormtracker-0.8.0/tests/unit/preprocessing/__init__.py +3 -0
  152. pystormtracker-0.8.0/tests/unit/preprocessing/test_kinematics.py +447 -0
  153. pystormtracker-0.8.0/tests/unit/preprocessing/test_regrid.py +396 -0
  154. pystormtracker-0.8.0/tests/unit/preprocessing/test_spectral.py +542 -0
  155. pystormtracker-0.8.0/tests/unit/refinement/test_bspline.py +995 -0
  156. pystormtracker-0.8.0/tests/unit/refinement/test_quadratic.py +361 -0
  157. pystormtracker-0.8.0/tests/unit/simple/__init__.py +3 -0
  158. pystormtracker-0.8.0/tests/unit/simple/test_detector.py +187 -0
  159. pystormtracker-0.8.0/tests/unit/simple/test_linker.py +223 -0
  160. pystormtracker-0.8.0/tests/unit/simple/test_tracker.py +90 -0
  161. pystormtracker-0.8.0/tests/unit/test_api.py +118 -0
  162. pystormtracker-0.8.0/tests/unit/test_backends.py +50 -0
  163. pystormtracker-0.8.0/tests/unit/test_cli.py +635 -0
  164. pystormtracker-0.8.0/tests/unit/test_compare.py +554 -0
  165. pystormtracker-0.8.0/tests/unit/test_convert.py +68 -0
  166. pystormtracker-0.8.0/tests/unit/test_observability.py +262 -0
  167. pystormtracker-0.8.0/tests/unit/test_preprocessing.py +211 -0
  168. pystormtracker-0.8.0/tests/unit/test_sample.py +234 -0
  169. pystormtracker-0.8.0/tests/unit/test_time.py +223 -0
  170. pystormtracker-0.8.0/tests/unit/test_track_cli.py +71 -0
  171. pystormtracker-0.8.0/tests/unit/test_utils.py +109 -0
  172. pystormtracker-0.8.0/tests/utils.py +180 -0
  173. pystormtracker-0.8.0/uv.lock +4996 -0
  174. pystormtracker-0.5.0/.github/dependabot.yml +0 -16
  175. pystormtracker-0.5.0/.github/workflows/ci.yml +0 -229
  176. pystormtracker-0.5.0/.github/workflows/docker-publish.yml +0 -158
  177. pystormtracker-0.5.0/.github/workflows/python-publish.yml +0 -118
  178. pystormtracker-0.5.0/.python-version +0 -1
  179. pystormtracker-0.5.0/.readthedocs.yaml +0 -22
  180. pystormtracker-0.5.0/AGENTS.md +0 -20
  181. pystormtracker-0.5.0/CITATION.cff +0 -53
  182. pystormtracker-0.5.0/Dockerfile +0 -62
  183. pystormtracker-0.5.0/PKG-INFO +0 -325
  184. pystormtracker-0.5.0/README.md +0 -266
  185. pystormtracker-0.5.0/codecov.yml +0 -13
  186. pystormtracker-0.5.0/data/adapt.dat +0 -2
  187. pystormtracker-0.5.0/data/test/era5/era5_msl_2025120100_0.25x0.25.nc +0 -0
  188. pystormtracker-0.5.0/data/test/era5/era5_msl_2025120100_0.25x0.25_t0-42_ncl.nc +0 -0
  189. pystormtracker-0.5.0/data/test/era5/era5_msl_2025120100_0.25x0.25_t5-42_ncl.nc +0 -0
  190. pystormtracker-0.5.0/data/test/era5/era5_msl_2025120100_2.5x2.5.nc +0 -0
  191. pystormtracker-0.5.0/data/test/era5/era5_msl_2025120100_2.5x2.5_t0-42_ncl.nc +0 -0
  192. pystormtracker-0.5.0/data/test/era5/era5_msl_2025120100_2.5x2.5_t5-42_ncl.nc +0 -0
  193. pystormtracker-0.5.0/data/test/era5/era5_sfvp850_2025120100_0.25x0.25_ncl.nc +0 -0
  194. pystormtracker-0.5.0/data/test/era5/era5_sfvp850_2025120100_2.5x2.5_ncl.nc +0 -0
  195. pystormtracker-0.5.0/data/test/era5/era5_uv850_2025120100_0.25x0.25.nc +0 -0
  196. pystormtracker-0.5.0/data/test/era5/era5_uv850_2025120100_2.5x2.5.nc +0 -0
  197. pystormtracker-0.5.0/data/test/era5/era5_vo850_2025120100_0.25x0.25.nc +0 -0
  198. pystormtracker-0.5.0/data/test/era5/era5_vo850_2025120100_2.5x2.5.nc +0 -0
  199. pystormtracker-0.5.0/data/test/era5/era5_vodv850_2025120100_0.25x0.25_ncl.nc +0 -0
  200. pystormtracker-0.5.0/data/test/era5/era5_vodv850_2025120100_2.5x2.5_ncl.nc +0 -0
  201. pystormtracker-0.5.0/data/test/era5/process_era5.ncl +0 -230
  202. pystormtracker-0.5.0/data/test/tracks/era5_msl_2025-2026_djf_2.5x2.5_hodges.txt +0 -28904
  203. pystormtracker-0.5.0/data/test/tracks/era5_msl_2025-2026_djf_2.5x2.5_hodges_imilast.txt +0 -25968
  204. pystormtracker-0.5.0/data/test/tracks/era5_msl_2025-2026_djf_2.5x2.5_v0.0.2_imilast.txt +0 -38464
  205. pystormtracker-0.5.0/data/test/tracks/era5_vo_2025-2026_djf_2.5x2.5_1e-4_v0.0.2_imilast.txt +0 -38347
  206. pystormtracker-0.5.0/data/zone.dat +0 -4
  207. pystormtracker-0.5.0/docs/_static/benchmark_0_25x0_25_breakdown.png +0 -0
  208. pystormtracker-0.5.0/docs/_static/benchmark_2_5x2_5_breakdown.png +0 -0
  209. pystormtracker-0.5.0/docs/_static/explorer.html +0 -1377
  210. pystormtracker-0.5.0/docs/_static/explorer.tracks.js +0 -1
  211. pystormtracker-0.5.0/docs/architecture.md +0 -108
  212. pystormtracker-0.5.0/docs/benchmark.md +0 -50
  213. pystormtracker-0.5.0/docs/changelog.md +0 -152
  214. pystormtracker-0.5.0/docs/conf.py +0 -31
  215. pystormtracker-0.5.0/docs/healpix.md +0 -62
  216. pystormtracker-0.5.0/docs/hodges.md +0 -124
  217. pystormtracker-0.5.0/docs/index.md +0 -37
  218. pystormtracker-0.5.0/docs/interactive.md +0 -17
  219. pystormtracker-0.5.0/docs/readme.md +0 -3
  220. pystormtracker-0.5.0/docs/roadmap.md +0 -63
  221. pystormtracker-0.5.0/docs/spectral_accuracy.md +0 -71
  222. pystormtracker-0.5.0/notebooks/interactive_tracks.ipynb +0 -1448
  223. pystormtracker-0.5.0/pyproject.toml +0 -159
  224. pystormtracker-0.5.0/src/pystormtracker/__init__.py +0 -25
  225. pystormtracker-0.5.0/src/pystormtracker/cli.py +0 -532
  226. pystormtracker-0.5.0/src/pystormtracker/convert.py +0 -146
  227. pystormtracker-0.5.0/src/pystormtracker/healpix/detector.py +0 -305
  228. pystormtracker-0.5.0/src/pystormtracker/healpix/kernels.py +0 -250
  229. pystormtracker-0.5.0/src/pystormtracker/healpix/tracker.py +0 -231
  230. pystormtracker-0.5.0/src/pystormtracker/hodges/__init__.py +0 -0
  231. pystormtracker-0.5.0/src/pystormtracker/hodges/constants.py +0 -41
  232. pystormtracker-0.5.0/src/pystormtracker/hodges/detector.py +0 -222
  233. pystormtracker-0.5.0/src/pystormtracker/hodges/kernels.py +0 -837
  234. pystormtracker-0.5.0/src/pystormtracker/hodges/linker.py +0 -304
  235. pystormtracker-0.5.0/src/pystormtracker/hodges/tracker.py +0 -385
  236. pystormtracker-0.5.0/src/pystormtracker/io/__init__.py +0 -3
  237. pystormtracker-0.5.0/src/pystormtracker/io/data_loader.py +0 -171
  238. pystormtracker-0.5.0/src/pystormtracker/io/hodges.py +0 -41
  239. pystormtracker-0.5.0/src/pystormtracker/io/imilast.py +0 -145
  240. pystormtracker-0.5.0/src/pystormtracker/io/json.py +0 -220
  241. pystormtracker-0.5.0/src/pystormtracker/models/__init__.py +0 -5
  242. pystormtracker-0.5.0/src/pystormtracker/models/center.py +0 -56
  243. pystormtracker-0.5.0/src/pystormtracker/models/constants.py +0 -20
  244. pystormtracker-0.5.0/src/pystormtracker/models/geo.py +0 -74
  245. pystormtracker-0.5.0/src/pystormtracker/models/tracker.py +0 -51
  246. pystormtracker-0.5.0/src/pystormtracker/models/tracks.py +0 -438
  247. pystormtracker-0.5.0/src/pystormtracker/preprocessing/__init__.py +0 -14
  248. pystormtracker-0.5.0/src/pystormtracker/preprocessing/kinematics.py +0 -284
  249. pystormtracker-0.5.0/src/pystormtracker/preprocessing/regrid.py +0 -266
  250. pystormtracker-0.5.0/src/pystormtracker/preprocessing/spectral.py +0 -306
  251. pystormtracker-0.5.0/src/pystormtracker/simple/concurrent.py +0 -172
  252. pystormtracker-0.5.0/src/pystormtracker/simple/detector.py +0 -310
  253. pystormtracker-0.5.0/src/pystormtracker/simple/kernels.py +0 -148
  254. pystormtracker-0.5.0/src/pystormtracker/simple/linker.py +0 -179
  255. pystormtracker-0.5.0/src/pystormtracker/simple/tracker.py +0 -306
  256. pystormtracker-0.5.0/src/pystormtracker/templates/explorer.html +0 -1377
  257. pystormtracker-0.5.0/tests/conftest.py +0 -49
  258. pystormtracker-0.5.0/tests/integration/__init__.py +0 -0
  259. pystormtracker-0.5.0/tests/integration/test_hodges.py +0 -118
  260. pystormtracker-0.5.0/tests/integration/test_simple.py +0 -316
  261. pystormtracker-0.5.0/tests/integration/test_spectral.py +0 -134
  262. pystormtracker-0.5.0/tests/integration/test_vorticity.py +0 -49
  263. pystormtracker-0.5.0/tests/testing_utils.py +0 -174
  264. pystormtracker-0.5.0/tests/unit/__init__.py +0 -0
  265. pystormtracker-0.5.0/tests/unit/healpix/__init__.py +0 -0
  266. pystormtracker-0.5.0/tests/unit/healpix/test_detector.py +0 -75
  267. pystormtracker-0.5.0/tests/unit/healpix/test_kernels.py +0 -109
  268. pystormtracker-0.5.0/tests/unit/healpix/test_tracker.py +0 -26
  269. pystormtracker-0.5.0/tests/unit/hodges/__init__.py +0 -0
  270. pystormtracker-0.5.0/tests/unit/hodges/test_detector.py +0 -67
  271. pystormtracker-0.5.0/tests/unit/hodges/test_kernels.py +0 -88
  272. pystormtracker-0.5.0/tests/unit/hodges/test_linker.py +0 -119
  273. pystormtracker-0.5.0/tests/unit/hodges/test_tracker.py +0 -101
  274. pystormtracker-0.5.0/tests/unit/io/__init__.py +0 -0
  275. pystormtracker-0.5.0/tests/unit/io/test_imilast.py +0 -108
  276. pystormtracker-0.5.0/tests/unit/models/__init__.py +0 -0
  277. pystormtracker-0.5.0/tests/unit/models/test_geo.py +0 -44
  278. pystormtracker-0.5.0/tests/unit/models/test_tracks.py +0 -256
  279. pystormtracker-0.5.0/tests/unit/preprocessing/__init__.py +0 -0
  280. pystormtracker-0.5.0/tests/unit/preprocessing/test_kinematics.py +0 -140
  281. pystormtracker-0.5.0/tests/unit/preprocessing/test_regrid.py +0 -147
  282. pystormtracker-0.5.0/tests/unit/preprocessing/test_spectral.py +0 -109
  283. pystormtracker-0.5.0/tests/unit/simple/__init__.py +0 -0
  284. pystormtracker-0.5.0/tests/unit/simple/test_detector.py +0 -61
  285. pystormtracker-0.5.0/tests/unit/simple/test_kernels.py +0 -86
  286. pystormtracker-0.5.0/tests/unit/simple/test_linker.py +0 -41
  287. pystormtracker-0.5.0/tests/unit/simple/test_tracker.py +0 -40
  288. pystormtracker-0.5.0/tests/unit/test_cli.py +0 -95
  289. pystormtracker-0.5.0/tests/unit/test_cli_dat_files.py +0 -98
  290. pystormtracker-0.5.0/tests/unit/test_testing_utils.py +0 -73
  291. pystormtracker-0.5.0/uv.lock +0 -4495
  292. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/docs/_static/IntercomparisonProtocol.pdf +0 -0
  293. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/docs/_static/era5_msl_nh.png +0 -0
  294. {pystormtracker-0.5.0 → pystormtracker-0.8.0}/src/pystormtracker/py.typed +0 -0
@@ -8,8 +8,7 @@
8
8
  .venv/
9
9
  .vscode/
10
10
  __pycache__/
11
- benchmark/
12
- data/test/
11
+ benchmarks/
13
12
  docs/
14
13
  htmlcov/
15
14
  tests/
@@ -1,15 +1,12 @@
1
- # Mark notebooks as generated so they don't count towards language statistics
2
- notebooks/*.ipynb linguist-generated
3
-
4
1
  # Mark benchmarking code and data as documentation to focus on core logic
5
2
  benchmark/* linguist-documentation
6
3
 
7
- # Mark the JOSS paper and all documentation files (including static HTML) as documentation
4
+ # Mark all documentation files (including static HTML) as documentation
8
5
  docs/* linguist-documentation
9
- paper/* linguist-documentation
10
6
 
11
7
  # Mark example/test data files as documentation/vendored
12
8
  data/* linguist-vendored
9
+ tests/data/* linguist-vendored
13
10
 
14
11
  # Ensure lockfiles are marked as generated
15
12
  uv.lock linguist-generated
@@ -0,0 +1,36 @@
1
+ version: 2
2
+
3
+ updates:
4
+ - package-ecosystem: uv
5
+ directory: /
6
+ schedule:
7
+ interval: weekly
8
+ versioning-strategy: increase-if-necessary
9
+ groups:
10
+ python-minor-and-patch:
11
+ patterns: ['*']
12
+ update-types: [minor, patch]
13
+
14
+ - package-ecosystem: pre-commit
15
+ directory: /
16
+ schedule:
17
+ interval: weekly
18
+ groups:
19
+ pre-commit:
20
+ patterns: ['*']
21
+
22
+ - package-ecosystem: github-actions
23
+ directory: /
24
+ schedule:
25
+ interval: weekly
26
+ groups:
27
+ github-actions:
28
+ patterns: ['*']
29
+
30
+ - package-ecosystem: docker
31
+ directory: /
32
+ schedule:
33
+ interval: weekly
34
+ groups:
35
+ docker:
36
+ patterns: ['*']
@@ -0,0 +1,17 @@
1
+ ## Summary
2
+
3
+ <!-- What changed, and the user or developer impact. -->
4
+
5
+ -
6
+
7
+ ## Why
8
+
9
+ <!-- Why this change is needed. For fixes, describe the root cause. -->
10
+
11
+ -
12
+
13
+ ## Validation
14
+
15
+ <!-- Commands, CI jobs, datasets, or manual checks used to verify the change. -->
16
+
17
+ - \[ \]
@@ -0,0 +1,526 @@
1
+ name: CI
2
+
3
+ on:
4
+ pull_request:
5
+ push:
6
+ branches:
7
+ - main
8
+ tags:
9
+ - 'v*.*.*'
10
+ workflow_dispatch:
11
+
12
+ concurrency:
13
+ group: ci-${{ github.event.pull_request.number || github.ref }}
14
+ cancel-in-progress: ${{ github.ref_type != 'tag' }}
15
+
16
+ permissions:
17
+ contents: read
18
+
19
+ env:
20
+ UV_VERSION: '0.12.1'
21
+ PYTHON_VERSION: '3.14'
22
+
23
+ jobs:
24
+ select-test-matrix:
25
+ name: Select test matrix
26
+ runs-on: ubuntu-26.04
27
+ timeout-minutes: 5
28
+ outputs:
29
+ unit_matrix: ${{ steps.select.outputs.unit_matrix }}
30
+ integration_matrix: ${{ steps.select.outputs.integration_matrix }}
31
+ parity_matrix: ${{ steps.select.outputs.parity_matrix }}
32
+ uv_version: ${{ env.UV_VERSION }}
33
+ steps:
34
+ - name: Select representative or full matrix
35
+ id: select
36
+ run: |
37
+ set -euo pipefail
38
+
39
+ if [[ "$GITHUB_EVENT_NAME" == "pull_request" ]]; then
40
+ UNIT_MATRIX='{
41
+ "include": [
42
+ {"os": "ubuntu-26.04", "python-version": "3.12", "mode": "min-deps"},
43
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "coverage", "coverage_flag": "unit"},
44
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "jit-coverage", "coverage_flag": "unit-jit-coverage"},
45
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "disabled-jit-coverage", "coverage_flag": "unit-jit-disabled"},
46
+ {"os": "windows-2025", "python-version": "3.13", "mode": "normal"},
47
+ {"os": "macos-26", "python-version": "3.14", "mode": "normal"}
48
+ ]
49
+ }'
50
+ INTEGRATION_MATRIX='{
51
+ "include": [
52
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mpi": "mpich", "coverage": true}
53
+ ]
54
+ }'
55
+ PARITY_MATRIX='{
56
+ "include": [
57
+ {"os": "ubuntu-26.04", "python-version": "3.14", "coverage": true}
58
+ ]
59
+ }'
60
+ else
61
+ UNIT_MATRIX='{
62
+ "include": [
63
+ {"os": "ubuntu-26.04", "python-version": "3.12", "mode": "normal"},
64
+ {"os": "ubuntu-26.04", "python-version": "3.12", "mode": "min-deps"},
65
+ {"os": "ubuntu-26.04", "python-version": "3.13", "mode": "normal"},
66
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "coverage", "coverage_flag": "unit"},
67
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "jit-coverage", "coverage_flag": "unit-jit-coverage"},
68
+ {"os": "ubuntu-26.04", "python-version": "3.14", "mode": "disabled-jit-coverage", "coverage_flag": "unit-jit-disabled"},
69
+ {"os": "ubuntu-26.04", "python-version": "3.14t", "mode": "free-threaded"},
70
+ {"os": "windows-2025", "python-version": "3.13", "mode": "normal"},
71
+ {"os": "macos-26", "python-version": "3.14", "mode": "normal"}
72
+ ]
73
+ }'
74
+ INTEGRATION_MATRIX='{
75
+ "include": [
76
+ {"os": "ubuntu-26.04-arm", "python-version": "3.14", "mpi": "mpich", "coverage": false},
77
+ {"os": "ubuntu-24.04", "python-version": "3.14", "mpi": "mpich", "coverage": true},
78
+ {"os": "windows-2025", "python-version": "3.13", "mpi": "msmpi", "coverage": false},
79
+ {"os": "macos-26", "python-version": "3.14", "mpi": "mpich", "coverage": false}
80
+ ]
81
+ }'
82
+ PARITY_MATRIX='{
83
+ "include": [
84
+ {"os": "ubuntu-26.04", "python-version": "3.14", "coverage": true}
85
+ ]
86
+ }'
87
+ fi
88
+
89
+ {
90
+ echo "unit_matrix<<EOF"
91
+ echo "$UNIT_MATRIX"
92
+ echo "EOF"
93
+ echo "integration_matrix<<EOF"
94
+ echo "$INTEGRATION_MATRIX"
95
+ echo "EOF"
96
+ echo "parity_matrix<<EOF"
97
+ echo "$PARITY_MATRIX"
98
+ echo "EOF"
99
+ } >> "$GITHUB_OUTPUT"
100
+
101
+ code-quality:
102
+ name: Code quality checks
103
+ runs-on: ubuntu-26.04
104
+ timeout-minutes: 20
105
+ steps:
106
+ - uses: actions/checkout@v7.0.1
107
+ with:
108
+ persist-credentials: false
109
+
110
+ - name: Ruff lint
111
+ uses: astral-sh/ruff-action@v4.1.0
112
+ with:
113
+ args: check
114
+ version-file: uv.lock
115
+
116
+ - name: Ruff format
117
+ if: ${{ !cancelled() }}
118
+ uses: astral-sh/ruff-action@v4.1.0
119
+ with:
120
+ args: format --check
121
+ version-file: uv.lock
122
+
123
+ - name: Set up uv
124
+ if: ${{ !cancelled() }}
125
+ uses: astral-sh/setup-uv@v10.3.0
126
+ with:
127
+ version: ${{ env.UV_VERSION }}
128
+ enable-cache: true
129
+ python-version: ${{ env.PYTHON_VERSION }}
130
+
131
+ - name: Install type-checking environment
132
+ if: ${{ !cancelled() }}
133
+ run: uv sync --frozen --all-extras
134
+
135
+ - name: Check TrackJSON schema
136
+ if: ${{ !cancelled() }}
137
+ run: uv run --no-sync python scripts/generate_trackjson_schema.py --check
138
+
139
+ - name: Ty
140
+ if: ${{ !cancelled() }}
141
+ run: uv run --no-sync ty check
142
+
143
+ - name: Mypy
144
+ if: ${{ !cancelled() }}
145
+ run: uv run --no-sync mypy
146
+
147
+ - name: Check SPDX headers
148
+ if: ${{ !cancelled() }}
149
+ run: uvx prek run spdx --all-files
150
+
151
+ unit-tests:
152
+ name: Unit tests (${{ matrix.os }}, Python ${{ matrix.python-version }}${{ matrix.mode != 'normal' && format(', {0}', matrix.mode) || '' }})
153
+ needs: [select-test-matrix, code-quality]
154
+ runs-on: ${{ matrix.os }}
155
+ timeout-minutes: 40
156
+ strategy:
157
+ fail-fast: false
158
+ matrix: ${{ fromJSON(needs.select-test-matrix.outputs.unit_matrix) }}
159
+ steps:
160
+ - uses: actions/checkout@v7.0.1
161
+ with:
162
+ persist-credentials: false
163
+
164
+ - uses: astral-sh/setup-uv@v10.3.0
165
+ with:
166
+ version: ${{ env.UV_VERSION }}
167
+ enable-cache: true
168
+ python-version: ${{ matrix.python-version }}
169
+
170
+ - name: Set up Microsoft MPI on Windows
171
+ if: runner.os == 'Windows'
172
+ uses: mpi4py/setup-mpi@v1.4.4
173
+ with:
174
+ mpi: msmpi
175
+
176
+ - name: Install dependencies
177
+ if: matrix.mode == 'normal' || matrix.mode == 'coverage' || matrix.mode == 'jit-coverage' || matrix.mode == 'disabled-jit-coverage'
178
+ run: uv sync --frozen --all-extras
179
+
180
+ - name: Install minimum direct dependencies
181
+ if: matrix.mode == 'min-deps'
182
+ run: uv sync --all-extras --resolution lowest-direct
183
+
184
+ - name: Install free-threaded dependencies
185
+ if: matrix.mode == 'free-threaded'
186
+ run: uv sync --frozen
187
+
188
+ - name: Smoke-check GRIB and Zarr dependencies
189
+ if: matrix.mode != 'free-threaded'
190
+ run: |
191
+ uv run --no-sync python -m cfgrib selfcheck
192
+ uv run --no-sync python -c 'import zarr; print("zarr import success")'
193
+
194
+ - name: Run unit tests
195
+ if: matrix.mode == 'normal' || matrix.mode == 'min-deps'
196
+ run: uv run --no-sync pytest -vv
197
+
198
+ - name: Run unit tests with coverage
199
+ if: matrix.mode == 'coverage'
200
+ run: uv run --no-sync pytest -vv --cov=pystormtracker --cov-report=term-missing --cov-report=xml --junitxml=junit.xml -o junit_family=legacy
201
+
202
+ - name: Run unit tests with JIT coverage
203
+ if: matrix.mode == 'jit-coverage'
204
+ env:
205
+ NUMBA_JIT_COVERAGE: '1'
206
+ NUMBA_CACHE_DIR: ${{ runner.temp }}/numba-coverage-cache
207
+ run: uv run --no-sync pytest -vv --cov=pystormtracker --cov-report=term-missing --cov-report=xml
208
+
209
+ - name: Run unit tests with JIT disabled coverage
210
+ if: matrix.mode == 'disabled-jit-coverage'
211
+ env:
212
+ NUMBA_DISABLE_JIT: '1'
213
+ run: uv run --no-sync pytest -vv --cov=pystormtracker --cov-report=term-missing --cov-report=xml
214
+
215
+ - name: Verify free-threaded Python
216
+ if: matrix.mode == 'free-threaded'
217
+ env:
218
+ PYTHON_GIL: '0'
219
+ run: uv run --no-sync python -c 'import sys; assert not sys._is_gil_enabled()'
220
+
221
+ - name: Run free-threaded unit tests
222
+ if: matrix.mode == 'free-threaded'
223
+ env:
224
+ PYTHON_GIL: '0'
225
+ run: uv run --no-sync pytest -vv
226
+
227
+ - name: Upload coverage
228
+ if: matrix.mode == 'coverage' || matrix.mode == 'jit-coverage' || matrix.mode == 'disabled-jit-coverage'
229
+ uses: codecov/codecov-action@v7.1.1
230
+ with:
231
+ files: ./coverage.xml
232
+ disable_search: true
233
+ flags: ${{ matrix.coverage_flag }}
234
+ fail_ci_if_error: false
235
+ token: ${{ secrets.CODECOV_TOKEN }}
236
+
237
+ - name: Upload test results
238
+ if: ${{ !cancelled() && matrix.mode == 'coverage' }}
239
+ uses: codecov/codecov-action@v7.1.1
240
+ with:
241
+ files: ./junit.xml
242
+ disable_search: true
243
+ report_type: test_results
244
+ flags: unit
245
+ token: ${{ secrets.CODECOV_TOKEN }}
246
+
247
+ integration-tests:
248
+ name: Integration tests (${{ matrix.os }}, Python ${{ matrix.python-version }})
249
+ needs: [select-test-matrix, code-quality]
250
+ runs-on: ${{ matrix.os }}
251
+ timeout-minutes: 70
252
+ strategy:
253
+ fail-fast: false
254
+ matrix: ${{ fromJSON(needs.select-test-matrix.outputs.integration_matrix) }}
255
+ steps:
256
+ - uses: actions/checkout@v7.0.1
257
+ with:
258
+ persist-credentials: false
259
+
260
+ - uses: astral-sh/setup-uv@v10.3.0
261
+ with:
262
+ version: ${{ env.UV_VERSION }}
263
+ enable-cache: true
264
+ python-version: ${{ matrix.python-version }}
265
+
266
+ - name: Set up MPI
267
+ uses: mpi4py/setup-mpi@v1.4.4
268
+ with:
269
+ mpi: ${{ matrix.mpi }}
270
+
271
+ - name: Install dependencies
272
+ run: uv sync --frozen --all-extras
273
+
274
+ - name: Run integration tests with coverage
275
+ if: matrix.coverage == true
276
+ env:
277
+ NUMBA_JIT_COVERAGE: '1'
278
+ NUMBA_CACHE_DIR: ${{ runner.temp }}/numba-coverage-cache
279
+ run: uv run --no-sync pytest -vv --cov=pystormtracker --cov-report=term-missing --cov-report=xml --junitxml=junit.xml -o junit_family=legacy tests/integration/ -m "not slow and not data"
280
+
281
+ - name: Run integration tests
282
+ if: matrix.coverage == false
283
+ run: uv run --no-sync pytest -vv tests/integration/ -m "not slow and not data"
284
+
285
+ - name: Upload coverage
286
+ if: matrix.coverage == true
287
+ uses: codecov/codecov-action@v7.1.1
288
+ with:
289
+ files: ./coverage.xml
290
+ disable_search: true
291
+ flags: integration
292
+ fail_ci_if_error: false
293
+ token: ${{ secrets.CODECOV_TOKEN }}
294
+
295
+ - name: Upload test results
296
+ if: ${{ !cancelled() && matrix.coverage == true }}
297
+ uses: codecov/codecov-action@v7.1.1
298
+ with:
299
+ files: ./junit.xml
300
+ disable_search: true
301
+ report_type: test_results
302
+ flags: integration
303
+ token: ${{ secrets.CODECOV_TOKEN }}
304
+
305
+ parity-tests:
306
+ name: Parity tests (${{ matrix.os }}, Python ${{ matrix.python-version }})
307
+ needs: [select-test-matrix, code-quality]
308
+ runs-on: ${{ matrix.os }}
309
+ timeout-minutes: 60
310
+ strategy:
311
+ fail-fast: false
312
+ matrix: ${{ fromJSON(needs.select-test-matrix.outputs.parity_matrix) }}
313
+ steps:
314
+ - uses: actions/checkout@v7.0.1
315
+ with:
316
+ persist-credentials: false
317
+
318
+ - uses: astral-sh/setup-uv@v10.3.0
319
+ with:
320
+ version: ${{ env.UV_VERSION }}
321
+ enable-cache: true
322
+ python-version: ${{ matrix.python-version }}
323
+
324
+ - name: Install dependencies
325
+ run: uv sync --frozen --all-extras
326
+
327
+ - name: Run parity tests with coverage
328
+ if: matrix.coverage == true
329
+ env:
330
+ NUMBA_JIT_COVERAGE: '1'
331
+ NUMBA_CACHE_DIR: ${{ runner.temp }}/numba-coverage-cache
332
+ run: uv run --no-sync pytest -vv --cov=pystormtracker --cov-report=term-missing --cov-report=xml --junitxml=junit.xml -o junit_family=legacy tests/parity/ -m "not slow and not data"
333
+
334
+ - name: Run parity tests
335
+ if: matrix.coverage == false
336
+ run: uv run --no-sync pytest -vv tests/parity/ -m "not slow and not data"
337
+
338
+ - name: Upload coverage
339
+ if: matrix.coverage == true
340
+ uses: codecov/codecov-action@v7.1.1
341
+ with:
342
+ files: ./coverage.xml
343
+ disable_search: true
344
+ flags: parity
345
+ fail_ci_if_error: false
346
+ token: ${{ secrets.CODECOV_TOKEN }}
347
+
348
+ - name: Upload test results
349
+ if: ${{ !cancelled() && matrix.coverage == true }}
350
+ uses: codecov/codecov-action@v7.1.1
351
+ with:
352
+ files: ./junit.xml
353
+ disable_search: true
354
+ report_type: test_results
355
+ flags: parity
356
+ token: ${{ secrets.CODECOV_TOKEN }}
357
+
358
+ package-tests:
359
+ name: Package tests
360
+ needs: code-quality
361
+ runs-on: ubuntu-26.04
362
+ timeout-minutes: 25
363
+ steps:
364
+ - uses: actions/checkout@v7.0.1
365
+ with:
366
+ persist-credentials: false
367
+
368
+ - uses: astral-sh/setup-uv@v10.3.0
369
+ with:
370
+ version: ${{ env.UV_VERSION }}
371
+ enable-cache: true
372
+ python-version: ${{ env.PYTHON_VERSION }}
373
+
374
+ - name: Build wheel and source distribution
375
+ run: uv build --wheel --sdist
376
+
377
+ - name: Create wheel test environment
378
+ run: uv venv --seed .wheel-venv
379
+
380
+ - name: Install wheel using pip
381
+ run: .wheel-venv/bin/python -m pip install --no-cache-dir dist/*.whl
382
+
383
+ - name: Test wheel import
384
+ run: .wheel-venv/bin/python -c 'import pystormtracker; print("wheel import success")'
385
+
386
+ - name: Test packaged TrackJSON schema
387
+ run: >-
388
+ .wheel-venv/bin/python -c
389
+ 'import json; from importlib.resources import files;
390
+ schema_bytes = files("pystormtracker.schemas").joinpath("trackjson.schema.json").read_bytes();
391
+ json.loads(schema_bytes); print("packaged TrackJSON schema is valid")'
392
+
393
+ - name: Test wheel CLI
394
+ run: .wheel-venv/bin/stormtracker --help
395
+
396
+ - name: Create source-distribution test environment
397
+ if: github.event_name != 'pull_request'
398
+ run: uv venv --seed .sdist-venv
399
+
400
+ - name: Install source distribution using pip
401
+ if: github.event_name != 'pull_request'
402
+ run: .sdist-venv/bin/python -m pip install --no-cache-dir dist/*.tar.gz
403
+
404
+ - name: Test source-distribution import
405
+ if: github.event_name != 'pull_request'
406
+ run: .sdist-venv/bin/python -c 'import pystormtracker; print("sdist import success")'
407
+
408
+ - name: Upload release distributions
409
+ uses: actions/upload-artifact@v7
410
+ with:
411
+ name: release-dists
412
+ path: dist/
413
+ if-no-files-found: error
414
+
415
+ docs:
416
+ name: Build documentation
417
+ runs-on: ubuntu-26.04
418
+ timeout-minutes: 20
419
+ steps:
420
+ - uses: actions/checkout@v7.0.1
421
+ with:
422
+ persist-credentials: false
423
+
424
+ - uses: astral-sh/setup-uv@v10.3.0
425
+ with:
426
+ version: ${{ env.UV_VERSION }}
427
+ enable-cache: true
428
+ python-version: ${{ env.PYTHON_VERSION }}
429
+
430
+ - name: Build documentation
431
+ run: uv run --no-dev --group docs sphinx-build -W --keep-going -b html docs docs/_build/html
432
+
433
+ docker-build:
434
+ name: Build and test Docker images
435
+ if: github.event_name != 'workflow_dispatch'
436
+ needs:
437
+ [select-test-matrix, code-quality, unit-tests, integration-tests, parity-tests, package-tests, docs]
438
+ uses: ./.github/workflows/docker-build.yml
439
+ with:
440
+ push_images: ${{ github.event_name != 'pull_request' }}
441
+ ref: ${{ github.sha }}
442
+ uv_version: ${{ needs.select-test-matrix.outputs.uv_version }}
443
+ secrets:
444
+ DOCKER_HUB_ACCESS_TOKEN: ${{ github.event_name != 'pull_request' && secrets.DOCKER_HUB_ACCESS_TOKEN || '' }}
445
+
446
+ release_tag:
447
+ name: Validate release tag
448
+ if: github.ref_type == 'tag'
449
+ needs: [code-quality, unit-tests, integration-tests, parity-tests, package-tests, docs]
450
+ runs-on: ubuntu-26.04
451
+ timeout-minutes: 10
452
+ outputs:
453
+ python_repository: ${{ steps.release.outputs.python_repository }}
454
+ version: ${{ steps.release.outputs.version }}
455
+ release_tag: ${{ steps.release.outputs.release_tag }}
456
+ docker_target: ${{ steps.release.outputs.docker_target }}
457
+ steps:
458
+ - uses: actions/checkout@v7.0.1
459
+ with:
460
+ fetch-depth: 0
461
+ persist-credentials: false
462
+
463
+ - name: Verify tag is reachable from main
464
+ run: |
465
+ git fetch --no-tags origin +refs/heads/main:refs/remotes/origin/main
466
+ git merge-base --is-ancestor "$GITHUB_SHA" origin/main
467
+
468
+ - name: Validate release tag and package version
469
+ id: release
470
+ env:
471
+ TAG: ${{ github.ref_name }}
472
+ run: |
473
+ set -euo pipefail
474
+
475
+ VERSION="${TAG#v}"
476
+ PACKAGE_VERSION="$(sed -n 's/^version = "\([^"]*\)"/\1/p' pyproject.toml)"
477
+ test "$PACKAGE_VERSION" = "$VERSION"
478
+
479
+ if [[ "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+$ ]]; then
480
+ echo "python_repository=pypi" >> "$GITHUB_OUTPUT"
481
+ echo "docker_target=release" >> "$GITHUB_OUTPUT"
482
+ elif [[ "$TAG" =~ ^v[0-9]+\.[0-9]+\.[0-9]+\.dev[0-9]+$ ]]; then
483
+ echo "python_repository=testpypi" >> "$GITHUB_OUTPUT"
484
+ echo "docker_target=" >> "$GITHUB_OUTPUT"
485
+ else
486
+ echo "Unsupported version tag: $TAG" >&2
487
+ exit 1
488
+ fi
489
+
490
+ echo "version=$VERSION" >> "$GITHUB_OUTPUT"
491
+ echo "release_tag=$TAG" >> "$GITHUB_OUTPUT"
492
+
493
+ publish-docker-edge:
494
+ name: Publish Docker edge image
495
+ if: github.ref == 'refs/heads/main'
496
+ needs: docker-build
497
+ permissions:
498
+ contents: read
499
+ packages: write
500
+ id-token: write
501
+ attestations: write
502
+ uses: ./.github/workflows/docker-publish.yml
503
+ with:
504
+ source_tag: ${{ needs.docker-build.outputs.source_tag }}
505
+ target: edge
506
+ secrets:
507
+ DOCKER_HUB_ACCESS_TOKEN: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
508
+ GHCR_PAT: ${{ secrets.GHCR_PAT }}
509
+
510
+ publish-docker-release:
511
+ name: Publish Docker release image
512
+ if: github.ref_type == 'tag' && needs.release_tag.outputs.docker_target == 'release'
513
+ needs: [docker-build, release_tag]
514
+ permissions:
515
+ contents: read
516
+ packages: write
517
+ id-token: write
518
+ attestations: write
519
+ uses: ./.github/workflows/docker-publish.yml
520
+ with:
521
+ source_tag: ${{ needs.docker-build.outputs.source_tag }}
522
+ target: release
523
+ version: ${{ needs.release_tag.outputs.release_tag }}
524
+ secrets:
525
+ DOCKER_HUB_ACCESS_TOKEN: ${{ secrets.DOCKER_HUB_ACCESS_TOKEN }}
526
+ GHCR_PAT: ${{ secrets.GHCR_PAT }}
@@ -0,0 +1,19 @@
1
+ name: 'Dependency Review'
2
+ on: [pull_request]
3
+
4
+ permissions:
5
+ contents: read
6
+
7
+ jobs:
8
+ dependency-review:
9
+ name: Dependency review
10
+ runs-on: ubuntu-26.04
11
+ timeout-minutes: 10
12
+ steps:
13
+ - uses: actions/checkout@v7.0.1
14
+ with:
15
+ persist-credentials: false
16
+
17
+ - uses: actions/dependency-review-action@v5.0.0
18
+ with:
19
+ fail-on-severity: high