nvim-dr-lsp 👨‍⚕️👩‍⚕️

Definitions and References utility for the LSP.

Lightweight plugin that highlights definitions and references of the word under the cursor and displays their count in the statusline.

• Installation
• Configuration
• Highlight references for the word under the cursor
• Statusline: definition and reference count
• Similar Plugins
• Credits

Installation

The plugin requires at least nvim 0.10.

```lua -- lazy.nvim { "chrisgrieser/nvim-dr-lsp", event = "LspAttach", opts = {}, },

-- packer use { "chrisgrieser/nvim-dr-lsp", config = function() require("dr-lsp").setup({}) end, } ```

Configuration

lua -- default config require("dr-lsp").setup { highlightCursorWordReferences = { enable = true, }, }

Highlight references for the word under the cursor

• Definitions are under-dashed, references are under-dotted.
• The time for the highlights to show up depends on the updatetime option. It's recommended to set it to something like 300 ms.

[!NOTE] In a previous version of this plugin, the highlights were enabled automatically. Now, the highlights are only enabled when the .setup() call is made.

Statusline: definition and reference count

Definitions and references inside current buffer:

text LSP: 2D 6R

Definitions or references outside current buffer

text LSP: 1(2)D 4(10)R

• 1 definition in the current buffer
• 2 definitions in the workspace
• 4 references in the current buffer
• 10 definitions in the workspace

lua -- adding the component to lualine.nvim { sections = { lualine_c = { { require("dr-lsp").lspCount }, }, } }

There are no built-in options to format the components, since formatting can already be done with most statusline plugins. With Lualine, for example, you can use the fmt option:

lua lualine_c = { { require("dr-lsp").lspCount, -- remove the letters from the component fmt = function(str) return str:gsub("[RD]", "") end, }, },

Alternatively, require("dr-lsp").lspCountTable() returns the lspCount information as lua table for custom formatting:

lua { file = { definitions = 1, references = 4, }, workspace = { definitions = 2, references = 10, }, }

Similar Plugins

• LSP-Lens
• action-hints.nvim
• symbol-usage.nvim

Credits

In my day job, I am a sociologist studying the social mechanisms underlying the digital economy. For my PhD project, I investigate the governance of the app economy and how software ecosystems manage the tension between innovation and compatibility. If you are interested in this subject, feel free to get in touch.

• Website
• Mastodon
• ResearchGate
• LinkedIn