Unverified Commit 33e2b440 authored by Jelle Zijlstra's avatar Jelle Zijlstra Committed by GitHub
Browse files

Add --experimental-string-processing to future changes (#2273)

* add esp to future style

* changelog

* fix label
parent 7f138c11
Loading
Loading
Loading
Loading
+1 −0
Changes for CHANGES.md: 1 added line, 0 removed lines.
Original line number Diff line number Diff line
@@ -23,6 +23,7 @@

### Documentation

- `--experimental-string-processing` will be enabled by default in the future (#2273)
- Fix typos discovered by codespell (#2228)
- Fix Vim plugin installation instructions. (#2235)
- Add new Frequently Asked Questions page (#2247)
+2 −0
Changes for docs/the_black_code_style/current_style.md: 2 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -250,6 +250,8 @@ If you are adopting _Black_ in a large project with pre-existing string conventi
you can pass `--skip-string-normalization` on the command line. This is meant as an
adoption helper, avoid using this for new projects.

(labels/experimental-string)=

As an experimental option (can be enabled by `--experimental-string-processing`),
_Black_ splits long strings (using parentheses where appropriate) and merges short ones.
When split, parts of f-strings that don't need formatting are converted to plain
+7 −0
Changes for docs/the_black_code_style/future_style.md: 7 added lines, 0 removed lines.
Original line number Diff line number Diff line
@@ -33,3 +33,10 @@ with \

Although when the target version is Python 3.9 or higher, _Black_ will use parentheses
instead since they're allowed in Python 3.9 and higher.

## Improved string processing

Currently, _Black_ does not split long strings to fit the line length limit. Currently,
there is [an experimental option](labels/experimental-string) to enable splitting
strings. We plan to enable this option by default once it is fully stable. This is
tracked in [this issue](https://github.com/psf/black/issues/2188).