Reword isort configuration, add --combine-as

This commit is contained in:
Łukasz Langa 2018-05-28 23:15:07 -07:00
parent d320e283aa
commit 6d924b01e4

View File

@ -204,21 +204,27 @@ If a data structure literal (tuple, list, set, dict) or a line of "from"
imports cannot fit in the allotted length, it's always split into one
element per line. This minimizes diffs as well as enables readers of
code to find which commit introduced a particular entry. This also
makes *Black* compatible with [isort](https://pypi.org/p/isort/).
makes *Black* compatible with [isort](https://pypi.org/p/isort/) with
the following configuration.
<details>
<summary>A compatible `.isort.cfg`</summary>
If you do wish to use *Black* alongside `isort`, you can pass the following
command-line arguments to ensure compatible behaviour:
```
$ isort --multi-line=3 --trailing-comma --force-grid-wrap=0 --line-width=88 [ file.py ]
```
Or use the equivalent directives in your isort config:
```
[settings]
multi_line_output=3
include_trailing_comma=True
force_grid_wrap=0
combine_as_imports=True
line_length=88
```
The equivalent command line is:
```
$ isort --multi-line=3 --trailing-comma --force-grid-wrap=0 --combine-as --line-width=88 [ file.py ]
```
</details>
### Line length
You probably noticed the peculiar default line length. *Black* defaults