From 0a1f49d25882ef18665cfe904e6ab6ae9eeddbbc Mon Sep 17 00:00:00 2001 From: Yilei Yang Date: Wed, 1 Feb 2023 16:16:59 -0800 Subject: [PATCH 1/2] Document the future style changes introduced in #3489 and #3440. --- docs/the_black_code_style/future_style.md | 49 +++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/the_black_code_style/future_style.md b/docs/the_black_code_style/future_style.md index 6d289d460a7..797a631e90b 100644 --- a/docs/the_black_code_style/future_style.md +++ b/docs/the_black_code_style/future_style.md @@ -62,3 +62,52 @@ plain strings. User-made splits are respected when they do not exceed the line l limit. Line continuation backslashes are converted into parenthesized strings. Unnecessary parentheses are stripped. The stability and status of this feature is tracked in [this issue](https://github.com/psf/black/issues/2188). + +### Improved line breaks + +For assignment expressions, it now prefers to split and wrap the right side of the +assignment instead of left side. For example: + +```python +some_dict[ + "with_a_long_key" +] = some_looooooooong_module.some_looooooooooooooong_function_name( + first_argument, second_argument, third_argument +) +``` + +will be changed to: + +```python +some_dict["with_a_long_key"] = ( + some_looooooooong_module.some_looooooooooooooong_function_name( + first_argument, second_argument, third_argument + ) +) +``` + +### Improved parentheses management + +For dict literals with long values, they are now wrapped in parentheses. Unnecessary +parentheses are now removed. For example: + +```python +my_dict = { + my_dict = { + "a key in my dict": a_very_long_variable + * and_a_very_long_function_call() + / 100000.0, + "another key": (short_value), +} +``` + +will be changed to: + +```python +my_dict = { + "a key in my dict": ( + a_very_long_variable * and_a_very_long_function_call() / 100000.0 + ), + "another key": short_value, +} +``` From 52e0b2173535af692f95f811b2b30be30c7a935e Mon Sep 17 00:00:00 2001 From: Richard Si Date: Sat, 4 Feb 2023 21:33:39 -0500 Subject: [PATCH 2/2] Update docs/the_black_code_style/future_style.md --- docs/the_black_code_style/future_style.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/the_black_code_style/future_style.md b/docs/the_black_code_style/future_style.md index 797a631e90b..b2cdca2590d 100644 --- a/docs/the_black_code_style/future_style.md +++ b/docs/the_black_code_style/future_style.md @@ -65,7 +65,7 @@ tracked in [this issue](https://github.com/psf/black/issues/2188). ### Improved line breaks -For assignment expressions, it now prefers to split and wrap the right side of the +For assignment expressions, _Black_ now prefers to split and wrap the right side of the assignment instead of left side. For example: ```python