Skip/Exclude One Combination of Matrix

[mgeorge-is]

Hello all,

I have a matrix setup like this:

[[tool.hatch.envs.tests.matrix]]
python = ["3.11", "3.12", "3.13"]
numpy = ["np1.26", "np2.0", "np2.1", "np2.2"]
[tool.hatch.envs.tests.overrides]
matrix.numpy.dependencies = [
    { value = "numpy==1.26.*", if = ["np1.26"] },
    { value = "numpy==2.0.*", if = ["np2.0"] },
    { value = "numpy==2.1.*", if = ["np2.1"] },
    { value = "numpy==2.2.*", if = ["np2.2"] },
]

This works fine but I would like to skip a single combination (python = ["3.13"], numpy = ["np1.26"]) when the platform is windows. It seems like this may be possible with overrides but I cannot figure out the correct syntax. Appreciate any advice!

[ofek]

I don't think there is a nicer way than https://hatch.pypa.io/latest/config/environment/advanced/#name-overrides currently. So in your case something like:

[tool.hatch.envs.tests.overrides]
name.'^py3\.13-np1\.26$'.platforms = ["linux", "macos"]

[grst]

I have a similar problem, where I'd like to run against pre-release dependencies only for the latest version of Python.

Following your example and @flying-sheep's solution in #603 (comment), I tried

[[tool.hatch.envs.hatch-test.matrix]]
deps = ["stable"]
python = ["3.10", "3.13"]

[tool.hatch.envs.hatch-test.overrides]
name.'^py3\.13.*$'.deps = ["stable", "pre"]
matrix.deps.env-vars = [
  { key = "UV_PRERELEASE", value = "allow", if = [
    "pre",
  ] },
]

But hatch env show --internal fails with

ValueError: Untyped option `tool.hatch.envs.hatch-test.py3.13-stable.overrides.name.^py3\.13.*$.deps` must be defined as a table with a `value` key

in that case. Do you have any suggestion what I need to change?

[ofek]

What are you trying to do with the first part?

[grst]

What I would like to achieve is

• for python != latest -> one environment per python version
• for python == latest -> two environments, a "normal" one like for the other python versions and a second one with UV_PRERELEASE=allow to test against pre-release dependencies.

I hope that clarifies it :)

[ofek]

[[tool.hatch.envs.hatch-test.matrix]]
deps = ["stable", "pre"]
python = ["3.13"]

[[tool.hatch.envs.hatch-test.matrix]]
deps = ["stable"]
python = ["3.10", "3.11", "3.12"]

[tool.hatch.envs.hatch-test.overrides]
matrix.deps.env-vars = [
  { key = "UV_PRERELEASE", value = "allow", if = [
    "pre",
  ] },
]

[grst]

That works, thank you!

[flying-sheep]

Oooh I only used one [[tool.hatch.envs.hatch-test.matrix]] entry so long that I didn’t think about it being an array. Neat!