Awesome
NeoRoot.lua
This project is now deprecated
Changing your project root (i.e. global current-directory, see :h current-directory
)
just for grepping files, showing less files on your file tree is not a good practice.
If you once did this, you misused Vim.
(To achieve the same result, you should always call :tcd
instead.)
Besides this, I will recommend you trying my new project session plugin: https://github.com/nyngwang/suave.lua, which follows this good practice:
Never touch the global current-directory unless you want to change to another project.
and it's designed to help you restore your project with ease. (Now supports restoring colorscheme, too)
DEMO
New Intro. (updated 2022/04/19)
With NeoRoot.lua, you will be able to:
- Before starting NeoVim, first navigate to your project root(can be modified later)
- Run
nvim .
to start your NeoVim. NowNeoRoot
will enterproj-mode
(see below) with the path you runnvim .
as the root - During development, you can temporarily change the
cwd
to your current buffer. - During development, you can temporarily re-define your project root. For example:
~/.config
. (shorthand~
,../
s are supported!- if you want to change back to
../somewhere/MyProj/
, just leave the prompt blank and hit Enter. Simple!
- if you want to change back to
Old Promo.
Now you won't have a hard time :cd
to the right place to see more files before executing commands that takes your current working directory into account
(i.e. you need to go up some levels to make tools like rg
/fd
to "see" more files).
You can also change your project root in the runtime, without typing any command, anymore!
Features
- No dependencies
- No requirements
- free
- Light-weight, ~100 lines
Compatibility
- Work with
- glepnir/dashboard-nvim
- numToStr/FTerm.nvim
- kyazdani42/nvim-tree.lua
- ibhagwan/fzf-lua, highly recommended
Setup
Packer.nvim
local NOREF_NOERR_TRUNC = { noremap = true, silent = true, nowait = true }
use {
'nyngwang/NeoRoot.lua',
config = function()
require('neo-root').setup {
CUR_MODE = 2 -- 1 for file/buffer mode, 2 for proj-mode
}
end
}
vim.cmd'au BufEnter * NeoRoot'
vim.keymap.set('n', '<Leader>p', function() vim.cmd('NeoRootSwitchMode') end, NOREF_NOERR_TRUNC)
vim.keymap.set('n', '<Leader>pre', function() vim.cmd('NeoRootChange') end, NOREF_NOERR_TRUNC)
Hint
To see your current working directory, simply call NeoRootSwitchMode
twice.
TODO list
- Add installation guide in README.md
- packer.nvim
- Customizable
- keymappings
- ignore list