Import sorting extension for Visual Studio Code using isort
A Visual Studio Code extension that provides import sorting using isort. The extension ships with isort=5.11.5. This extension uses Language Server Protocol (LSP) to run isort in a server like mode.
Note:
- This extension is supported for all actively supported versions of the
python language (i.e., python >= 3.7).
- The bundled
isort is only used if there is no installed version of isort found in the selected python environment.
- Minimum supported version of
isort is 5.10.1.
Usage
Once installed in Visual Studio Code, the extension will register isort as import organizer. You can use keyboard short cut shift + alt + O to trigger organize imports editor action. You can also trigger this from the quick fix available when imports are not organized.
Import sorting on save
You can enable import sorting on save for python by having the following values in your settings. This adds both import sorting and formatting (using black) on save :
"[python]": {
"editor.defaultFormatter": "ms-python.black-formatter",
"editor.formatOnSave": true,
"editor.codeActionsOnSave": {
"source.organizeImports": true
},
},
"isort.args":["--profile", "black"],
Disabling isort extension
If you want to disable isort extension, you can disable this extension per workspace in Visual Studio Code.
Settings
| Settings |
Default |
Description |
| isort.args |
[] |
Custom arguments passed to isort. E.g "isort.args" = ["--settings-file", "<file>"] |
| isort.check |
false |
Runs isort --check on open files and reports sorting issues as Hint. Update isort.severity to show sorting issues with higher severity. |
| isort.severity |
{ "W": "Warning", "E": "Hint" } |
Controls mapping of severity from isort to VS Code severity when displaying in the problems window. |
| isort.path |
[] |
Setting to provide custom isort executable. This will slow down formatting, since we will have to run isort executable every time or file save or open. Example 1: ["~/global_env/isort"] Example 2: ["conda", "run", "-n", "lint_env", "python", "-m", "isort"] |
| isort.interpreter |
[] |
Path to a python interpreter to use to run the linter server. |
| isort.importStrategy |
useBundled |
Setting to choose where to load isort from. useBundled picks isort bundled with the extension. fromEnvironment uses isort available in the environment. |
| isort.showNotification |
off |
Setting to control when a notification is shown. |
| isort.serverEnabled |
true |
Experimental setting to control running isort in a server like mode. By default we run isort behind LSP server, this setting allows users to turn off the server and run isort directly. |
Commands
| Command |
Description |
| isort: Restart |
Force re-start the isort server. |
Logging
Use Developer : Set Log Level... command from the Command Palette, and select isort from the extensions list to set the Log Level for the extension. For detailed LSP traces, add "isort.trace.server" : "verbose" to your User settings.json file.
