Skip to content

emacs-lsp/lsp-pyright

Repository files navigation

lsp-pyright

Build Status License MELPA Join the chat at https://gitter.im/emacs-lsp/lsp-mode

Table of Contents

lsp-mode client leveraging Pyright language server

Quickstart

(use-package lsp-pyright
  :ensure t
  :hook (python-mode . (lambda ()
                          (require 'lsp-pyright)
                          (lsp))))  ; or lsp-deferred

Configuration

lsp-pyright supports the following configuration. Each configuration is described in detail in Pyright Settings.

  • pyright.disableLanguageServices via lsp-pyright-disable-language-services
  • pyright.disableOrganizeImports via lsp-pyright-disable-organize-imports
  • pyright.disableTaggedHints via lsp-pyright-disable-tagged-hints
  • python.analysis.autoImportCompletions via lsp-pyright-auto-import-completions
  • python.analysis.diagnosticMode via lsp-pyright-diagnostic-mode
  • python.analysis.logLevel via lsp-pyright-log-level
  • python.analysis.autoSearchPaths via lsp-pyright-auto-search-paths
  • python.analysis.extraPaths via lsp-pyright-extra-paths
  • python.pythonPath via lsp-pyright-locate-python
  • python.venvPath via lsp-pyright-venv-path

Projects can be further configured using pyrightconfig.json file. For further details please see Pyright Configuration.

Choosing the correct version of Python

lsp-pyright will try its best to select the correct version of the python executable to use. It will do so by iteratively executing different search functions, going from most precise to most general.

The list and order of the list can be modified by customizing lsp-pyright-python-search-functions. By default the order is:

  • Look for a parent directory with a virtual-environment named .venv or venv via lsp-pyright--locate-python-venv.
  • Look for a python executable on your PATH via lsp-pyright--locate-python-python.