vim-liq

vim-liq is a vim client for the Language Server Protocol (LSP). vim-liq stands for something along the lines of vim- "Language IQ" or "Lingustic Intelligence".

This project is in a beta state and may not be suitable for general use. But for those willing to tinker a bit it might be worth a try :-).

Features

The following high level, LSP, features have support:

1. Completion
2. References
3. Diagnostics
4. Definition
5. Symbols

Currently the following languages are supported:

1. python

For more information see doc/vim-liq.txt or help vim-liq from whitin vim.

Requirements

• Vim 8, or later, with support for:
  • python (2.7)
  • autocommands
  • quickfix
  • timers
  • async calls
  • possibly more without me knowing it?
• python > 2.7 (for running the python language server)

Installation

The instruction below is only tested on osX and Linux.

Installation is done by downloading an extracting a release bundle, example:

mkdir -p ~/.vim/pack/plugins/start
cd ~/.vim/pack/plugins/start
wget https://github.com/kristopher-h/vim-liq/releases/download/v0.1.2-beta/vim-liq.tgz
tar xzf vim-liq.tgz

Note

Do not use git clone to clone the repo as that will leave you without any LSP servers. For more information see the DEVELOMPENT.rst.

Upgrading

To upgrade vim-liq simply remove the old vim-liq folder and redo the installation. Example:

cd ~/.vim/pack/plugins/start
rm -r vim-liq

After that follow the installation instruction again.

Usage

The plugin by default map the following keybindings:

CTRL-Space => completion (insert mode)
. => completion (insert mode)
LEADER-d => goto definition (normal mode)
LEADER-f => find references (normal mode)

For more doc/vim-liq.txt or run "help vim-liq" from whitin vim.

Credits

Credits go to the following projects, without which it would have been much harder to create this.

• jedi-vim (https://github.com/davidhalter/jedi-vim/)
• python-language-server (https://github.com/palantir/python-language-server)
• language-server-protocol (https://github.com/Microsoft/language-server-protocol/)
• LanguageClient-neovim (https://github.com/autozimu/LanguageClient-neovim)
• vim-plugin-starter-kit (https://github.com/JarrodCTaylor/vim-plugin-starter-kit)
• Pathogen (https://github.com/tpope/vim-pathogen)

License

GPLv3 or later.