Merge branch 'v4-dev' into reference-api-v4

Author: reint-fischer

.github/ci/min-core-deps.yml

@@ -0,0 +1,25 @@
+channels:
+  - conda-forge
+platforms:
+  - noarch
+  - linux-64
+policy:
+  # all packages in months
+  packages:
+    python: 30
+    numpy: 18
+  default: 12
+  # overrides for the policy
+  overrides: {}
+  # these packages are completely ignored
+  exclude:
+    - pytest
+    - hypothesis
+    - pytest-html
+    - pytest-cov
+    - nbval
+    - uxarray # undergoes active development
+    - xgcm # undergoes active development
+
+  # these packages don't fail the CI, but will be printed in the report
+  ignored_violations: []

.github/ci/min_deps_check.py

@@ -8,32 +8,21 @@ jobs:
   min-version-policy:
     name: Minimum Version Policy
     runs-on: "ubuntu-latest"
-    defaults:
-      run:
-        shell: bash -l {0}
-
+    env:
+      COLUMNS: 120
     steps:
       - uses: actions/checkout@v5
-      - name: Setup micromamba
-        uses: mamba-org/setup-micromamba@v2
-        with:
-          environment-name: min-deps
-          create-args: >-
-            python=3.12
-            pyyaml
-            conda
-            python-dateutil
-
-      - name: Core deps minimum versions policy
-        run: |
-          python .github/ci/min_deps_check.py .github/ci/min-core-deps.yml
+      - uses: astral-sh/setup-uv@v7
+      - run: |
+          uv run --with 'minimum-dependency-versions @ git+https://github.com/xarray-contrib/minimum-dependency-versions@v1.0.0' \
+          python -m minimum_versions validate \
+          --policy=.github/ci/policy.yaml \
+          --manifest-path=./pixi.toml \
+          pixi:test-minimum
 
   linkcheck:
     name: pixi run docs-linkcheck
     runs-on: "ubuntu-latest"
-    defaults:
-      run:
-        shell: bash -l {0}
 
     steps:
       - uses: actions/checkout@v5

.github/ci/policy.yaml

@@ -51,9 +51,27 @@ jobs:
         with:
           cache: true
           cache-write: ${{ github.event_name == 'push' && github.ref_name == 'v4-dev' }} # TODO: Update v4-dev to main when v4 is released
+      # https://github.com/actions/cache/blob/main/tips-and-workarounds.md#update-a-cache
+      - name: Restore cached hypothesis directory
+        id: restore-hypothesis-cache
+        uses: actions/cache/restore@v4
+        with:
+          path: .hypothesis/
+          key: cache-hypothesis-${{ runner.os }}-${{ github.run_id }}
+          restore-keys: |
+            cache-hypothesis-${{ runner.os }}-
       - name: Unit test
+        id: unit-test
         run: |
           pixi run -e ${{ matrix.pixi-environment }} tests -v -s --cov=parcels --cov-report=xml --html="${{ env.COVERAGE_REPORT }}" --self-contained-html
+      # explicitly save the cache so it gets updated, also do this even if it fails.
+      - name: Save cached hypothesis directory
+        id: save-hypothesis-cache
+        if: always() && steps.unit-test.outcome != 'skipped'
+        uses: actions/cache/save@v4
+        with:
+          path: .hypothesis/
+          key: cache-hypothesis-${{ runner.os }}-${{ github.run_id }}
       - name: Codecov
         uses: codecov/codecov-action@v5.5.1
         env:

.github/workflows/additional.yml

@@ -19,7 +19,7 @@ setuptools_scm = "*"
 
 [package.run-dependencies] # keep section in sync with pyproject.toml dependencies
 python = ">=3.11"
-netcdf4 = ">=1.7.2"
+netcdf4 = ">=1.6.0"
 numpy = ">=2.1.0"
 tqdm = ">=4.50.0"
 xarray = ">=2024.5.0"
@@ -35,18 +35,18 @@ pooch = ">=1.8.0"
 parcels = { path = "." }
 
 [feature.minimum.dependencies]
-python = "==3.11"
-netcdf4 = "==1.7.2"
-numpy = "==2.1.0"
-tqdm = "==4.50.0"
-xarray = "==2024.5.0"
-uxarray = "==2025.3.0"
-dask = "==2024.5.1"
-zarr = "==2.15.0"
-xgcm = "==0.9.0"
-cf_xarray = "==0.8.6"
-cftime = "==1.6.3"
-pooch = "==1.8.0"
+python = "3.11.*"
+netcdf4 = "1.6.*"
+numpy = "2.1.*"
+tqdm = "4.50.*"
+xarray = "2024.5.*"
+uxarray = "2025.3.*"
+dask = "2024.5.*"
+zarr = "2.15.*"
+xgcm = "0.9.*"
+cf_xarray = "0.8.*"
+cftime = "1.6.*"
+pooch = "1.8.*"
 
 [feature.py311.dependencies]
 python = "3.11.*"