Setting up nimlsp ======= Sublime -------First you need a LSP client, the one that's been tested is https://github.com/tomv564/LSP. It's certainly not perfect, but it works well enough.

Once you have it installed you'll want to grab NimLime as well. NimLime can perform many of the same features that nimlsp does, but we're only interested in syntax highlighting and some definitions. If you know how to disable the overlapping features or achieve this in another way please update this section.

Now in order to set up LSP itself enter it's settings and add this:

{
   "clients":
   {
      "nim":
      {
         "command":
         [
            "<path to nimlsp>/nimlsp" // This can be changed if you put nimlsp in your PATH
         ],
         "enabled": true,
         "env":
         {
            "PATH": "<home directory>/.nimble/bin" // To be able to find nimsuggest, can be changed if you have nimsuggest in your PATH
         },
         "languageId": "nim",
         "scopes":
         [
            "source.nim"
         ],
         "syntaxes":
         [
            "Packages/NimLime/Syntaxes/Nim.tmLanguage"
         ]
      }
   },
   // These are mostly for debugging feel free to remove them
   // If you build nimlsp without debug information it doesn't
   // write anything to stderr
   "log_payloads": true,
   "log_stderr": true
}

To use nimlsp in Vim install the prabirshrestha/vim-lsp plugin and dependencies:

Plugin 'prabirshrestha/asyncomplete.vim'
Plugin 'prabirshrestha/async.vim'
Plugin 'prabirshrestha/vim-lsp'
Plugin 'prabirshrestha/asyncomplete-lsp.vim'

Then set it up to use nimlsp for Nim files:

if executable('nimlsp')
   au User lsp_setup call lsp#register_server({
     \ 'name': 'nimlsp',
     \ 'cmd': {server_info->['nimlsp']},
     \ 'whitelist': ['nim'],
     \ })
endif

let g:lsp_log_verbose = 1
let g:lsp_log_file = expand('/tmp/vim-lsp.log')

" for asyncomplete.vim log
let g:asyncomplete_log_file = expand('/tmp/asyncomplete.log')

let g:asyncomplete_auto_popup = 0

function! s:check_back_space() abort
    let col = col('.') - 1
    return !col || getline('.')[col - 1]  =~ '\s'
endfunction

inoremap <silent><expr> <TAB>
  \ pumvisible() ? "\<C-n>" :
  \ <SID>check_back_space() ? "\<TAB>" :
  \ asyncomplete#force_refresh()
inoremap <expr><S-TAB> pumvisible() ? "\<C-p>" : "\<C-h>"

This configuration allows you to hit Tab to get auto-complete, and to call various functions to rename and get definitions. Of course you are free to configure this any way you'd like.

Not too many at the moment unfortunately, but they can be run with:

nimble test