Skip to main content

Python LSP Server

image image image image

A Python 3.8+ implementation of the Language Server Protocol. (Note: versions <1.4 should still work with Python 3.6)

Installation

The base language server requires Jedi to provide Completions, Definitions, Hover, References, Signature Help, and Symbols:

pip install python-lsp-server

This will expose the command pylsp on your PATH. Confirm that installation succeeded by running pylsp --help.

If the respective dependencies are found, the following optional providers will be enabled:

  • Rope for Completions and renaming
  • Pyflakes linter to detect various errors
  • McCabe linter for complexity checking
  • pycodestyle linter for style checking
  • pydocstyle linter for docstring style checking (disabled by default)
  • autopep8 for code formatting
  • YAPF for code formatting (preferred over autopep8)
  • flake8 for error checking (disabled by default)
  • pylint for code linting (disabled by default)

Optional providers can be installed using the extras syntax. To install YAPF formatting for example:

pip install "python-lsp-server[yapf]"

All optional providers can be installed using:

pip install "python-lsp-server[all]"

If you get an error similar to 'install_requires' must be a string or list of strings then please upgrade setuptools before trying again.

pip install -U setuptools

Windows and Linux installation

If you use Anaconda/Miniconda, you can install python-lsp-server using this conda command

conda install -c conda-forge python-lsp-server

Python-lsp-server is available in the repos of every major Linux distribution, and it is usually called python-lsp-server or python3-pylsp.

For example, here is how to install it in Debian and Debian-based distributions (E.g. Ubuntu, Pop!_OS, Linux Mint)

sudo apt-get install python3-pylsp

or Fedora Linux

sudo dnf install python-lsp-server

or Arch Linux

sudo pacman -S python-lsp-server

Only on Alpine Linux the package is named differently. You can install it there by typing this command in your terminal:

apk add py3-lsp-server

3rd Party Plugins

Installing these plugins will add extra functionality to the language server:

Please see the above repositories for examples on how to write plugins for the Python LSP Server.

cookiecutter-pylsp-plugin is a cookiecutter template for setting up a basic plugin project for python-lsp-server. It documents all the essentials you need to know to kick start your own plugin project.

Please file an issue if you require assistance writing a plugin.

Configuration

Like all language servers, configuration can be passed from the client that talks to this server (i.e. your editor/IDE or other tool that has the same purpose). The details of how this is done depend on the editor or plugin that you are using to communicate with python-lsp-server. The configuration options available at that level are documented in CONFIGURATION.md.

python-lsp-server depends on other tools, like flake8 and pycodestyle. These tools can be configured via settings passed from the client (as above), or alternatively from other configuration sources. The following sources are available:

  • pycodestyle: discovered in ~/.config/pycodestyle, setup.cfg, tox.ini and pycodestyle.cfg.
  • flake8: discovered in ~/.config/flake8, .flake8, setup.cfg and tox.ini

The default configuration sources are pycodestyle and pyflakes. If you would like to use flake8, you will need to:

  1. Disable pycodestyle, mccabe, and pyflakes, by setting their corresponding enabled configurations, e.g. pylsp.plugins.pycodestyle.enabled, to false. This will prevent duplicate linting messages as flake8 includes these tools.
  2. Set pylsp.plugins.flake8.enabled to true.
  3. Change the pylsp.configurationSources setting (in the value passed in from your client) to ['flake8'] in order to use the flake8 configuration instead.

The configuration options available in these config files (setup.cfg etc) are documented in the relevant tools:

Overall configuration is computed first from user configuration (in home directory), overridden by configuration passed in by the language client, and then overridden by configuration discovered in the workspace.

As an example, to change the list of errors that pycodestyle will ignore, assuming you are using the pycodestyle configuration source (the default), you can:

  1. Add the following to your ~/.config/pycodestyle:

    [pycodestyle]
    ignore = E226,E302,E41
    
  2. Set the pylsp.plugins.pycodestyle.ignore config value from your editor

  3. Same as 1, but add to setup.cfg file in the root of the project.

Python LSP Server can communicate over WebSockets when configured as follows:

pylsp --ws --port [port]

The following libraries are required for Web Sockets support:

You can install this dependency with command below:

pip install 'python-lsp-server[websockets]'

LSP Server Features

  • Auto Completion
  • Autoimport
  • Code Linting
  • Code actions
  • Signature Help
  • Go to definition
  • Hover
  • Find References
  • Document Symbols
  • Document Formatting
  • Code folding
  • Multiple workspaces

Development

Dev install

# (optional) create conda env
conda create --name python-lsp-server python=3.11 -y
conda activate python-lsp-server

pip install -e ".[all,websockets,test]"

Run server with ws

pylsp --ws -v  # Info level logging
pylsp --ws -vv # Debug level logging

To run the test suite:

# requires: pip install ".[test]" (see above)
pytest

Running ruff as a linter and code formatter on the repo:

ruff check .  # linter
ruff check --fix .  # fix all auto-fixable lint issues
ruff format .  # format the document

After adding configuration options to schema.json, refresh the CONFIGURATION.md file with

python scripts/jsonschema2md.py pylsp/config/schema.json CONFIGURATION.md

License

This project is made available under the MIT License.

Metadata

Release files for python-lsp-server 1.10.1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for python-lsp-server 1.10.1
File Size Uploaded Provenance Actions
python-lsp-server-1.10.1.tar.gz 113.1 kB Without provenance Details for python-lsp-server-1.10.1.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for python-lsp-server 1.10.1
File Interpreter ABI Platform Actions
python_lsp_server-1.10.1-py3-none-any.whl Python 3 none any Details for python_lsp_server-1.10.1-py3-none-any.whl

Total release size: 188.5 kB

Release files / python-lsp-server-1.10.1.tar.gz

Download URL python-lsp-server-1.10.1.tar.gz
Size 113.1 kB
Tags Source
SHA-256 checksum
How to use checksums
ec4c5706af67a265a19173fe4beb3b0a2c1626fa33a15ea952c2f288798b8c0d
BLAKE2b-256 checksum
How to use checksums
60fc1779454d6fb22dcda94c2b892bdc40cfd448007a68ee57935b491891707b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.8.10

Release files / python_lsp_server-1.10.1-py3-none-any.whl

Download URL python_lsp_server-1.10.1-py3-none-any.whl
Size 75.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
564570dbf56158dd43948038b376a57324f50fb7f62c156075295aa37b390b1f
BLAKE2b-256 checksum
How to use checksums
e90268960abcc4a214af630c59d577d1d4a02e916e6bad72ababfc376a66b3c2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/5.0.0 CPython/3.8.10

Security for python-lsp-server 1.10.1

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

1.10.1 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page