⚡
nvim-compleet
This plugin is still in early development.
📖
Table of Contents
📦
Installation
nvim-compleet requires Neovim 0.7+. Also, since the Rust code has to be compiled it needs the rustup toolchain to be available (follow this guide for instructions on how to install Rust) with rustc version 1.58+, together with the make and ar utilities.
Then installing the plugin is as easy as
require("packer").startup(function()
use({
"noib3/nvim-compleet",
config = function()
require("compleet").setup()
end,
run = "./install.sh release",
})
end)
🚀
Features
Config validation
🔧
Configuration
nvim-compleet is configured by passing a table to the setup function. The default config is
require('compleet').setup({
ui = {
menu = {
-- Where to anchor the completion menu, either "cursor" or "match".
anchor = "cursor",
-- Whether to automatically show the menu every time there are
-- completions available.
autoshow = true,
-- The maximum height (in rows) of the completion menu.
max_height = nil,
border = {
-- Whether to add a border to the completion menu's floating window.
enable = false,
-- Any of the style formats listed in `:h nvim_open_win`.
style = "single"
},
},
details = {
border = {
-- Whether to add a border to the details's floating window.
enable = true,
-- Same as `ui.menu.border.style`.
style = {
"",
"",
"",
{" ", "CompleetDetails"},
}
},
},
hint = {
-- Whether to show completion hints.
enable = false,
}
},
completion = {
-- Whether to enable completion while deleting characters.
while_deleting = false,
},
sources = {
lipsum = {
enable = false,
},
}
})
❗
Commands
nvim-compleet provides two commands: CompleetStop{!} to stop the completion and CompleetStart{!} to restart it. The versions with the bang ! stop/start the completion in all the buffers, the ones without it only affect the current buffer.
🎹
Mappings
The following key mappings are exposed:
-
(compleet-next-completion) -
(compleet-prev-completion) -
(compleet-insert-selected-completion) -
(compleet-insert-first-completion) ui.menu.autoshowis set tofalse; -
(compleet-show-completions)
A possible configuration could be:
local compleet = require('compleet') local keymap = vim.keymap local tab = function() return (compleet.is_menu_open() and "(compleet-next-completion)" ) or (compleet.has_completions() and "(compleet-show-completions)" ) or "" end local s_tab = function() return compleet.is_menu_open() and "(compleet-prev-completion)" or "" end local right = function() return compleet.is_hint_visible() and "(compleet-insert-first-completion)" or "" end local cr = function() return compleet.is_completion_selected() and "(compleet-insert-selected-completion)" or "" end local opts = { expr = true, remap = true } keymap.set("i", "" , tab, opts) keymap.set("i", "" , s_tab, opts) keymap.set("i", "" , right, opts) keymap.set("i", "" , cr, opts)
📈
Roadmap
- Add LSP source;
- Add Filepath source;
- Add Treesitter source;
- Integrate with snippets engines;
- Stabilize api, document how to add sources in Rust, add option to provide user-defined sources in Lua;
- ...
193 Dec 28, 2022
9.3k Jan 5, 2023
272 Dec 30, 2022
4 Aug 5, 2022
4 Mar 5, 2023
34 Mar 18, 2023
66 Apr 9, 2023
189 Jun 23, 2023
690 Jun 29, 2023
655 Jul 13, 2023
3 Mar 30, 2024
12 Nov 5, 2022
16 Dec 15, 2022
113 Dec 28, 2022
8 Mar 2, 2023
8 Apr 2, 2023
6 Apr 4, 2023
189 Aug 1, 2023
9 Aug 7, 2023