Merge branch 'main' into fix/localstore-partial-listing

Author: mayuriphad

.github/workflows/downstream.yml

@@ -68,13 +68,16 @@ jobs:
           import xarray; print(f'xarray {xarray.__version__}')
           "
 
-      - name: Run xarray zarr backend tests
+      # xarray keeps its backend tests in the `xarray/tests/backends` package
+      # (pydata/xarray#11633 split the former `test_backends*.py` modules into
+      # it). Running the package covers the zarr store, region/append, API and
+      # DataTree tests; the other backends are installed by the `io` extra, so
+      # their tests run too, as they did before the split.
+      - name: Run xarray backend tests
         working-directory: xarray
         run: |
           uv run --no-sync python -m pytest --no-header -q \
-            xarray/tests/test_backends.py \
-            xarray/tests/test_backends_api.py \
-            xarray/tests/test_backends_datatree.py
+            xarray/tests/backends
 
   numcodecs:
     name: numcodecs zarr3 codec tests

.github/workflows/issue-metrics.yml

@@ -33,7 +33,7 @@ jobs:
         echo "last_month=$first_day..$last_day" >> "$GITHUB_ENV"
 
     - name: Run issue-metrics tool
-      uses: github-community-projects/issue-metrics@a7dc2fb675661e208d4fc6fa321a6b95fc4a06f9 # v5.0.2
+      uses: github-community-projects/issue-metrics@671528652402b9b8a33da44b5c693b3161bc090f # v5.0.3
       env:
         GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         SEARCH_QUERY: 'repo:zarr-developers/zarr-python is:issue created:${{ env.last_month }} -reason:"not planned"'

.pre-commit-config.yaml

@@ -17,7 +17,7 @@ default_language_version:
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
-    rev: v0.16.6
+    rev: v0.16.10
     hooks:
       - id: ruff-check
         args: ["--fix", "--show-fixes"]
@@ -34,7 +34,7 @@ repos:
         exclude: mkdocs.yml
       - id: trailing-whitespace
   - repo: https://github.com/DavidAnson/markdownlint-cli2
-    rev: v0.23.2
+    rev: v0.23.3
     hooks:
       # Markdown structure/hygiene. Rule selection and ignores are in
       # .markdownlint-cli2.jsonc; complements ci/lint_docs.py (RST residue,
@@ -76,7 +76,7 @@ repos:
     hooks:
       - id: sp-repo-review
   - repo: https://github.com/numpy/numpydoc
-    rev: v1.11.0rc0
+    rev: v1.11.0
     hooks:
       - id: numpydoc-validation
   - repo: local
@@ -89,7 +89,7 @@ repos:
         types: [python]
         files: ^(src|tests)/
   - repo: https://github.com/zizmorcore/zizmor-pre-commit
-    rev: v1.30.0
+    rev: v1.30.1
     hooks:
       - id: zizmor
   - repo: https://github.com/twisted/towncrier

changes/3850.doc.md

@@ -0,0 +1 @@
+Document the removal of `LRUStoreCache` in the v3 migration guide, and point to the experimental `zarr.experimental.cache_store.CacheStore` as its replacement.

changes/4051.doc.md

@@ -0,0 +1,6 @@
+Added a deprecation policy to the contributing guide. It defines when a
+deprecation cycle is required for public API changes, a shared framework for
+deciding whether a removal is worthwhile, the mechanics a deprecation must
+follow (warning class, message contents, documentation, and changelog entry),
+and a minimum deprecation period of at least 6 months and at least one minor
+release before removal.

changes/4334.bugfix.md

@@ -0,0 +1,8 @@
+Resizing an array with `delete_outside_chunks=True` now generates only the
+out-of-bounds chunk coordinates and deletes them with a bounded pool of
+workers, instead of materializing the entire old and new grids and all
+deletion tasks. This bounds auxiliary memory during shrinking and mixed
+growing/shrinking resizes while preserving retained chunks. Growing, or
+shrinking within the last chunk of each axis, no longer schedules any
+deletion work. When a deletion fails, the remaining deletions are now
+cancelled before the error is raised; previously they ran to completion.