v22.1.0

Compare Source

At long last,Black is no longer a beta product! This is the first non-beta release
and the first release covered by our new
stability policy.

Highlights

• Remove Python 2 support (#​2740)
• Introduce the--preview flag (#​2752)

Style

• Deprecate--experimental-string-processing and move the functionality under
  --preview (#​2789)
• For stubs, one blank line between class attributes and methods is now kept if there's
  at least one pre-existing blank line (#​2736)
• Black now normalizes string prefix order (#​2297)
• Remove spaces around power operators if both operands are simple (#​2726)
• Work around bug that causes unstable formatting in some cases in the presence of the
  magic trailing comma (#​2807)
• Use parentheses for attribute access on decimal float and int literals (#​2799)
• Don't add whitespace for attribute access on hexadecimal, binary, octal, and complex
  literals (#​2799)
• Treat blank lines in stubs the same inside top-levelif statements (#​2820)
• Fix unstable formatting with semicolons and arithmetic expressions (#​2817)
• Fix unstable formatting around magic trailing comma (#​2572)

Parser

• Fix mapping cases that contain as-expressions, likecase {"key": 1 | 2 as password}
  (#​2686)
• Fix cases that contain multiple top-level as-expressions, likecase 1 as a, 2 as b
  (#​2716)
• Fix call patterns that contain as-expressions with keyword arguments, like
  case Foo(bar=baz as quux) (#​2749)
• Tuple unpacking onreturn andyield constructs now implies 3.8+ (#​2700)
• Unparenthesized tuples on annotated assignments (e.g
  values: Tuple[int, ...] = 1, 2, 3) now implies 3.8+ (#​2708)
• Fix handling of standalonematch() orcase() when there is a trailing newline or a
  comment inside of the parentheses. (#​2760)
• from __future__ import annotations statement now implies Python 3.7+ (#​2690)

Performance

• Speed-up the new backtracking parser about 4X in general (enabled when
  --target-version is set to 3.10 and higher). (#​2728)
• Black is now compiled withmypyc for an overall 2x
  speed-up. 64-bit Windows, MacOS, and Linux (not including musl) are supported. (#​1009,
  #​2431)

Configuration

• Do not accept bare carriage return line endings in pyproject.toml (#​2408)
• Add configuration option (python-cell-magics) to format cells with custom magics in
  Jupyter Notebooks (#​2744)
• Allow setting custom cache directory on all platforms with environment variable
  BLACK_CACHE_DIR (#​2739).
• Enable Python 3.10+ by default, without any extra need to specify
  --target-version=py310. (#​2758)
• Make passingSRC or--code mandatory and mutually exclusive (#​2804)

Output

• Improve error message for invalid regular expression (#​2678)
• Improve error message when parsing fails during AST safety check by embedding the
  underlying SyntaxError (#​2693)
• No longer color diff headers white as it's unreadable in light themed terminals
  (#​2691)
• Text coloring added in the final statistics (#​2712)
• Verbose mode also now describes how a project root was discovered and which paths will
  be formatted. (#​2526)

Packaging

• All upper version bounds on dependencies have been removed (#​2718)
• typing-extensions is no longer a required dependency in Python 3.10+ (#​2772)
• Setclick lower bound to8.0.0 (#​2791)

Integrations

• Update GitHub action to support containerized runs (#​2748)

Documentation

• Change protocol in pip installation instructions tohttps:// (#​2761)
• Change HTML theme to Furo primarily for its responsive design and mobile support
  (#​2793)
• Deprecate theblack-primer tool (#​2809)
• Document Python support policy (#​2819)