Neovim LSP Setup + Code Completion Engine

Nitin Chaudhary — Fri, 22 Oct 2021 20:48:49 +0000

Overview

One of the cool feature that came with Neovim 0.5 is Language Server Protocol (LSP) support which allows to code more effectively as well as easily.

What is Language Server Protocol

LSP is a protocol which is used by a language server (eg: clangd, typescript-language-server) to communicate with client.
Now, the question raises is what is a language server too.
So a language server is a local server which provides suggestions to your client(in our case neovim) while you are writing the code.
As we go forward, i think the definition will become more clearer.

Setting up LSP

I have been using nvim-lspconfig from beginning as it provides the list of all available LSPs for different languages and how exactly to install and configure them. But first let's install the nvim-lspconfig plugin itself:

-- Packer.nvim
use 'neovim/nvim-lspconfig'

" vim-plug
Plug 'neovim/nvim-lspconfig

Now let's see an example of how to install a language server.

As of now, let's see for typescript language. For .ts you can install tsserver using the below command:

npm install -g typescript-language-server

Let's start configuring the server . So if you have gone through nvim-lspconfig LSP List and found tsserver, then we already know its quite easy to setup. Below is the snippet you can use to configure.

require'lspconfig'.tsserver.setup{}

We just need to put this line in either init.lua or any .lua file which is sourced when neovim starts up.

Finally, we have our LSP installed and configured, but we don't see any suggestion or any code completions when we open a .ts file in a project. Now for the code completions, i am currently using nvim-cmp which is quite extensible and customizable plugin. So, let's first install this plugin:

-- Packer.nvim
use 'hrsh7th/cmp-nvim-lsp'
Plug 'hrsh7th/cmp-buffer'
Plug 'hrsh7th/nvim-cmp'

-- vim-plug
Plug 'hrsh7th/cmp-nvim-lsp'
Plug 'hrsh7th/cmp-buffer'
Plug 'hrsh7th/nvim-cmp'

For configuring up code completion engine (nvim-cmp), you can either refer to the documentation from above link (which is quite extensive) or you can just use the below code snippet to make it work

cmp.setup {
   -- As currently, i am not using any snippet manager, thus disabled it.
      -- snippet = {
         --   expand = function(args)
            --     require("luasnip").lsp_expand(args.body)
            --   end,
         -- },

      mapping = {
         ["<C-d>"] = cmp.mapping.scroll_docs(-4),
         ["<C-f>"] = cmp.mapping.scroll_docs(4),
         ["<C-e>"] = cmp.mapping.close(),
         ["<c-y>"] = cmp.mapping.confirm {
            behavior = cmp.ConfirmBehavior.Insert,
            select = true,
         },
      },
      formatting = {
         format = lspkind.cmp_format {
            with_text = true,
            menu = {
               buffer   = "[buf]",
               nvim_lsp = "[LSP]",
               path     = "[path]",
            },
         },
      },

      sources = {
         { name = "nvim_lsp"},
         { name = "path" },
         { name = "buffer" , keyword_length = 5},
      },
      experimental = {
         ghost_text = true
      }
}

All the snippets, mapping, formatting and sources part in the above code snippet is expalained nicely in the plugin's documentation.

For above code to work, you also have to install lspkind which provides awesome icons in the code completions.

After setting up this much, you would start getting this kind of awesome popups which you can use to make the cool auto completions and much more.

NOTE:

For LSP setup, you can checkout primeagen's lsp video. It's an year old, but its quite good for first time.
For code completion engine nvim-cmp, tj has just released a TakeTuesday video: nvim-cmp which is super informative and it goes quite deep into the customizations too.

Thank you for reading :)

My Vim Journey :)

Nitin Chaudhary — Sat, 08 Aug 2020 01:42:44 +0000

This all started when the pandemic began and we started working from home. At that time, I thought of learning something cool which would allow me to upskill my editing ability as well as becoming a good developer.

So one of my teammates told me about Vim and all of the good stuff about it!! I knew about Vim but the only thing I knew was opening it by mistake and then trying to quit it (which I think is most of the new guys 🤣).

I started seeing some screencasts and videos on youtube videos to see what all the fuss is about. After seeing all features of vim, I thought of giving it a try!! (Thank God I did this! 😆).
After setting up Vim and using it felt a bit different and difficult at the same time. But as I started using it in most of my development work like in Xcode using XVim2, Chrome using Vimium, and Vim with its awesome plugins, I got a hang of it. Then as I was progressing, my teammate told me about this great book Practical Vim. So I started going through all the exercises and code in it, and as I was trying everything I got excited to see how I can do my previous work in no time using this modal editing which is like a whole new realm for me.

After learning all this (after 1.5 months), I started using vim for my office work too, and I saw a huge time gap between the work that previously used to take hours but now took mere minutes. 😄

While I was seeing all the screencast and talks from youtube, I got to know about this Vim Screencast pl by Greg Hurrell. As I went through this playlist, I got to know about how cool the vim is and how I can even optimize my workflow even more.

For me, the journey has just started as I am still trying to learn out vim every week for making my work fun, easy, and efficient!

Thank you all reading!! 😄 🙃 😊
(PS: This is my first ever post on any kind of technical thing)

Forem: Nitin Chaudhary

Neovim LSP Setup + Code Completion Engine

Overview

What is Language Server Protocol

Setting up LSP

My Vim Journey :)