Merge branch 'main' into async-dtreec

Author: aladinor

.github/workflows/ci-additional.yaml

@@ -214,7 +214,7 @@ jobs:
         uses: Parcels-code/pixi-lock/restore@9a2866f8258b87a3c616d5ad7d51c6cd853df78b
         with:
           cache-key: ${{ needs.cache-pixi-lock.outputs.cache-key }}
-      - uses: prefix-dev/setup-pixi@v0.9.3
+      - uses: prefix-dev/setup-pixi@v0.9.4
         with:
           pixi-version: ${{ needs.cache-pixi-lock.outputs.pixi-version }}
           cache: true

.github/workflows/ci.yaml

@@ -103,7 +103,7 @@ jobs:
         uses: Parcels-code/pixi-lock/restore@9a2866f8258b87a3c616d5ad7d51c6cd853df78b
         with:
           cache-key: ${{ needs.cache-pixi-lock.outputs.cache-key }}
-      - uses: prefix-dev/setup-pixi@v0.9.3
+      - uses: prefix-dev/setup-pixi@v0.9.4
         with:
           pixi-version: ${{ needs.cache-pixi-lock.outputs.pixi-version }}
           cache: true

.github/workflows/hypothesis.yaml

@@ -84,7 +84,7 @@ jobs:
         uses: Parcels-code/pixi-lock/restore@9a2866f8258b87a3c616d5ad7d51c6cd853df78b
         with:
           cache-key: ${{ needs.cache-pixi-lock.outputs.cache-key }}
-      - uses: prefix-dev/setup-pixi@v0.9.3
+      - uses: prefix-dev/setup-pixi@v0.9.4
         with:
           pixi-version: ${{ needs.cache-pixi-lock.outputs.pixi-version }}
           cache: true

.github/workflows/upstream-dev-ci.yaml

@@ -141,7 +141,7 @@ jobs:
         uses: Parcels-code/pixi-lock/restore@9a2866f8258b87a3c616d5ad7d51c6cd853df78b
         with:
           cache-key: ${{ needs.cache-pixi-lock.outputs.cache-key }}
-      - uses: prefix-dev/setup-pixi@v0.9.3
+      - uses: prefix-dev/setup-pixi@v0.9.4
         with:
           pixi-version: ${{ needs.cache-pixi-lock.outputs.pixi-version }}
           cache: true

.readthedocs.yaml

@@ -18,7 +18,7 @@ build:
       - (git --no-pager log --pretty="tformat:%s" -1 | grep -vqF "[skip-rtd]") || exit 183
       - git fetch --unshallow || true
     install:
-      - pixi install -e doc
+      - pixi install --concurrent-solves 2 -e doc
     build:
       html:
         - pixi run doc BUILDDIR=$READTHEDOCS_OUTPUT

doc/conf.py

@@ -54,6 +54,7 @@
     "sphinx.ext.mathjax",
     "sphinx.ext.napoleon",
     "jupyter_sphinx",
+    "myst_parser",
     "nbsphinx",
     "sphinx_autosummary_accessors",
     "sphinx.ext.linkcode",

doc/contribute/contributing.rst

@@ -208,7 +208,7 @@ development environment:
 
 That's it! Now you're ready to contribute to Xarray.
 
-Pixi defines multiple environments as well as tasks to help you with development. These include tasks for:
+Pixi defines multiple environments as well as tasks to help you with development (view these by running ``pixi task list``). These include tasks for:
 
 - running the test suite
 - building the documentation
@@ -221,16 +221,10 @@ are only run in a single environment (e.g., building the documentation or runnin
 
 You can see all available environments and tasks by running::
 
-    pixi list
+    pixi info
 
-For example:
 
-- ``pixi run doc`` will build the documentation
-- ``pixi run mypy`` will run the static type checker
-- ``pixi run test`` will run the test suite
-- ``pixi run pre-commit`` will run all code formatters and linters - defined via the pre-commit hooks
-
-When running ``pixi run test`` you will be prompted to select which environment you want to use. You can specify the environment
+When running a test you may be prompted to select which environment you want to use. You can specify the environment
 directly by providing the ``-e`` flag, e.g., ``pixi run -e my_environment test`` . Our CI setup uses Pixi as well - you can easily
 reproduce CI tests by running the same tasks in the same environments as defined in the CI.
 

doc/whats-new.rst

@@ -6,14 +6,51 @@
 What's New
 ==========
 
-.. _whats-new.2026.02.0:
+.. _whats-new.2026.03.0:
 
-v2026.02.0 (unreleased)
+v2026.03.0 (unreleased)
 -----------------------
 
 New Features
 ~~~~~~~~~~~~
 
+
+Breaking Changes
+~~~~~~~~~~~~~~~~
+
+
+Deprecations
+~~~~~~~~~~~~
+
+
+Bug Fixes
+~~~~~~~~~
+
+
+Documentation
+~~~~~~~~~~~~~
+
+
+Internal Changes
+~~~~~~~~~~~~~~~~
+
+
+.. _whats-new.2026.02.0:
+
+v2026.02.0 (Feb 13, 2026)
+-------------------------
+
+This release adds support for 1D coordinates in NDPointIndex for scattered point
+indexing, switches all deprecation warnings to FutureWarning for better end-user
+visibility, fixes silent data corruption when writing dask arrays to sharded Zarr
+stores, and improves chunked array tokenization performance.
+
+Thanks to the 11 contributors to this release:
+Antonio Valentino, Chris Barker, Christine P. Chai, Deepak Cherian, Ewan Short, Harikrishna KP, Ian Hunt-Isaak, Julia Signell, Justus Magin, Kristian Kollsgård and Nick Hodgskin
+
+New Features
+~~~~~~~~~~~~
+
 - Added ``max_concurrency`` parameter to :py:func:`open_datatree` to control
   the maximum number of concurrent I/O operations when opening groups in parallel
   with the Zarr backend (:pull:`10742`).
@@ -33,42 +70,77 @@ Breaking Changes
   switches to using ``FutureWarning`` everywhere (:pull:`11112`).
   By `Julia Signell <https://github.com/jsignell>`_.
 
-Deprecations
-~~~~~~~~~~~~
-
-
 Bug Fixes
 ~~~~~~~~~
 
-- Fix slicing with negative step (:issue:`11000` and :pull:`11044`).
+- Fix slicing with negative step (:issue:`11000`, :pull:`11044`).
   By `Antonio Valentino <https://github.com/avalentino>`_.
 - Fix ``.plot`` error when using positional args with ``col`` and
-  ``row`` (:issue:`11104` :pull:`11111`).
+  ``row`` (:issue:`11104`, :pull:`11111`).
   By `Julia Signell <https://github.com/jsignell>`_.
-- Slightly amend `Xarray's Zarr Encoding Specification doc <https://docs.xarray.dev/en/latest/internals/zarr-encoding-spec.html>`_ for clarity, and provide a code comment in ``xarray.backends.zarr._get_zarr_dims_and_attrs`` referencing the doc (:issue:`8749` :pull:`11013`).
+- Slightly amend `Xarray's Zarr Encoding Specification doc <https://docs.xarray.dev/en/latest/internals/zarr-encoding-spec.html>`_
+  for clarity, and provide a code comment in
+  ``xarray.backends.zarr._get_zarr_dims_and_attrs`` referencing the doc
+  (:issue:`8749`, :pull:`11013`).
   By `Ewan Short <https://github.com/eshort0401>`_.
 - Fix silent data corruption when writing dask arrays to sharded Zarr stores.
   Dask chunk boundaries must now align with shard boundaries, not just internal
-  Zarr chunk boundaries (:issue:`10831`).
+  Zarr chunk boundaries (:issue:`10831`, :pull:`11117`).
+  By `Kristian Kollsgård <https://github.com/kkollsga>`_.
 - Fix :py:meth:`Dataset.sortby` and :py:meth:`DataArray.sortby` placing NaN values
-  at the beginning instead of the end when using ``ascending=False`` (:issue:`7358`).
+  at the beginning instead of the end when using ``ascending=False``
+  (:issue:`7358`, :pull:`11118`).
   By `Kristian Kollsgård <https://github.com/kkollsga>`_.
 - Raise :py:class:`FileNotFoundError` instead of a confusing ``ValueError`` when
   :py:func:`open_dataset` is called with a non-existent local file path
-  (:issue:`10896`).
+  (:issue:`10896`, :pull:`11150`).
   By `Kristian Kollsgård <https://github.com/kkollsga>`_.
+- Improve error message when a chunk manager is not available, suggesting how
+  to install the required package (:pull:`11056`).
+  By `Julia Signell <https://github.com/jsignell>`_.
+- Raise :py:class:`ValueError` on slice-based selection of multi-index levels,
+  which previously returned silently wrong results (:issue:`10534`, :pull:`11168`).
+  By `Harikrishna KP <https://github.com/Mr-Neutr0n>`_.
 
 Documentation
 ~~~~~~~~~~~~~
+- Add support for myst markdown (:pull:`11167`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
 
+- Update docstrings for pandas 3 compatibility (:pull:`11130`).
+  By `Julia Signell <https://github.com/jsignell>`_.
+- Various Numpydoc fixes (:pull:`11122`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
+- Correct wording mistakes in documentation (:pull:`11120`, :pull:`11127`).
+  By `Christine P. Chai <https://github.com/star1327p>`_.
+- Fix broken links in documentation (:pull:`11115`, :pull:`11135`, :pull:`11161`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
+- Fix "latest" version displayed on landing page (:pull:`11119`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
+- Add descriptions for pixi tasks (:pull:`11155`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
+- Update :py:func:`open_zarr` ``decode_cf`` docstring (:pull:`11165`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
+- Add MyST Markdown support for documentation (:pull:`11167`).
+  By `Nick Hodgskin <https://github.com/VeckoTheGecko>`_.
 
 Performance
 ~~~~~~~~~~~
 
+- Add a fast path that skips normalized chunks during tokenization (:pull:`11017`).
+  By `Julia Signell <https://github.com/jsignell>`_.
 
 Internal Changes
 ~~~~~~~~~~~~~~~~
 
+- Temporarily silence shape assignment warnings raised in ``netCDF4``
+  (:pull:`11146`).
+  By `Justus Magin <https://github.com/keewis>`_.
+- Add osx-64 to the pixi configuration (:pull:`11137`).
+  By `Chris Barker <https://github.com/ChrisBarker-NOAA>`_.
+- Preserve string dtypes instead of converting to object where possible (:pull:`11152`).
+  By `Julia Signell <https://github.com/jsignell>`_.
+
 
 .. _whats-new.2026.01.0:
 

pixi.toml

@@ -212,7 +212,7 @@ hypothesis = "*"
 coveralls = "*"
 
 [feature.test.tasks]
-test = { cmd = "pytest" }
+test = { cmd = "pytest", description = "Run the test suite with pytest." }
 
 [feature.doc.dependencies]
 kerchunk = "*"
@@ -239,10 +239,11 @@ sphinx-remove-toctrees = "*"
 sphinxext-opengraph = "*"
 sphinxext-rediraffe = "*"
 cfgrib = "*"
+myst-parser = "*"
 
 [feature.doc.tasks]
-doc = { cmd = "make html", cwd = "doc" }
-doc-clean = { cmd = "make clean && make html", cwd = "doc" }
+doc = { cmd = "make html", cwd = "doc", description = "Build the HTML documentation." }
+doc-clean = { cmd = "make clean && make html", cwd = "doc", description = "Clean build artifacts and rebuild the HTML documentation from scratch." }
 linkcheck = { cmd = "make linkcheck", cwd = "doc", description = "Check URLs in documentation." }
 
 
@@ -270,20 +271,20 @@ types-defusedxml = "*"
 types-pexpect = "*"
 
 [feature.typing.tasks]
-mypy = "mypy --install-types --non-interactive --cobertura-xml-report mypy_report"
+mypy = { cmd = "mypy --install-types --non-interactive --cobertura-xml-report mypy_report", description = "Run mypy type checking and generate a Cobertura XML report." }
 
 [feature.pre-commit.dependencies]
 pre-commit = "*"
 
 [feature.pre-commit.tasks]
-pre-commit = { cmd = "pre-commit" }
+pre-commit = { cmd = "pre-commit", description = "Run pre-commit hooks and linters." }
 
 [feature.release.dependencies]
 gitpython = "*"
 cytoolz = "*"
 
 [feature.release.tasks]
-release-contributors = "python ci/release_contributors.py"
+release-contributors = { cmd = "python ci/release_contributors.py", description = "Generate a list of contributors for a release." }
 
 [feature.dev.dependencies]
 ipython = ">=9.8.0,<10"
@@ -298,35 +299,47 @@ xarray-minimum-dependency-policy = "*"
 [feature.policy.dependencies]
 python = "3.13.*"
 
-[feature.policy.tasks.check-policy]
+[feature.policy.tasks._check-policy]
 cmd = "minimum-versions validate --policy ci/policy.yaml --manifest-path pixi.toml {{ env }}"
 args = ["env"]
 
 [feature.policy.tasks]
 policy-bare-minimum = [
-  { task = "check-policy", args = [
+  { task = "_check-policy", args = [
     "pixi:test-py311-bare-minimum",
   ] },
 ]
 policy-bare-min-and-scipy = [
-  { task = "check-policy", args = [
+  { task = "_check-policy", args = [
     "pixi:test-py311-bare-min-and-scipy",
   ] },
 ]
 policy-min-versions = [
-  { task = "check-policy", args = [
+  { task = "_check-policy", args = [
     "pixi:test-py311-min-versions",
   ] },
 ]
-policy = [
-  { task = "check-policy", args = [
+[feature.policy.tasks.policy]
+
+depends-on = [
+  { task = "_check-policy", args = [
     """\
     pixi:test-py311-bare-minimum \
     pixi:test-py311-bare-min-and-scipy \
     pixi:test-py311-min-versions \
     """,
   ] },
 ]
+description = "Check all minimum version test environments match Xarray's version policy."
+
+[feature.tools.dependencies]
+python = "3.13.*"
+
+[feature.tools.pypi-dependencies]
+rst-to-myst = { version = "*", extras = ["sphinx"] }
+
+[feature.tools.tasks]
+rst2myst = { cmd = "rst2myst", description = "Convert rst to myst markdown" }
 
 [environments]
 # Testing
@@ -440,3 +453,4 @@ default = { features = [
   "dev",
 ] }
 policy = { features = ["policy"], no-default-feature = true }
+tools = { features = ["tools"], no-default-feature = true }

xarray/backends/zarr.py

@@ -1593,7 +1593,7 @@ def open_zarr(
     mask_and_scale=True,
     decode_times=True,
     concat_characters=True,
-    decode_coords=True,
+    decode_coords: Literal["coordinates", "all"] | bool = True,
     drop_variables=None,
     consolidated=None,
     overwrite_encoded_chunks=False,
@@ -1661,9 +1661,17 @@ def open_zarr(
         form string arrays. Dimensions will only be concatenated over (and
         removed) if they have no corresponding variable and if they are only
         used as the last dimension of character arrays.
-    decode_coords : bool, optional
-        If True, decode the 'coordinates' attribute to identify coordinates in
-        the resulting dataset.
+    decode_coords : bool or {"coordinates", "all"}, optional
+        Controls which variables are set as coordinate variables:
+
+        - "coordinates" or True: Set variables referred to in the
+          ``'coordinates'`` attribute of the datasets or individual variables
+          as coordinate variables.
+        - "all": Set variables referred to in  ``'grid_mapping'``, ``'bounds'`` and
+          other attributes as coordinate variables.
+
+        Only existing variables can be set as coordinates. Missing variables
+        will be silently ignored.
     drop_variables : str or iterable, optional
         A variable or list of variables to exclude from being parsed from the
         dataset. This may be useful to drop variables with problems or