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

Explain automatic parentheses management better

Browse Source
This commit is contained in:
Łukasz Langa 2018-05-16 15:26:36 -07:00
parent 8c74d7901f
commit 665ed8a240
1 changed files with 13 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

14
README.md
View File

@ -340,7 +340,19 @@ interesting cases:
In those cases, parentheses are removed when the entire statement fits In those cases, parentheses are removed when the entire statement fits
in one line, or if the inner expression doesn't have any delimiters to in one line, or if the inner expression doesn't have any delimiters to
further split on. Otherwise, the parentheses are always added. further split on. If there is only a single delimiter and the expression
starts or ends with a bracket, the parenthesis can also be successfully
omitted since the existing bracket pair will organize the expression
neatly anyway. Otherwise, the parentheses are added.
Please note that *Black* does not add or remove any additional nested
parentheses that you might want to have for clarity or further
code organization. For example those parentheses are not going to be
removed:
```py3
return not (this or that)
decision = (maybe.this() and values > 0) or (maybe.that() and values < 0)
```
### Call chains ### Call chains