Highlights
This release fixes a longstanding confusing behavior in Black's GitHub action, where the
version of the action did not determine the version of Black being run (issue #3382). In
addition, there is a small bug fix around imports and a number of improvements to the
preview style.
Please try out the
preview style
with black --preview and tell us your feedback. All changes in the preview style are
expected to become part of Black's stable style in January 2024.
Stable style
- Import lines with
# fmt: skipand# fmt: offno longer have an extra blank line
added when they are right after another import line (#3610)
Preview style
- Add trailing commas to collection literals even if there's a comment after the last
entry (#3393) async def,async for, andasync withstatements are now formatted consistently
compared to their non-async version. (#3609)withstatements that contain two context managers will be consistently wrapped in
parentheses (#3589)- Let string splitters respect East Asian Width
(#3445) - Now long string literals can be split after East Asian commas and periods (
、U+3001
IDEOGRAPHIC COMMA,。U+3002 IDEOGRAPHIC FULL STOP, &，U+FF0C FULLWIDTH COMMA)
besides before spaces (#3445) - For stubs, enforce one blank line after a nested class with a body other than just
...(#3564) - Improve handling of multiline strings by changing line split behavior (#1879)
Parser
- Added support for formatting files with invalid type comments (#3594)
Integrations
- Update GitHub Action to use the version of Black equivalent to action's version if
version input is not specified (#3543) - Fix missing Python binary path in autoload script for vim (#3508)
Documentation
- Document that only the most recent release is supported for security issues;
vulnerabilities should be reported through Tidelift (#3612)