Awesome

gentags.nvim

<a href="https://github.com/neovim/neovim/releases/v0.7.0"><img alt="require" src="https://img.shields.io/badge/require-0.7%2B-blue" /></a> <a href="https://github.com/linrongbin16/commons.nvim"><img alt="commons.nvim" src="https://img.shields.io/badge/power_by-commons.nvim-pink" /></a> <a href="https://luarocks.org/modules/linrongbin16/gentags.nvim"><img alt="luarocks" src="https://img.shields.io/luarocks/v/linrongbin16/gentags.nvim" /></a> <a href="https://github.com/linrongbin16/gentags.nvim/actions/workflows/ci.yml"><img alt="ci.yml" src="https://img.shields.io/github/actions/workflow/status/linrongbin16/gentags.nvim/ci.yml?label=ci" /></a> <a href="https://app.codecov.io/github/linrongbin16/gentags.nvim"><img alt="codecov" src="https://img.shields.io/codecov/c/github/linrongbin16/gentags.nvim/main?label=codecov" /></a> Tags generator/management for old school vimers in Neovim.

To be honest, tags have become useless in Neovim today, since we have LSP and treesitter now. While there exists gap when LSP server or treesitter implementations are insufficient, and brings it back to us as a supplement to fill the gap.

Features
Requirements
Install
Configuration
Recommendations
Alternatives
Development
Contribute

Features

Automatically run in background.
Support both workspace/single-file mode.
Full update on workspace open, incremental update on file save.
Terminate immediately on nvim leave.
Find the matching tags and load on workspace/file open.
Disk cache management and garbage collection.
Real-time status for Neovim components such as statusline.

Requirements

Neovim ≥ 0.7.
universal-ctags (default backend).

PRs are welcome to add other backends.

Install

require("lazy").setup({
  {
    "linrongbin16/gentags.nvim",
    config = function()
      require('gentags').setup()
    end,
  },
})

</details> <details> <summary>With <a href="https://github.com/lewis6991/pckr.nvim">pckr.nvim</a></summary>

require("pckr").add({
  {
    "linrongbin16/gentags.nvim",
    config = function()
      require("gentags").setup()
    end,
  },
})

</details>

Configuration

To overwrite default options, please use:

require('gentags').setup(opts)

The otps is an optional lua table that overwrites default options.

For complete options and defaults, please see configs.lua.

Recommendations

Recommend use tags with below plugins to smooth your editing flow:

vista.vim: View and search symbols on current file.
cmp-nvim-tags: Code completion data source for nvim-cmp.
fzf.vim: The Tags and BTags commands in the fzf.vim fuzzy finder.
fzf-lua: The tags, btags and other commands in the fzf-lua fuzzy finder.
telescope.nvim: The builtin.tags vim picker in the telescope fuzzy finder.

Alternatives

gentags.lua: Auto generates tags by filetype.
vim-gutentags: A Vim plugin that manages your tag files.

Development

To develop the project and make PR, please setup with:

To run unit tests, please install below dependencies:

vusted.

Then test with vusted ./test.

Contribute

Please open issue/PR for anything about gentags.nvim.

Like gentags.nvim? Consider