pixi.toml

[workspace]
preview = ["pixi-build"]
channels = ["conda-forge", "nodefaults", "https://prefix.dev/keewis-oss"]
platforms = ["win-64", "linux-64", "osx-arm64"]
requires-pixi = ">=0.63.2,!=0.68.0"

[package]
name = "xarray"
version = "9999.0.0" # dynamic versioning needs better support in pixi https://github.com/prefix-dev/pixi/issues/2923#issuecomment-2598460666 . Putting `version = "..."` here for now until pixi recommends something else.

[package.build]
backend = { name = "pixi-build-python", version = ">=0.4.4" }

[package.host-dependencies]
setuptools = "*"
setuptools_scm = "*"

[package.run-dependencies]
python = "*"
numpy = "*"
pandas = "*"

packaging = "24.2.*"
git = "*"            # needed for dynamic versioning

[dependencies]
xarray = { path = "." }

[target.linux-64.dependencies]
pydap-server = "*"

[feature.py311.dependencies]
python = "3.11.*"

[feature.py313.dependencies]
python = "3.13.*"

[feature.py314.dependencies]
python-gil = "3.14.*"

[feature.backends.dependencies]
# files
h5netcdf = "*"
h5py = "*"
hdf5 = "*"
netcdf4 = "*"
zarr = "*"
rasterio = "*"

# opendap
pydap = "*"
lxml = "*"  # Optional dep of pydap

# s3
boto3 = "*"
fsspec = "*"
aiobotocore = "*"

[feature.numba.dependencies]
numba = "*"
numbagg = "*"

[feature.dask.dependencies]
dask = "*"
distributed = "*"
iris = "*"        # depends on dask

[feature.accel.dependencies]
flox = "*"
bottleneck = "*"
numexpr = "*"
pyarrow = "*"
opt_einsum = "*"

[feature.viz.dependencies]
cartopy = "*"
matplotlib-base = "*"
nc-time-axis = "*"
seaborn = "*"

[feature.extras.dependencies]
# array
sparse = "*"
pint = "*"
array-api-strict = "*"

# algorithms
scipy = "*"
toolz = "*"

# tutorial
pooch = "*"

# calendar
cftime = "*"

[feature.extras.pypi-dependencies]
# array
jax = "*" # no way to get cpu-only jaxlib from conda if gpu is present

[feature.minimal.dependencies]
# minimal versions
python = "3.11.*"
numpy = "1.26.*"
pandas = "2.2.*"

[feature.minimum-scipy.dependencies]
scipy = "1.15.*"

[feature.min-versions.dependencies]
array-api-strict = "2.4.*" # dependency for testing the array api compat
boto3 = "1.37.*"
bottleneck = "1.4.*"
cartopy = "0.24.*"
cftime = "1.6.*"
dask-core = "2025.2.*"
distributed = "2025.2.*"
flox = "0.10.*"
# h5netcdf 1.8.0 introduced a few compatibility features with netcdf4
# https://github.com/pydata/xarray/issues/10657#issuecomment-3711095986
h5netcdf = "1.8.*"
# h5py and hdf5 tend to cause conflicts
# for e.g. hdf5 1.12 conflicts with h5py=3.1
# prioritize bumping other packages instead
h5py = "3.13.*"
hdf5 = "1.14.*"
iris = "3.11.*"
lxml = "5.3.*"             # Optional dep of pydap
matplotlib-base = "3.10.*"
nc-time-axis = "1.4.*"
# netcdf follows a 1.major.minor[.patch] convention
# (see https://github.com/Unidata/netcdf4-python/issues/1090)
netcdf4 = "1.6.*"
numba = "0.61.*"
numbagg = "0.9.*"
packaging = "24.2.*"
pint = "0.24.*"
pydap = "3.5.*"
rasterio = "1.4.*"
seaborn = "0.13.*"
sparse = "0.15.*"
toolz = "1.0.*"
zarr = "3.0.*"
pyarrow = "*"        # required by dask.dataframe


[feature.test.dependencies]
pytest = "!=9.1.0"
pytest-asyncio = "*"
pytest-cov = "*"
pytest-env = "*"
pytest-mypy-plugins = ">=4.0.0"
pytest-reportlog = "*"
pytest-timeout = "*"
pytest-xdist = "*"
pytz = "*"
hypothesis = "*"
coveralls = "*"

[feature.test.pypi-dependencies]
pytest-accept = ">=0.2.2, <0.3" # needed for task generate-aggregations

[feature.test.tasks]
test = { cmd = "pytest", description = "Run the test suite with pytest." }

# The second run of pytest is deliberate, since the first will return an error while replacing the doctests
generate-aggregations = { cmd = """python xarray/util/generate_aggregations.py &&\
! pytest --doctest-modules xarray/core/_aggregations.py --accept &&\
pytest --doctest-modules xarray/core/_aggregations.py &&\
! pytest --doctest-modules xarray/namedarray/_aggregations.py --accept  &&\
pytest --doctest-modules xarray/namedarray/_aggregations.py &&\
echo 'Aggregations generated successfully!'
""", description = "Generate module and stub file for arithmetic operators of various xarray classes." }
generate-aggregations-ci = { cmd = 'test -z "$(git status --porcelain)" && echo "Success! Generate-aggregations matches the committed tree" || echo "Failure :( . Generate-aggregations does not match the committed files"', depends-on = [
  'generate-aggregations',
  'pre-commit',
] }

[feature.doc.dependencies]
kerchunk = "*"
ipykernel = "*"
ipywidgets = "*"                   # silence nbsphinx warning
iris = "*"
ipython = "*"
jupyter_client = "*"
jupyter_sphinx = "*"
ncdata = "*"
pydata-sphinx-theme = "*"
pyproj = "*"
rich = "*"                         # for Zarr tree()
setuptools = "*"
sphinx-autosummary-accessors = "*"
sphinx-copybutton = "*"
sphinx-design = "*"
sphinx-inline-tabs = "*"
sphinx-llm = ">=0.2.1"
sphinx = ">=8,<9"
sphinxcontrib-mermaid = "*"
sphinxcontrib-srclinks = "*"
sphinx-remove-toctrees = "*"
sphinxext-opengraph = "*"
sphinxext-rediraffe = "*"
cfgrib = "*"
# use the official version once https://github.com/jupyterlite/jupyterlite-sphinx/pull/346 has been resolved
jupyterlite-sphinx = ">=0.23.0"
jupyterlite-xeus = ">=4.4.1"
make = "*"
myst-nb = ">=1.4.0,<2"

[feature.doc.tasks]
_prepare-environment = { cmd = "python create_environment.py", cwd = "doc" }
doc = { cmd = "make html", cwd = "doc", description = "Build the HTML documentation.", depends-on = [
  "_prepare-environment",
] }
doc-clean = { cmd = "make clean && make html", cwd = "doc", description = "Clean build artifacts and rebuild the HTML documentation from scratch.", depends-on = [
  "build",
  "_prepare-environment",
] }
host-static-doc = { cmd = "python -m http.server -b 127.0.0.1 -d _build/html 5455", cwd = "doc", description = "serve the static documentation" }
linkcheck = { cmd = "make linkcheck", cwd = "doc", description = "Check URLs in documentation." }


[feature.typing.dependencies]
mypy = "==1.19.1"
pyright = "*"
hypothesis = "*"
lxml = "*"
types-colorama = "*"
types-docutils = "*"
types-decorator = "*"
types-networkx = "*"
types-openpyxl = "*"
types-psutil = "*"
types-Pygments = "*"
types-python-dateutil = "*"
types-pytz = "*"
types-PyYAML = "*"
types-requests = "*"
types-setuptools = "*"
typing_extensions = "*"
pip = "*"

[feature.typing.pypi-dependencies]
types-defusedxml = "*"
types-pexpect = "*"

# pandas-stubs / scipy-stubs live in their own feature, rather than in `typing`,
# so that `test-nightly` can source them from PyPI (see the `nightly` feature)
# while every other typing env keeps the conda builds. As conda deps they pull in
# conda numpy/scipy, which conflicts with the `nightly` feature's PyPI numpy/scipy
# overrides (pixi cannot override a conda dep with a PyPI one) — that conflict is
# why the `typing` feature used to be excluded from `test-nightly` entirely.
[feature.typing-stubs.dependencies]
pandas-stubs = "<=2.3.3.251219"
scipy-stubs = ">=1.17.1.2"

[feature.typing.tasks]
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 run --all-files || true", description = "Run pre-commit hooks and linters." } # `|| true` so that this can be used as a task dependency

[feature.release.dependencies]
gitpython = "*"
cytoolz = "*"

[feature.release.tasks]
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"
black = ">=25.1.0,<26"

[feature.policy.pypi-dependencies]
xarray-minimum-dependency-policy = "*"

[feature.policy.dependencies]
python = "3.13.*"

[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 = [
    "pixi:test-py311-bare-minimum",
  ] },
]
policy-bare-min-and-scipy = [
  { task = "_check-policy", args = [
    "pixi:test-py311-bare-min-and-scipy",
  ] },
]
policy-min-versions = [
  { task = "_check-policy", args = [
    "pixi:test-py311-min-versions",
  ] },
]
[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" }

[feature.build-package.dependencies]
vcs_versioning = "*"
cytoolz = "*"

[feature.build-package.tasks]
prepare-recipe = { cmd = "python ci/recipe/prepare_recipe.py", cwd = "." }
build-package = { cmd = "pixi publish --path ci/recipe/pixi.toml --target-dir dist/", cwd = ".", depends-on = [
  "prepare-recipe",
] }

[tasks]
build-and-host-doc = [
  { task = "build" },
  { task = "doc" },
  { task = "host-static-doc" },
]

[feature.numpydoc-lint.dependencies]
numpydoc = "*"

[feature.numpydoc-lint.tasks]
numpydoc-lint = { cmd = "python ci/numpydoc-public-api.py" }

[feature.nodask.constraints]
dask-core = "<0.0a0"

[feature.nightly.dependencies]
python = "*"

[environments]
# Testing
# test-just-xarray = { features = ["test"] } # https://github.com/pydata/xarray/pull/10888/files#r2511336147
test-py313 = { features = [
  "py313",
  "test",
  "backends",
  "accel",
  "numba",
  "dask",
  "viz",
  "extras",
] }
test-py314-no-numba = { features = [
  "py314",
  "test",
  "backends",
  "accel",
  "dask",
  "viz",
  "extras",
] }
test-py314-no-dask = { features = [
  "py314",
  "nodask",
  "test",
  "backends",
  "accel",
  "numba",
  "viz",
  "extras",
] }
test-py314 = { features = [
  "py314",
  "test",
  "backends",
  "accel",
  "numba",
  "dask",
  "viz",
  "extras",
] }

test-py311 = { features = [
  "py311",
  "test",
  "backends",
  "accel",
  "numba",
  "dask",
  "viz",
  "extras",
] }

test-py311-with-typing = { features = [
  "py311",
  "test",
  "backends",
  "accel",
  "numba",
  "dask",
  "viz",
  "extras",
  "typing",
  "typing-stubs",
] }

test-py314-with-typing = { features = [
  "py314",
  "test",
  "backends",
  "accel",
  "numba",
  "dask",
  "viz",
  "extras",
  "typing",
  "typing-stubs",
] }

test-py311-bare-minimum = { features = ["test", "minimal"] }
test-py311-bare-min-and-scipy = { features = [
  "test",
  "minimal",
  "minimum-scipy",
] }
test-py311-min-versions = { features = [
  "test",
  "minimal",
  "minimum-scipy",
  "min-versions",
] }


# Extra
typing = { features = ["typing", "typing-stubs"] }
doc = { features = [
  "doc",
  "backends",
  "test",
  "accel",
  "viz",
  "extras",
  "numba",
] }
pre-commit = { features = ["pre-commit"], no-default-feature = true }
release = { features = ["release"], no-default-feature = true }
default = { features = [
  "py313",
  "test",
  "backends",
  "accel",
  "numba",
  "dask",
  "viz",
  "extras",
  "dev",
] }
policy = { features = ["policy"], no-default-feature = true }
numpydoc-lint = { features = ["numpydoc-lint"] }
tools = { features = ["tools"], no-default-feature = true }
build-package = { features = [
  "build-package",
  "release",
], no-default-feature = true }
test-nightly = { features = ["nightly"], no-default-feature = true }