Considering Ruff over Black

[Avasam]

This PR explores using Ruff format in place of Black.

The main advantages are:

• speed (there is a small, but noticeable difference when running pre-commit on the entire repo, for example)
• Simplified configs and docs (only because we already use Ruff)
• 1 less dependency
• Arguably better formatting in some areas (especially where a comment previously prevented a line-wrap)

Eventually scripts could also be simplified as Ruff would be run using a single command astral-sh/ruff#8232

Disadvantages:

• Likely not yet as "stable" as Black across versions
• Long standing collaboration between typeshed and Black (and overlap in maintainers)
• wrapping of lines with type comments may be undesirable to some Mypy (type) directives no longer relevant after running isort check astral-sh/ruff#10516

[Avasam]

Ruff is so fast and fixers are already run on these files as part of the generator scripts, I feel like this isn't even necessary.
I just kept if for now to have an apples-to-apples comparison.

[zanieb]

Exciting to see this! Note we added the formatter to our versioning policy and it should be quite stable!

[JelleZijlstra]

I don't see much advantage in this change, though as a maintainer of Black I might be biased. I don't think formatting speed is a bottleneck for us.

[srittau]

For the moment, I also prefer to keep black for formatting.

1. Slightly different formatting introduces unnecessary churn.
2. black is a PSF project.
3. Due to black's maintainer structure, it might arguably be easier for typeshed to influence stub formatting decisions in black than in ruff.

[hauntsaninja]

Having to manually move type comments around isn't a good sign. Black basically just totally leaves those alone. Also note that ruff formatter currently relies on Black for its style. Black has historically collaborated with typeshed to determine Black's pyi style, so there's sort of a healthy collaboration / feedback loop there. I don't think there's much advantage here.

[github-actions]

According to mypy_primer, this change has no effect on the checked open source code. 🤖🎉

[Avasam]

Thanks everyone for your feedback and additional context. I had an inkling about a sentiment towards keeping black, but I couldn't be sure without trying or asking.

I'll close this PR, but if you have any other opinion you'd like to share, feel free to do so here.