actions/black
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

Documentation: clarify the state of multiple context managers (#3488)

Browse Source 
Clarify that the backslash & paren-wrapping formatting for multiple
context managers aren't yet implemented.
This commit is contained in:
Yilei "Dolee" Yang 2023-01-14 09:51:59 -08:00 committed by GitHub
parent 4bee9cca55
commit f758010340
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 3 additions and 3 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

6
docs/the_black_code_style/future_style.md
View File

@ -19,7 +19,7 @@ with make_context_manager1() as cm1, make_context_manager2() as cm2, make_contex
... # nothing to split on - line too long ... # nothing to split on - line too long
``` ```
So _Black_ will eventually format it like this: So _Black_ will, when we implement this, format it like this:
```py3 ```py3
with \ with \
@ -31,8 +31,8 @@ with \
... # backslashes and an ugly stranded colon ... # backslashes and an ugly stranded colon
``` ```
Although when the target version is Python 3.9 or higher, _Black_ will use parentheses Although when the target version is Python 3.9 or higher, _Black_ will, when we
instead since they're allowed in Python 3.9 and higher. implement this, use parentheses instead since they're allowed in Python 3.9 and higher.
An alternative to consider if the backslashes in the above formatting are undesirable is An alternative to consider if the backslashes in the above formatting are undesirable is
to use {external:py:obj}`contextlib.ExitStack` to combine context managers in the to use {external:py:obj}`contextlib.ExitStack` to combine context managers in the