From d80ce36dfade8ad9a8555a4e0bc7fe96169217e2 Mon Sep 17 00:00:00 2001 From: felix-hilden Date: Fri, 24 Jun 2022 10:33:11 +0300 Subject: [PATCH] Update preview docs for #2926, #2990, #2991, #3035 --- docs/the_black_code_style/future_style.md | 26 +++++++++++++++++------ 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/docs/the_black_code_style/future_style.md b/docs/the_black_code_style/future_style.md index 8d159e9b0a2..ef8323801b8 100644 --- a/docs/the_black_code_style/future_style.md +++ b/docs/the_black_code_style/future_style.md @@ -52,25 +52,37 @@ tracked in [this issue](https://github.com/psf/black/issues/2188). ### Removing trailing newlines after code block open -_Black_ will remove trailing newlines after code block openings. That means that the -following code: +_Black_ will remove trailing newlines after code block openings. For example: ```python def my_func(): print("The line above me will be deleted!") - - print("But the line above me won't!") ``` -Will be changed to: +will be changed to: ```python def my_func(): print("The line above me will be deleted!") - - print("But the line above me won't!") ``` This new feature will be applied to **all code blocks**: `def`, `class`, `if`, `for`, `while`, `with`, `case` and `match`. + +### Improved parentheses management + +_Black_ will format parentheses around return annotations, await expressions and with +statements similarly to other sets of parentheses. For example: + +```python +with ((open("bla.txt")) as f, open("x")): + pass +``` + +will be changed to: + +```python +with open("bla.txt") as f, open("x"): + pass +```