Create the 2024 stable style

[JelleZijlstra]

Closes #4042.

Replacing #4064. I need a branch in this repo instead of my fork so I can create an alpha release from it.

This should mostly become the stable style. parenthesize_conditional_expressions and wrap_long_dict_values_in_parens should be reverted unless the issues currently open for them (listed in #4042) are fixed.

[github-actions]

diff-shades reports zero changes comparing this PR (a646358) to main (8fe602b).

---

What is this? | Workflow run | diff-shades documentation

[JelleZijlstra]

@hauntsaninja @cooperlees I think this is ready to go, I'll merge it soon unless you have any objections.

After this is merged, I'd also like to add the --unstable style (#4093) so that Black 24 can start its life with a meaningful preview style.

[cooperlees]

All looks good to me - I tried to look for typos etc. and couldn't find any.

Going to trust a lot of conversation I didn't part take in.

Assuming the diff shades changes are expected.

[hauntsaninja]

The changelog claims Black standardised on a single newline after module docstrings. However, this is false.

~/dev/black main λ cat z.py
"""
fdf
"""

def foo(): ...
~/dev/black main λ black --check z.py --diff
--- z.py	2024-01-25 07:04:18.399496+00:00
+++ z.py	2024-01-25 07:08:38.133709+00:00
@@ -1,5 +1,6 @@
 """
 fdf
 """
 
+
 def foo(): ...
would reformat z.py

Oh no! 💥 💔 💥
1 file would be reformatted.

I think it could be nice for what the changelog says to be true. I can keep the change ready. Thoughts?

Edit: okay, I missed #4027, this is intentional. I can just submit a PR updating the changelog then

[MichaReiser]

I believe there's a mistake in the changelog or the flag here is a leftover. The changelog mentions that the hex normalisation shipped, but the preview flag still exists in the code.

[JelleZijlstra]

Oops, you're right. I must have confused myself somewhere. I guess this preview feature will have to wait another year.