Pyink Changelog

January 2, 2026 · View on GitHub

All notable changes to Pyink are recorded here.

Unreleased

This release is based on Black v25.12.0.

This release is based on Black v24.10.0.

Add CLI option --pyink-ipynb-unicode-escape for unicode escaping characters in serialized .ipynb files.
Fix a dependency to the wrong Black version in pyproject.toml.

This release is based on Black v24.10.0.

Add CLI option --pyink-ipynb-indentation to specify the number of spaces with which JSON content of Jupyter notebooks will be formatted.
Add CLI option --pyink-annotation-pragmas to specify a list of annotation pragmas. Whenever any of them appears in a comment that line won't be split into multiple lines or joined with any other line.
Fix formatting of Jupyter notebook cells with magic methods and any empty lines at the beginning or end of a cell.

This release is based on Black v24.8.0.

This release is based on Black v24.3.0.

Remove the previously deprecated CLI option --pyink-lines. This was replaced by --line-ranges.

This release is based on Black v23.12.1.

The CLI option --pyink-lines is now deprecated and replaced by Black's built-in option --line-ranges.
Handle more trailing pragma cases so they are ignored for line-length calculation.

This release is based on Black v23.10.0.

This release is based on Black v23.9.1.

Black v23.9.9's new concise formatting for dummy implementations from psf/black#3796 is temporarily disabled for Pyink.

Existing parentheses around strings are no longer removed if the content does not fit on a single line. This is related to https://github.com/psf/black/pull/3640 where we still want to keep the parentheses around the implicitly concatenated strings if the code already uses them, making it more obvious it's a single function argument.
--pyink-lines= now works with stdin inputs (#16).
Fixed compatibility issue on Python 3.7 (#13).

In multiline module docstrings, trailing quotes that are put on their own line are now kept on their own line. (#8)

This release is based on Black v23.3.0.

Fixed a bug where a module docstring ends with a line that's LineLength-3 to LineLength long, an extra empty line was added.
Fixed a bug when running Pyink on Python 3.8 and earlier (#3).
Do not explode immediately nested literals that have a trailing comma in the body.

This release is based on Black v23.1.0.

Temporarily disabled the following Black future style changes:
- https://github.com/psf/black/pull/2916
- https://github.com/psf/black/pull/2278
Fixed a bug in incremental formatting (--pyink_lines=) where pairs of # fmt: off/on are used outside of the line ranges.
Fixed a bug in incremental formatting (--pyink_lines=) when part of the match statement is changed.

Prefer splitting right hand side of assignment statements (see psf/black#1498, this is being upstreamed in psf/black/pull/3368).