Awesome
LSP-pyright
Python support for Sublime's LSP plugin provided through microsoft/pyright.
Installation
- Install LSP and LSP-pyright via Package Control.
- (Optional but recommended) Install the LSP-file-watcher-chokidar via Package Control to enable functionality to notify the server about new files.
- Restart Sublime.
- (Optional) Configure pyright for your
virtualenv
.
The Node.js is required by this server. If
node
is not in your$PATH
, this package will suggest to install a local Node.js runtime automatically. If you instead decide to usenode
that is already installed on your system, make sure that it's at least a version 14.
Configuration
TIP: It's recommended to additionally install the
LSP-json
package which provides validation and auto-complete forLSP-pyright
settings and thepyrightconfig.json
configuration file.
Here are some ways to configure the package and the language server.
-
From
Preferences > Package Settings > LSP > Servers > LSP-pyright
-
From the command palette
Preferences: LSP-pyright Settings
-
Project-specific configuration From the command palette run
Project: Edit Project
and add your settings in:{ "settings": { "LSP": { "LSP-pyright": { "settings": { // Put your settings here } } } } }
-
Various options can only be configured through a
pyrightconfig.json
configuration file (check Pyright configuration for more info)
Provided Command Palette commands
Command | Description |
---|---|
LSP-pyright: Create Pyright Configuration File | Creates a pyrightconfig.json file in the root of the project with basic options. Opens the configuration file if it already exists. |
Virtual environments
The plugin attempts to resolve the virtual environment automatically from well-known environment variables and workspace files.
This behavior can be disabled by explicitly setting the python interpreter in the python.pythonPath
setting.
If you want to overwrite the virtual environment, the pyrightconfig.json
file must be present at the root of your project.
This configuration file, at a minimum, should define where your Python virtualenvs are located, as well as the name of the one to use for your project:
{
"venvPath": "/path/to/virtualenvs/",
"venv": "myenv"
}
For example, if you have created a virtual environment inside the directory .venv
within the project directory then you would use:
{
"venvPath": ".",
"venv": ".venv"
}
Note that the venv
option is only supported in the pyrightconfig.json
file. The venvPath
option can also be specified in your .sublime-project, in case you don't want to hard-code a system-specific path in a shared project.
Please see Pyright Documentation for more options.