Change8

Black

Dev Tools

The uncompromising Python code formatter

Latest: 26.3.18 releases3 breaking changes4 common errorsView on GitHub

Release History

26.3.12 fixes2 features
Mar 12, 2026

This release focuses on stability improvements for Jupyter notebook magic handling and enhances security and configuration options for the blackd service, including cache path hashing.

26.3.07 fixes2 features
Mar 6, 2026

This release introduces winloop support for faster performance on Windows and fixes several stability and parsing issues across stable and preview styles. It also hardens requirement parsing in the GitHub Action.

26.1.0Breaking4 fixes11 features
Jan 18, 2026

This release introduces the 2026 stable style, bringing numerous formatting improvements and fixes, and updates the underlying ignore logic to precisely match Git's behavior regarding `.gitignore` patterns.

26.1a13 fixes8 features
Dec 8, 2025

Black introduces a preview of the 2026 stable style with several new formatting options and bug fixes, while remaining backward compatible.

25.12.0Breaking8 fixes3 features
Dec 8, 2025

Black 25.12.0 drops Python 3.9 support, adds several bug fixes, introduces draft 2026 style, and enhances packaging and GitHub Action integration.

25.11.07 fixes10 features
Nov 10, 2025

Black 24.x introduces Python 3.14 support, new formatting options, arm64 binaries, and a BlackD client, while fixing several comment and Vim‑related bugs.

25.9.0Breaking16 fixes7 features
Sep 19, 2025

This release drops support for Python <3.7, adds several new formatting capabilities and performance improvements, and fixes numerous crashes and edge‑case bugs.

25.1.013 fixes8 features
Jan 29, 2025

The 2025 stable style release adds numerous formatting refinements, new features like generic function definition handling and license metadata, performance improvements, and several bug fixes across stable, preview, and integration components.

Common Errors

FileNotFoundError1 report

FileNotFoundError in Black often arises when the program attempts to access a file at a specified path, but that file doesn't exist at that location. To fix this, ensure the file path used by Black (specified in command-line arguments or configuration files) is correct and that the file actually exists in the expected directory. If using prebuilt binaries, especially after extraction or installation processes, verify that all necessary files were extracted or installed successfully and are accessible in their expected locations.

GitIgnorePatternError1 report

GitIgnorePatternError usually arises from invalid patterns in your `.gitignore` file, particularly those incompatible with the pathspec library used by Black. Resolve this by carefully reviewing your `.gitignore` file, correcting or removing any malformed patterns like those with unescaped special characters or syntax errors, and then retry running Black. Using online `.gitignore` validators can help identify problematic entries.

AttributeError1 report

The `AttributeError: 'tuple' object has no attribute 'append'` in Black often arises when a function expects a mutable list but receives an immutable tuple instead, particularly when manipulating target versions. To fix this, ensure that you're converting the tuple of target versions into a list before attempting to use the `append` method; use `list(target_versions)` to create a mutable list copy.

GitWildMatchPatternError1 report

GitWildMatchPatternError in black usually arises from an invalid or malformed .gitignore entry that pathspec cannot parse. Address this by carefully reviewing your .gitignore file for any syntax errors like unbalanced quotes, trailing spaces, or unexpected characters within the patterns. Correct or remove the offending line(s) in .gitignore to resolve the error.

Related Dev Tools Packages

Subscribe to Updates

Get notified when new versions are released

RSS Feed