Use TOML syntax for tox configuration

[redeboer]

Possible since Tox v4.21.0, see https://tox.wiki/en/4.21.0/config.html#pyproject-toml-native. Example:

[tool.tox]
requires = ["tox>=4.19"]
env_list = ["3.13", "3.12", "type"]

[tool.tox.env_run_base]
description = "Run test under {base_python}"
commands = [["pytest"]]

[tool.tox.env.type]
description = "run type check on code base"
deps = ["mypy==1.11.2", "types-cachetools>=5.5.0.20240820", "types-chardet>=5.0.4.6"]
commands = [["mypy", "src{/}tox"], ["mypy", "tests"]]

Tasks

Preview Give feedback

1. VSCode extension is outdated tamasfe/taplo#624
   +0
2. Merge tox.ini into pyproject.toml with legacy method #409
   5 of 18
   🔨 Maintenance 🖱️ DX +2
   
3. Define tox.ini to pyproject.toml converter
4. Set minimal tox version to v4.21.0
5. Investigate problems with base key

Related PRs

Preview Give feedback

1. MAINT: update lock files ampform#447
   🔨 Maintenance +1
   
2. MAINT: update lock files ampform-dpd#149
   🔨 Maintenance +1
   
3. MAINT: update lock files benchmarks#27
   🔨 Maintenance +1
   
4. MAINT: update lock files compwa.github.io#302
   🔨 Maintenance +1
   
5. MAINT: update lock files demo#42
   🔨 Maintenance +1
   
6. MAINT: update lock files gluex-nstar#109
   🔨 Maintenance +1
   
7. https://github.com/ComPWA/gluex-nstar-analysis/pull/78
8. https://github.com/ComPWA/K-matrix-research/pull/102
9. https://github.com/ComPWA/Nstar-docs/pull/29
10. MAINT: update lock files polarimetry#372
    🔨 Maintenance +1
    
11. https://github.com/ComPWA/PWA-JPsi2pbarSigmaKS/pull/113
12. MAINT: update lock files PWA-pages#230
    🔨 Maintenance +1
    
13. MAINT: update lock files report#27
    🔨 Maintenance +1
    
14. MAINT: update lock files qrules#315
    🔨 Maintenance +1
    
15. MAINT: update lock files sphinx-hep-pdgref#44
    🔨 Maintenance +1
    
16. DX: convert Tox config to native TOML strong2020-salamanca#45
    🔨 Maintenance 🖱️ DX +2
    
17. MAINT: update lock files tensorwaves#538
    🔨 Maintenance +1
    
18. MAINT: update lock files RUB-EP1/pawian-tools#57
    🔨 Maintenance +1
    

[redeboer]

Closing this for now until tox configs supports native TOML syntax.

[redeboer]

Since tox v4.21.0, it should be possible to merge the job definitions under tox.ini into pyproject.toml 🎉

[redeboer]

The commands key in the native pyproject.toml configuration uses nested arrays. Since we set Taplo to sort arrays, we would have to use Rules to prevent the commands key from being sorted. In .taplo.toml:

[[rule]]
include = ["**/pyproject.toml"]
keys = ["tool.tox"]

[rule.formatting]
reorder_arrays = false

Rules are a new feature in Taplo v0.9 though, which is not yet available in VS Code, see tamasfe/taplo#624. So long as that is not the case, we get situations where a configuration like

[tool.tox.env.example]
commands = [
    ["pytest", "--no-header"],
]

is autoformatted as

[tool.tox.env.example]
commands = [
    ["--no-header", "pytest"],
]