X-Git-Url: https://git.madduck.net/etc/vim.git/blobdiff_plain/dd5777af0671e0657531236cbad3bb423fbd2b2d..3b2297f6fdf5915f8d5409d6e7bb1fb92eb26bc4:/README.md diff --git a/README.md b/README.md index edf187f..afc9e8e 100644 --- a/README.md +++ b/README.md @@ -71,6 +71,7 @@ black {source_file_or_directory} black [OPTIONS] [SRC]... Options: + -c, --code TEXT Format the code passed in as a string. -l, --line-length INTEGER How many characters per line to allow. [default: 88] -t, --target-version [py27|py33|py34|py35|py36|py37|py38] @@ -647,11 +648,11 @@ $ where black 3. Open External tools in PyCharm/IntelliJ IDEA On macOS: - + ```PyCharm -> Preferences -> Tools -> External Tools``` On Windows / Linux / BSD: - + ```File -> Settings -> Tools -> External Tools``` 4. Click the + icon to add a new external tool with the following values: @@ -676,6 +677,38 @@ $ where black - Working directory: `$ProjectFileDir$` - Uncheck "Auto-save edited files to trigger the watcher" + + +### Wing IDE + +Wing supports black via the OS Commands tool, as explained in the Wing documentation on [pep8 formatting](https://wingware.com/doc/edit/pep8). The detailed procedure is: + +1. Install `black`. + +```console +$ pip install black +``` + +2. Make sure it runs from the command line, e.g. + +```console +$ black --help +``` + +3. In Wing IDE, activate the **OS Commands** panel and define the command **black** to execute black on the currently selected file: + +- Use the Tools -> OS Commands menu selection +- click on **+** in **OS Commands** -> New: Command line.. + - Title: black + - Command Line: black %s + - I/O Encoding: Use Default + - Key Binding: F1 + - [x] Raise OS Commands when executed + - [x] Auto-save files before execution + - [x] Line mode + +4. Select a file in the editor and press **F1** , or whatever key binding you selected in step 3, to reformat the file. + ### Vim Commands and shortcuts: @@ -951,7 +984,11 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). ## Change Log -### 19.3b1 +### 19.5b0 + +* remove unnecessary parentheses around `yield` expressions (#834) + +* add parentheses around long tuples in unpacking assignments (#832) * don't produce invalid code for `from` ... `import` blocks with comments (#829) @@ -961,6 +998,8 @@ More details can be found in [CONTRIBUTING](CONTRIBUTING.md). * fix feature detection for trailing commas in function definitions and call sites (#763) +* add `black -c` as a way to format code passed from the command line (#761) + * fix bug that led *Black* format some code with a line length target of 1 (#762)