Merge branch 'main' into chore/docstring-and-lint-fixes

Author: d-v-b

.github/dependabot.yml

@@ -5,6 +5,8 @@ updates:
     directory: /
     schedule:
       interval: weekly
+    cooldown:
+      default-days: 7
     groups:
       actions:
         patterns:

.github/workflows/cd.yml

@@ -7,14 +7,20 @@ on:
     branches: [ main ]
   workflow_dispatch:
 
+permissions: {}
+
 jobs:
     build:
       name: Build and publish Python 🐍 distributions 📦 to PyPI
       runs-on: ubuntu-latest
+      permissions:
+        contents: read
       steps:
-        - uses: actions/checkout@v6
+        - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+          with:
+            persist-credentials: false
         - name: Set up Python
-          uses: actions/setup-python@v6
+          uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
           with:
             python-version: "3.x"
         - name: Install Hatch
@@ -24,7 +30,7 @@ jobs:
           run: |
             hatch build
         - name: Store the distribution packages
-          uses: actions/upload-artifact@v5
+          uses: actions/upload-artifact@043fb46d1a93c77aae656e7c1c64a875d1fc6a0a # v7.0.1
           with:
             name: python-package-distributions
             path: dist/
@@ -36,14 +42,17 @@ jobs:
       needs:
         - build
       runs-on: ubuntu-latest
+      environment:
+        name: release
+        url: https://pypi.org/p/pydantic-zarr
+      permissions:
+        id-token: write  # IMPORTANT: mandatory for trusted publishing
 
       steps:
       - name: Download all the dists
-        uses: actions/download-artifact@v6
+        uses: actions/download-artifact@3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c # v8.0.1
         with:
           name: python-package-distributions
           path: dist/
       - name: Publish distribution 📦 to PyPI
-        uses: pypa/gh-action-pypi-publish@release/v1
-        with:
-          password: ${{ secrets.PYPI_API_TOKEN }}
+        uses: pypa/gh-action-pypi-publish@cef221092ed1bacb1cc03d23a2d87d1d172e277b # v1.14.0

.github/workflows/check_changelogs.yml

@@ -3,16 +3,22 @@ name: Check changelog entries
 on:
   pull_request:
 
+permissions: {}
+
 jobs:
   check-changelogs:
     name: Check changelog entries
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
 
     steps:
-      - uses: actions/checkout@v6
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          persist-credentials: false
 
       - name: Install uv
-        uses: astral-sh/setup-uv@v7
+        uses: astral-sh/setup-uv@fac544c07dec837d0ccb6301d7b5580bf5edae39 # v8.2.0
 
       - name: Check changelog entries
         run: uv run --no-sync python ci/check_changelog_entries.py

.github/workflows/pre-commit.yml

@@ -5,10 +5,16 @@ on:
   push:
     branches: [main]
 
+permissions: {}
+
 jobs:
   pre-commit:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
-      - uses: actions/checkout@v6
-      - uses: actions/setup-python@v6
-      - uses: pre-commit/action@v3.0.1
+      - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+        with:
+          persist-credentials: false
+      - uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
+      - uses: pre-commit/action@2c7b3805fd2a0fd8c1884dcaebf91fc102a13ecd # v3.0.1

.github/workflows/test.yml

@@ -10,6 +10,8 @@ on:
     branches: [ main ]
   workflow_dispatch:
 
+permissions: {}
+
 concurrency:
   group: ${{ github.workflow }}-${{ github.ref }}
   cancel-in-progress: true
@@ -18,17 +20,22 @@ jobs:
   test:
     name: os=${{ matrix.os }}, py=${{ matrix.python-version }}, zarr-python=${{ matrix.zarr-version }}
 
+    permissions:
+      contents: read
+
     strategy:
       matrix:
-        python-version: ['3.11', '3.12', '3.13', '3.14']
+        python-version: ['3.12', '3.13', '3.14']
         zarr-version: ['3.0.10', '3.1.0', 'none']
         os: ["ubuntu-latest"]
     runs-on: ${{ matrix.os }}
 
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      with:
+        persist-credentials: false
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
       with:
         python-version: ${{ matrix.python-version }}
         cache: 'pip'
@@ -47,22 +54,25 @@ jobs:
         hatch run test-base.py${{ matrix.python-version }}:list-env
         hatch run test-base.py${{ matrix.python-version }}:test-cov
     - name: Upload coverage
-      uses: codecov/codecov-action@v5
+      uses: codecov/codecov-action@fb8b3582c8e4def4969c97caa2f19720cb33a72f # v6.0.2
       with:
         token: ${{ secrets.CODECOV_TOKEN }}
         verbose: true # optional (default = false)
 
   doctests:
     name: doctests
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
       with:
         fetch-depth: 0 # required for hatch version discovery, which is needed for numcodecs.zarr3
+        persist-credentials: false
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
       with:
-        python-version: '3.11'
+        python-version: '3.12'
         cache: 'pip'
     - name: Install Hatch
       run: |
@@ -74,12 +84,16 @@ jobs:
 
   test-min-reqs:
     runs-on: ubuntu-latest
+    permissions:
+      contents: read
     steps:
-    - uses: actions/checkout@v6
+    - uses: actions/checkout@df4cb1c069e1874edd31b4311f1884172cec0e10 # v6.0.3
+      with:
+        persist-credentials: false
     - name: Set up Python
-      uses: actions/setup-python@v6
+      uses: actions/setup-python@a309ff8b426b58ec0e2a45f0f869d46889d02405 # v6.2.0
       with:
-        python-version: '3.11'
+        python-version: '3.12'
     - name: Install minimum requirements
       run: |
         pip install .

.pre-commit-config.yaml

@@ -45,3 +45,7 @@ repos:
     rev: v1.8.0
     hooks:
       - id: numpydoc-validation
+  - repo: https://github.com/zizmorcore/zizmor-pre-commit
+    rev: v1.25.2
+    hooks:
+      - id: zizmor

.readthedocs.yaml

@@ -16,7 +16,7 @@ mkdocs:
 # Optionally declare the Python requirements required to build your docs
 python:
   install:
-    - method: pip
-      path: .
-      extra_requirements:
+    - method: uv
+      command: sync
+      groups:
         - docs

changes/166.feature.md

@@ -0,0 +1 @@
+Added support for the v2 chunk key encoding (`{"name": "v2", "configuration": {"separator": ...}}`) in the experimental `pydantic_zarr.experimental.v3` module, so experimental `ArraySpec` can model and round-trip Zarr v3 arrays that use it.

changes/167.bugfix.md

@@ -0,0 +1 @@
+Fixed unreachable match arms in `parse_dtype_v3` (in both `pydantic_zarr.v3` and `pydantic_zarr.experimental.v3`) where copy-paste errors caused `float64` and `complex64` numpy dtypes to raise `ValueError: Unsupported dtype` instead of returning the correct string names.

docs/release-notes.md

@@ -2,6 +2,13 @@
 
 <!-- towncrier release notes start -->
 
+## pydantic-zarr 0.10.0 (2026-04-16)
+
+### Features
+
+- The minimum supported Python is now 3.12 and the minimum supported NumPy is now 2.0. ([#145](https://github.com/zarr-developers/pydantic-zarr/issues/145))
+- Use `type ...` instead of `...: TypeAlias` to declare type aliases. ([#145](https://github.com/zarr-developers/pydantic-zarr/issues/145))
+
 ## pydantic-zarr 0.9.2 (2026-03-18)
 
 ### Features