FZTerm

This plugin is deprecated, see One term

Idea

FZTerm is my attempt at a fuzzy finder plugin, using a floating terminal and basically nothing else. The basic idea is to make it fully customizable, the plugins provides the basic framework and a few implementations. The only dependencies are bat, fzf and ag, but the framework is still usable without them.

Usage

• Implemented commands : (can be called with the vim command or lua require'fzterm'.xxx(), xxx being the function called)

| Vim command | Summary | Respects g:fzterm_ignore | function called | | ----------- | ------------------------ | -------------------------- | --------------- | | :Files | Lists files in pwd | Yes | files | | :GFiles | Lists git-files | No | gitFiles | | :Buffers | Lists open buffers | No | buffers | | :Branches | Lists git branches and lets you checkout to the selected one | No | branch | | :Ag | Searches files with the silver searcher | Yes | ag | | :Rg | Searches files with Ripgrep | Yes | rg | | :FilesOrGFiles | Runs :Files or :GFiles depending on the presence of a .git directory at vim's pwd | No | filesOrGitFiles | | :Commits | Lists git commits and shows you details | No | commits | | :Blame | Runs git blame on the file and lets you search the lines, displaying commit details in preview window | No | blame | | :Commit | Runs git commit in the preview window | No | commit | | :DocumentSymbols | Gets document symbols from neovim's built-in lsp | No | documentSymbols | | :WorkspaceSymbols | Gets workspace symbols from neovim's built-in lsp | No | workspaceSymbols | | :References | Gets references to keyword under the cursor from neovim's built-in lsp | No | references | | :Mappings | Fuzzy search for nvim mappings | No | mappings | | :Colors | Fuzzy search colorschemes and use the selected one | No | colors | | :Ranger | Browse files using ranger and open one in the current window | No | ranger |

• You can use the basic commands by simply calling them or mapping them, for example nnoremap <leader>f :Files<CR>.

Configuration

• The g:fzterm_ignore can be used to ignore files, for example let g:fzterm_ignore = {'.git', 'node_modules'}
• The window's geometry can be configured using the following global variables:
  • g:fzterm_width sets the absolute width in columns
  • g:fzterm_height sets the absolute height in lines
  • g:fzterm_width_ratio is the ratio between the floating window width and the editor window's (default is "0.75")
  • g:fzterm_height_ratio is the ratio between the floating window height and the editor window's (default is "0.75")
  • g:fzterm_margin_left is the ratio of the editor window left as a margin on the left side of the floating window (default is "0.25")
  • g:fzterm_margin_top is the ratio of the editor window top as a margin on the top side of the floating window (default is "0.25")
  • For example, here is the config for a window that would span the whole width, half the height and would be docked at the bottom :

  let g:fzterm_width_ratio = "1"
  let g:fzterm_height_ration = "0.5"
  let g:fzterm_margin_left = "0"
  let g:fzterm_margin_top = "0.5"
  

• The g:fzterm_disable_com variable can be set to true to disable all built-in commands. If you set this, you will need to manually configure your commands : command Files lua require'fzterm'.files()

Extensions

• The plugins provides the fzterm function, accessible via lua require'fzterm'.fzterm()
• The function takes 5 arguments, the first 3 are shell commands :
  • pre_cmd, the command that will be piped into fzf or any fuzzy finder you choose (see 'matcher' arg)
  • post_cmd, the command the result is piped into, if empty or false the result is simply opened in a new buffer
  • matcher, what pre_cmd is piped into, usually fzf with args (default is fzf --preview -m 'bat --color=always -n {}')
  • internal changes the way pre_cmd is ran : if true, pre_cmd can be a vim command and will be executed in the current buffer
  • edit_cmd is the command ran by neovim to open the result(s) (default is "edit")
• For example, here would be the code to change rg to a basic find for the :Files command :
  • lua :

   local fzterm = require'fzterm'
   fzterm.files = function()
     local pre_cmd = "find ."
     fzterm.fzterm(pre_cmd)
   end
  

  • For vimscript, you would wrap the code block into :

  lua << EOF
    CODE_HERE 
  EOF
  

• To use them in an init.vim, you can add something like this :

  command FilesExcludeHidden :lua require'fzterm'.fzterm('rg --files .')