deoplete-rtags

Deoplete external source for c/c++/objc[++] using rtags.

Use deoplete.nvim asynchronous autocompletion together with rtags symbols database.

Current project status:

Proof of concept 💥

requrements

• neovim
• deoplete.nvim
• rtags

recomended setup

• Make sure your project is CMake driven
• Install deoplete.nvim
• Install this plugin
• Install rtags
• Create CMake compilation database

mkdir your/build/directory
cd your/build/directory
cmake -DCMAKE_EXPORT_COMPILE_COMMANDS=ON your/project/root

• Run rtags server in separate terminal

rdm

• Run rtags client and ask server to use provided compilation database (this will allow you to use completions based on files in your project and all libraries mentioned in CMakeLists.txt)

  -J flag will tell rtags server to load compile_commands.json from provided directory

rc -J your/build/directory

• You are ready to go just open file in your project and start typing. Sugesstions will pop up automatically thanks to deoplete.nvim.

aim of project

• create CMake compatibile autocompletion solution for neovim
• use client-server architecture based on rtags
• provide sugestions as you type with help of deoplete
• create zero configuration plugin that will just work for any CMake project

related plugins

• vim-rtags - you can use this plugin to browse your codebase using rtags
• deoplete-clang - orginal inspiration and reference implementation