Hapa yameorodheshwa matoleo 4 ya Black, kuanzia 7 Oktoba 2024 hadi toleo la sasa 26.10.1. Kila moja lina kiungo cha faili za kisakinishi za mchapishaji mwenyewe.
matoleo 4 katika miaka 2 · takriban 2 kwa mwaka
| Toleo | Tarehe | Ukubwa | Faili |
|---|---|---|---|
| 26.10.1Toleo jipya zaidi | 10 Oktoba 2026 | — | 64-bit Portable Maelezo ya toleoHighlights
This release fixes a security issue in Black's bundled GitHub Action. Repositories that
use the action are encouraged to update to the latest version of Black immediately. This
update is received automatically when using psf/black@stable, and is independent of
the version of Black installed by the action.
When the GitHub Action reads version specifiers from tool.black.required-version, it
now only accepts released versions of Black, as it already did for black requirements
in dependency lists. Other values, such as URL references, are now rejected. This issue
has been registered as GHSA-cg8m-r9f2-5wm2; a CVE identifier is pending.
Stable style
- Fix a long Jupyter notebook assignment magic (for example x = !ls -la) being wrapped
in parentheses, which IPython can no longer run; such cells are now left unchanged
(#5481)
- Keep repeated lines outside the selected --line-ranges unchanged (#5436)
- Fix --line-ranges formatting lines that follow a statement when formatting joins or
re-indents that statement (#5484)
- Fix --line-ranges crashing with an internal error when an unselected statement has a
# fmt: skip comment on the last line before a closing bracket (#5477)
- Prevent moving an encoding declaration (for example # -*- coding: latin-1 -*-) onto
the first two lines of a file (#5487)
- Fix adding an extra trailing blank line inside a multi-line module docstring when its
last line is near the line length limit (#5494)
Preview style
- Do not split short expressions on delimiters (such as binary operators, comparisons,
or comprehensions) inside brackets when preceded by a standalone comment (#5455)
- Fix the unstable string_processing feature removing backslash-newline sequences from
raw strings, which changed their value (#5482)
- Avoid adding unnecessary parentheses around unbreakable right-hand side expressions in
assignments (such as annotated assignments or subscript targets) (#5473)
- Parenthesize expressions with parameter comments when they exceed the line length
under --preview (#5442)
- Fix wrap_long_dict_values_in_parens dropping the parentheses around a right-hand
side that contains a dictionary, leaving a line over the length limit (#5492)
- Fix the unstable string_processing feature adding a space after * or ** in a PEP
695 type parameter (* Ts = ...) when it splits a string in the parameter's default
(#5504)
- Avoid unnecessary line splits of trailers (such as indexing/subscripts) when an
earlier bracket split exceeds the line length only due to a trailing comment (#5498)
Configuration
- Add --cache-dir to configure the cache directory from the command line (#5433)
- Don't cache a file as formatted after formatting or checking it with --line-ranges,
which made a later full black --check pass and black skip the unformatted lines
(#5476)
- Respect a .gitignore that starts with a UTF-8 byte order mark. The mark became part
of the first pattern, so that pattern never matched and Black formatted files that git
ignores (#5497)
Performance
- Avoid quadratic runtime when splitting very long lines with many trailing bracket
pairs (such as consecutive subscripts) (#5475)
Integrations
- Fix the GitHub Action crashing on dependency-group includes when use_pyproject is
enabled (#5479)
- When the GitHub Action reads version specifiers from tool.black.required-version, it
now only accepts released versions of Black, as it already did for black
requirements in dependency lists. Other values, such as URL references, are now
rejected. (#5510) |
| 26.5.1 | 18 Mei 2026 | — | 64-bit Portable Maelezo ya toleoStable style
- Fix unstable formatting of annotated assignments whose subscript annotation contains
an inline comment (e.g. x: list[ # pyright: ignore[...]) (#5130)
- Preserve inline comments (including # type: ignore) immediately before a
# fmt: skip line, avoiding AST equivalence failures (#5139)
Packaging
- Correct the version in the published executables (#5137)
Documentation
- Add Neovim integration guide covering conform.nvim, ALE, and simple command approaches
(#5124) |
| 25.1.0 | 29 Januari 2025 | — | 64-bit Portable Maelezo ya toleoHighlights
This release introduces the new 2025 stable style (#4558), stabilizing
the following changes:
- Normalize casing of Unicode escape characters in strings to lowercase (#2916)
- Fix inconsistencies in whether certain strings are detected as docstrings (#4095)
- Consistently add trailing commas to typed function parameters (#4164)
- Remove redundant parentheses in if guards for case blocks (#4214)
- Add parentheses to if clauses in case blocks when the line is too long (#4269)
- Whitespace before # fmt: skip comments is no longer normalized (#4146)
- Fix line length computation for certain expressions that involve the power operator (#4154)
- Check if there is a newline before the terminating quotes of a docstring (#4185)
- Fix type annotation spacing between * and more complex type variable tuple (#4440)
The following changes were not in any previous release:
- Remove parentheses around sole list items (#4312)
- Generic function definitions are now formatted more elegantly: parameters are
split over multiple lines first instead of type parameter definitions (#4553)
Stable style
- Fix formatting cells in IPython notebooks with magic methods and starting or trailing
empty lines (#4484)
- Fix crash when formatting with statements containing tuple generators/unpacking
(#4538)
Preview style
- Fix/remove string merging changing f-string quotes on f-strings with internal quotes
(#4498)
- Collapse multiple empty lines after an import into one (#4489)
- Prevent string_processing and wrap_long_dict_values_in_parens from removing
parentheses around long dictionary values (#4377)
- Move wrap_long_dict_values_in_parens from the unstable to preview style (#4561)
Packaging
- Store license identifier inside the License-Expression metadata field, see
PEP 639. (#4479)
Performance
- Speed up the is_fstring_start function in Black's tokenizer (#4541)
Integrations
- If using stdin with --stdin-filename set to a force excluded path, stdin won't be
formatted. (#4539) |
| 24.10.0 | 7 Oktoba 2024 | — | 64-bit Portable |