# Black 25.11.0

- Product: Black (https://whatsnew.fyi/product/black)
- Vendor: Python Software Foundation
- Date: 2025-11-10
- Version: 25.11.0
- Original notes: https://github.com/psf/black/releases/tag/25.11.0
- Permalink: https://whatsnew.fyi/product/black/releases/25.11.0

What's New is an index, not a publisher: every entry below links to the vendor's own release notes, which are the authoritative source. Entries are labelled where they are hand-curated sample data, pre-releases, or drawn from a secondary source such as a developer blog.

Reuse: the summaries, labels and curation here are © What's New. Quote freely with attribution and a link back; wholesale republication of the corpus is not permitted — terms: https://whatsnew.fyi/terms. The vendors' own release notes remain their publishers'.

---

- **added** — Enable base 3.14 support
- **added** — Add support for the new Python 3.14 t-string syntax introduced by PEP 750
- **fixed** — Fix bug where comments between # fmt: off and # fmt: on were reformatted
- **changed** — Comments containing fmt directives now preserve their exact formatting instead of being normalized
- **changed** — Move multiline_string_handling from --unstable to --preview
- **fixed** — Fix bug where module docstrings would be treated as normal strings if preceded by comments
- **fixed** — Fix bug where python 3.12 generics syntax split line happens weirdly
- **changed** — Standardize type comments to form # type: <value>
- **fixed** — Fix fix_fmt_skip_in_one_liners preview feature to respect # fmt: skip for compound statements with semicolon-separated bodies
- **added** — Add no_cache option to control caching behavior
- **added** — Releases now include arm64 Linux binaries
- **changed** — Write unchanged content to stdout when excluding formatting from stdin using pipes
- **added** — Implement BlackDClient, a simple python client to send formatting requests to blackd
- **changed** — Enhance GitHub Action psf/black to support the required-version major-version-only stability format when using pyproject.toml
- **changed** — Improve error message for vim plugin users and warn on unsupported Vim and Python versions independently
- **fixed** — Vim: Fix handling of virtualenvs that have a different Python version
- **changed** — Vim: Print the import paths when importing black fails

###### Highlights

- Enable base 3.14 support (#4804)
- Add support for the new Python 3.14 t-string syntax introduced by PEP 750 (#4805)

###### Stable style

- Fix bug where comments between `# fmt: off` and `# fmt: on` were reformatted (#4811)
- Comments containing fmt directives now preserve their exact formatting instead of
  being normalized (#4811)

###### Preview style

- Move `multiline_string_handling` from `--unstable` to `--preview` (#4760)
- Fix bug where module docstrings would be treated as normal strings if preceded by
  comments (#4764)
- Fix bug where python 3.12 generics syntax split line happens weirdly (#4777)
- Standardize type comments to form `# type: <value>` (#4645)
- Fix `fix_fmt_skip_in_one_liners` preview feature to respect `# fmt: skip` for compound
  statements with semicolon-separated bodies (#4800)

###### Configuration

- Add `no_cache` option to control caching behavior. (#4803)

###### Packaging

- Releases now include arm64 Linux binaries (#4773)

###### Output

- Write unchanged content to stdout when excluding formatting from stdin using pipes
  (#4610)

###### _Blackd_

- Implemented BlackDClient. This simple python client allows to easily send formatting
  requests to blackd (#4774)

###### Integrations

- Enable 3.14 base CI (#4804)
- Enhance GitHub Action `psf/black` to support the `required-version` major-version-only
  "stability" format when using pyproject.toml (#4770)
- Improve error message for vim plugin users. It now handles independently vim version
- Vim: Warn on unsupported Vim and Python versions independently (#4772)
- Vim: Print the import paths when importing black fails (#4675)
- Vim: Fix handling of virtualenvs that have a different Python version (#4675)