anakin-language-server

Yet another Jedi Python language server

Requirements

• Python >= 3.6
• pygls >= 1.3, <1.4
• Jedi >= 0.19
• pyflakes ~= 2.2
• pycodestyle ~= 2.5
• yapf ~=0.30

Optional requirements

• mypy

Implemented features

• textDocument/completion
• textDocument/hover
• textDocument/signatureHelp
• textDocument/definition
• textDocument/references
• textDocument/publishDiagnostics
• textDocument/documentSymbol
• textDocument/codeAction (Inline variable)
• textDocument/formatting
• textDocument/rangeFormatting
• textDocument/rename
• textDocument/documentHighlight

Initialization option

• venv - path to virtualenv. This option will be passed to Jedi's create_environment.

Also one can set VIRTUAL_ENV or CONDA_PREFIX before running anakinls so Jedi will find proper environment. See get_default_environment.

Diagnostics

Diagnostics are published on document open and save.

Diagnostics providers:

• Jedi

  See get_syntax_errors.

• pyflakes

• pycodestyle

  Server restart is needed after changing one of the configuration files.

• mypy

  Install mypy in the same environment as anakinls and set mypy_enabled configuration option.

Configuration options

Configuration options must be passed under anakinls key in workspace/didChangeConfiguration notification.

Available options:

Configuration example

Here is eglot configuration:

(defvar my/lsp-venv nil
  "Name of virtualenv.
Set it in project's dir-locals file.")

(defclass my/eglot-anakinls (eglot-lsp-server) ()
  :documentation
  "Own eglot server class.")

(cl-defmethod eglot-initialization-options ((_server my/eglot-anakinls))
  "Pass initialization param to anakinls."
  `(:venv ,(when my/lsp-venv
             (expand-file-name
              (concat "~/.virtualenvs/" my/lsp-venv)))))

;; Add this server to eglot programs to handle python-mode and run `anakinls'
(add-to-list 'eglot-server-programs
             '(python-mode my/eglot-anakinls "anakinls"))

;; Also treat UnusedVariable as error
(setq-default eglot-workspace-configuration
              '((:anakinls :pyflakes_errors ["UndefinedName" "UnusedVariable"])))

Installation

pip install anakin-language-server

Development

pip install pre-commit
pre-commit install