From: Jonas Haag Date: Fri, 8 Sep 2023 01:35:07 +0000 (+0200) Subject: Add Black PyCharm 2023.2 integration instructions (#3839) X-Git-Url: https://git.madduck.net/etc/vim.git/commitdiff_plain/74d3009ba480a871df57197144578f1ae4016210 Add Black PyCharm 2023.2 integration instructions (#3839) --- diff --git a/docs/integrations/editors.md b/docs/integrations/editors.md index ff56306..cebe2b0 100644 --- a/docs/integrations/editors.md +++ b/docs/integrations/editors.md @@ -10,16 +10,26 @@ Options include the following: ## PyCharm/IntelliJ IDEA -There are three different ways you can use _Black_ from PyCharm: +There are several different ways you can use _Black_ from PyCharm: -1. As local server using the BlackConnect plugin -1. As external tool -1. As file watcher +1. Using the built-in _Black_ integration (PyCharm 2023.2 and later). This option is the + simplest to set up. +1. As local server using the BlackConnect plugin. This option formats the fastest. It + spins up {doc}`Black's HTTP server `, to + avoid the startup cost on subsequent formats. +1. As external tool. +1. As file watcher. -The first option is the simplest to set up and formats the fastest (by spinning up -{doc}`Black's HTTP server `, avoiding the -startup cost on subsequent formats), but if you would prefer to not install a -third-party plugin or blackd's extra dependencies, the other two are also great options. +### Built-in _Black_ integration + +1. Install `black`. + + ```console + $ pip install black + ``` + +1. Go to `Preferences or Settings -> Tools -> Black` and configure _Black_ to your + liking. ### As local server