Home

Awesome

mason-bridge.nvim

<p align="center"> <code>mason-bridge</code> automatically registers linters and formatters installed using <a href="https://github.com/williamboman/mason.nvim"><code>mason.nvim</code></a> in <a href="https://github.com/stevearc/conform.nvim"><code>conform.nvim</code></a> and <a href="https://github.com/mfussenegger/nvim-lint"><code>nvim-lint</code></a>. </p>

Introduction

Requirements

Installation

Packer

use {
    "williamboman/mason.nvim",
    "frostplexx/mason-bridge.nvim",
    "stevearc/conform.nvim",
    "mfussenegger/nvim-lint"
}

lazy.nvim

{
    "williamboman/mason.nvim",
    "frostplexx/mason-bridge.nvim",
    "stevearc/conform.nvim",
    "mfussenegger/nvim-lint"
}

Setup

It's important that you set up the plugins in the following order:

  1. mason.nvim
  2. mason-bridge
  3. conform.nvim and/or nvim-lint (this order doesnt matter)

Pay extra attention to this if you lazy-load plugins, or somehow "chain" the loading of plugins via your plugin manager.

require("mason").setup()
require("mason-bridge").setup()

-- After setting up mason-bridge you may set up conform.nvim and nvim-lint
require("conform").setup({
    formatters_by_ft = require("mason-bridge").get_formatters(),
})

require("lint").linters_by_ft = require("mason-bridge").get_linters()
-- ...

Have Tools Register for Every Filetype

Some tools like for example codespell do not have a language specified because they are to be used on every filetype / language. mason-bridge returns these tools with a * as the placeholder for the language. To correctly register correctly in nvim-lint you need to modify your nvim-lint config like this:

local names = lint._resolve_linter_by_ft(vim.bo.filetype)
names = vim.list_extend({}, names)
vim.list_extend(names, lint.linters_by_ft["*"] or {})

-- try_lint() can be called in an autocommand as described in the nvim-lint README
lint.try_lint(names)

Dynamically Load Linters and Formatters

Linters

You can have nvim-lint dynamically load linters so you dont have to restart nvim after installing or uninstalling a tool. To achive this you need to update the autcommand from the nvim-lint README like this:

local bridge = require("mason-bridge")
vim.api.nvim_create_autocmd({ "BufWritePost" },{
  callback = function()
    -- get the linters from mason
    local linters = bridge.get_linters()
    -- filter for linters for the current filetype
    local names = linters[vim.bo.filetype] or {}
    -- Create a copy of the names table to avoid modifying the original.
    names = vim.list_extend({}, names)
    -- insert the linters that have ["*"] as filetype into the names table
    vim.list_extend(names, linters["*"])
    -- apply those linters to the current buffer
    lint.try_lint(names)
  end,
})

Formatters

We ask for the currently installed formatters in a similar way to how we ask for linters. To achieve this we need to turn format_on_save into a function that re-sets the formatters_by_ft for conform.nvim like shown in the example below.

local bridge = require("mason-bridge")
require("conform").setup({
	formatters_by_ft = bridge.get_formatters(),
	format_on_save = function(bufnr)
		require("conform").formatters_by_ft = bridge.get_formatters()
		return { timeout_ms = 200, lsp_fallback = true }, on_format
	end,
})

Refer to the Configuration section for information about which settings are available.

Configuration

You may optionally configure certain behavior of mason-bridge.nvim when calling the .setup() function. Refer to the default configuration for a list of all available settings.

Example:

require("mason-bridge").setup({
    overrides = {
        linters = {
            javascript = { "snyk_iac" },
            docker = { "snyk_iac" }
        },
        formatters = {
            my_language = {"formatter_1", "formatter_2"}
        }
    }
})

Default configuration

local DEFAULT_SETTINGS = {
    -- A table of filetypes with the respective tool (or tools) to be used
    overrides = {
        formatters = {},
        linters = {}
    }
}

Roadmap

Similar Projects