Python Language Server for the Language Server Protocol
Project description
Python Language Server
A Python 2.7 and 3.4+ implementation of the Language Server Protocol.
Feature Providers
Jedi for Completions, Definitions, Hover, References, Signature Help, and Symbols
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
YAPF for code formatting
3rd Party Plugins
Installing these plugins will add extra functionality to the language server:
pyls-mypy Mypy type checking for Python 3
pyls-isort Isort import sort code formatting
Configuration
Configuration is loaded from zero or more configuration sources. Currently implemented are:
pycodestyle: discovered in ~/.config/pycodestyle, setup.cfg, tox.ini and pycodestyle.cfg.
flake8: discovered in ~/.config/flake8, setup.cfg, tox.ini and flake8.cfg
The default configuration source is pycodestyle. Change the pyls.configurationSources setting to [‘flake8’] in order to respect flake8 configuration instead.
Overall configuration is computed first from user configuration (in home directory), overridden by configuration passed in by the language client, and then overriden by configuration discovered in the workspace.
Language Server Features
Auto Completion:
Code Linting with pycodestyle and pyflakes:
Signature Help:
Go to definition:
Hover:
Find References:
Document Symbols:
Document Formatting:
Installation
pip install python-language-server
Development
To run the test suite:
pip install .[test] && tox
Develop against VS Code
The Python language server can be developed against a local instance of Visual Studio Code.
Install VSCode for Mac
From within VSCode View -> Command Palette, then type shell and run install 'code' command in PATH
# Setup a virtual env
virtualenv env
. env/bin/activate
# Install pyls
pip install .
# Install the vscode-client extension
cd vscode-client
npm install .
# Run VSCode which is configured to use pyls
# See the bottom of vscode-client/src/extension.ts for info
npm run vscode -- $PWD/../
Then to debug, click View -> Output and in the dropdown will be pyls. To refresh VSCode, press Cmd + r
License
This project is made available under the MIT License.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Hashes for python-language-server-0.13.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | a7928bb24cd670efe0a2217ed6857fd1be255a6d56021b1e8b02ac6771eea8fa |
|
MD5 | bd455407895315cd605c86ca4c080763 |
|
BLAKE2b-256 | c7bad44431d1d6346c704a1c149fa2c2057cb1d9a9ad082fd38826cc2f08549e |