tool.toml - 'intermediate' TOML file for (all?) pyproject.toml tool's

[the-citto]

Hi
I searched the web as much as I could but I found only similar topics, and not quite what I have in mind

clutter in pyproject.toml or in the root folder can get very messy, and you already have 3 tools :o)

I was wondering if it would make sense to add the capability to use tool.toml
my idea is that, eventually, every tool that goes in pyproject.toml could have the capability to be put in this tool.toml
I know that uv used to have a toolS.toml, and that using yet a new file with the singular will create some confusion for many, but bear with me...

currently Astral has ruff.toml uv.toml ty.toml and their equivalent [tool.ruff] [tool.uv] [tool.ty] in pyproject.toml
here my main assumption: using headers like

[ruff]
[ruff.lint]
[uv]
[ty]

[mypy]
[pytest]

the file name tool singular, being the same as in the pyproject's headers

• could make easier reusing current parsing of tables and sub-tables,
• ease the mental model for transition to it, and
• differentiate from the legacy name used for uv with plural

parsing ease assuming that something similar already happens for [tool.ruff.lint] / pyproject.toml <-> [lint] / ruff.toml etc.

if this assumptions are correct, and Astral (meaning ruff + uv + ty) is interested and leads this, other tools could have an easier path to eventually do the same (wrote some on purpose in the example)

I don't think this is something that should start from a PEP, but from the tools

[MichaReiser]

How would that be better than using pyproject.toml? Wont this lead to the same clutter when more tools start using that file?

[the-citto]

you have a point but I see it mostly as separation of concerns
dependencies, build-system, classifiers, etc. as project-level for pyproject.toml, all/most tools in their own file
nothing would prevent from using, say, [tool.uv] in pyproject and '[ruff.lint] in tool
additionally, some could decide to have a tool with lots of settings on its own (ex. tox.toml even though it's still early in its move to TOML)

I see that this could be confusing, but also the flip of the coin: you see the toml files in the root folder and their names say what they are, with the choice of in-between i.e., not too many files

[the-citto]

I just found out that much of what I'm after already happens with tox.ini
black the only I'm disappointed for using only pyproject, nobody has an '80 terminal that we need 80 chars limit :D
pyright's json... waiting for ty to replace that altogether - so fast!
recently started using uv and for now I still haven't needed configs for it
still, it wouldn't imho be that bad to be able to aggregate all Astral tools ¯\(ツ)/¯