chore: spec0 compat (python 3.14 compat, python 3.12 min) (#3564)

* chore: spec0 compat (python 3.14 compat, numpy 2 min)

* fix: point oh

* fix: `universal_pathlib` min bound

* fix: new generic syntax (leave `covariant` untouched)

* feat: `uv` in `hatch`

* fix: try covariance handling

* fix: allow covariance in `ZDType`

* fix: remove covariance in `common.py`

* fix: remove covariance in `codec.py`

* fix: remove unused `TypeVar`

* fix: bye byte `covariant`!

* fix: merge issue

* fix: more merge issues

* fix: universal_pathlib

* fix: pre-commit

* fix: no more needed to pin numpy

* chore: relnote

* `yaml` not `yml`

* fix: some `NDArrayLike` fixes

* fix: back to old numpy

* Revert "fix: some `NDArrayLike` fixes"

This reverts commit 73b72b1.

* fix: try 3.12

* fix: oops

* fix: ok that still produces some wierd output locally?

* chore: try printing out full issue

* fix: try skipping darwin build

* fix: bring back `GetResult`

---------

Co-authored-by: Deepak Cherian <dcherian@users.noreply.github.com>

Author: ilan-gold

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -61,7 +61,7 @@ body:
       value: |
         ```python
         # /// script
-        # requires-python = ">=3.11"
+        # requires-python = ">=3.12"
         # dependencies = [
         #   "zarr@git+https://github.com/zarr-developers/zarr-python.git@main",
         # ]

.github/workflows/gpu_test.yml

@@ -27,7 +27,7 @@ jobs:
     runs-on: gpu-runner
     strategy:
       matrix:
-        python-version: ['3.11']
+        python-version: ['3.12']
 
     steps:
     - uses: actions/checkout@v6

.github/workflows/nightly_wheels.yml

@@ -23,7 +23,7 @@ jobs:
       - uses: actions/setup-python@v6
         name: Install Python
         with:
-          python-version: '3.13'
+          python-version: '3.14'
 
       - name: Install Hatch
         uses: pypa/hatch@257e27e51a6a5616ed08a39a408a21c35c9931bc

.github/workflows/releases.yml

@@ -31,7 +31,7 @@ jobs:
       - uses: actions/setup-python@v6
         name: Install Python
         with:
-          python-version: '3.11'
+          python-version: '3.12'
 
       - name: Install Hatch
         uses: pypa/hatch@257e27e51a6a5616ed08a39a408a21c35c9931bc

.github/workflows/test.yml

@@ -23,23 +23,23 @@ jobs:
 
     strategy:
       matrix:
-        python-version: ['3.11', '3.12', '3.13']
+        python-version: ['3.12', '3.13', '3.14']
         dependency-set: ["minimal", "optional"]
         os: ["ubuntu-latest"]
         include:
-          - python-version: '3.11'
+          - python-version: '3.12'
             dependency-set: 'optional'
             os: 'macos-latest'
 
-          - python-version: '3.13'
+          - python-version: '3.14'
             dependency-set: 'optional'
             os: 'macos-latest'
 
-          - python-version: '3.11'
+          - python-version: '3.12'
             dependency-set: 'optional'
             os: 'windows-latest'
 
-          - python-version: '3.13'
+          - python-version: '3.14'
             dependency-set: 'optional'
             os: 'windows-latest'
     runs-on: ${{ matrix.os }}
@@ -79,12 +79,12 @@ jobs:
     runs-on: ubuntu-latest
     strategy:
       matrix:
-        python-version: ['3.11', "3.13"]
+        python-version: ['3.12', "3.14"]
         dependency-set: ["upstream", "min_deps"]
         exclude:
-          - python-version: "3.13"
+          - python-version: "3.14"
             dependency-set: min_deps
-          - python-version: "3.11"
+          - python-version: "3.12"
             dependency-set: upstream
     steps:
     - uses: actions/checkout@v6

.pre-commit-config.yaml

@@ -7,7 +7,7 @@ ci:
 default_stages: [pre-commit, pre-push]
 
 default_language_version:
-  python: python3.11
+  python: python3.12
 
 repos:
   - repo: https://github.com/astral-sh/ruff-pre-commit
@@ -38,7 +38,7 @@ repos:
           - donfig
           - numcodecs
           - google-crc32c>=1.5
-          - numpy==2.1 # until https://github.com/numpy/numpy/issues/28034 is resolved
+          - numpy==2.1 # https://github.com/zarr-developers/zarr-python/issues/3780 + https://github.com/zarr-developers/zarr-python/issues/3688
           - typing_extensions
           - universal-pathlib
           - obstore>=0.5.1

changes/3546.misc.md

@@ -0,0 +1 @@
+Upgrade to spec0 compat (python 3.14 max, python 3.12 min).

docs/contributing.md

@@ -205,7 +205,7 @@ When submitting a pull request, coverage will also be collected across all suppo
 
 ### Documentation
 
-Docstrings for user-facing classes and functions should follow the [numpydoc](https://numpydoc.readthedocs.io/en/stable/format.html#docstring-standard) standard, including sections for Parameters and Examples. All examples should run and pass as doctests under Python 3.11.
+Docstrings for user-facing classes and functions should follow the [numpydoc](https://numpydoc.readthedocs.io/en/stable/format.html#docstring-standard) standard, including sections for Parameters and Examples. All examples should run and pass as doctests under Python 3.12.
 
 Zarr uses mkdocs for documentation, hosted on readthedocs.org. Documentation is written in the Markdown markup language (.md files) in the `docs` folder. The documentation consists both of prose and API documentation. All user-facing classes and functions are included in the API documentation, under the `docs/api` folder using the [mkdocstrings](https://mkdocstrings.github.io/) extension. Add any new public functions or classes to the relevant markdown file in `docs/api/*.md`. Any new features or important usage information should be included in the user-guide (`docs/user-guide`). Any changes should also be included as a new file in the `changes` directory.
 

docs/index.md

@@ -21,7 +21,7 @@ Zarr-Python is a Python library for reading and writing Zarr groups and arrays.
 
 ## Installation
 
-Zarr requires Python 3.11 or higher. You can install it via `pip`:
+Zarr requires Python 3.12 or higher. You can install it via `pip`:
 
 ```bash
 pip install zarr

docs/user-guide/installation.md

@@ -4,7 +4,7 @@
 
 Required dependencies include:
 
-- [Python](https://docs.python.org/3/) (3.11 or later)
+- [Python](https://docs.python.org/3/) (3.12 or later)
 - [packaging](https://packaging.pypa.io) (22.0 or later)
 - [numpy](https://numpy.org) (2.0 or later)
 - [numcodecs](https://numcodecs.readthedocs.io) (0.14 or later)