Skip to content

Extension to mason.nvim that makes it easier to use nvim-lint with mason.nvim

License

Notifications You must be signed in to change notification settings

rshkarin/mason-nvim-lint

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

mason-nvim-lint

mason-nvim-lint is a Neovim plugin that closes a gap between mason.nvim and nvim-lint, it allows install linters configured in nvim-lint.

Requirements

Installation

{
    "williamboman/mason.nvim",
    "mfussenegger/nvim-lint",
    "rshkarin/mason-nvim-lint",
}
use {
    "williamboman/mason.nvim",
    "mfussenegger/nvim-lint",
    "rshkarin/mason-nvim-lint",
}

Setup

It's crucial to setup plugins in the following order:

  1. mason.nvim
  2. nvim-lint
  3. mason-nvim-lint

Otherwise, mason-nvim-lint will not have enough information about configured linters and access to the mason's registry.

To learn about the available settings and configurations, please refer the Configuration section.

Configuration

You can configure the behavior of mason-nvim-lint by passing the configuration during the calling of the setup() function. All available settings are provided in default configuration section.

Example:

require("mason-nvim-lint").setup()

Default configuration

local DEFAULT_SETTINGS = {
    -- A list of linters to automatically install if they're not already installed. Example: { "eslint_d", "revive" }
    -- This setting has no relation with the `automatic_installation` setting.
    -- Names of linters should be taken from the mason's registry.
    ---@type string[]
    ensure_installed = {},

    -- Whether linters that are set up (via nvim-lint) should be automatically installed if they're not already installed.
    -- It tries to find the specified linters in the mason's registry to proceed with installation.
    -- This setting has no relation with the `ensure_installed` setting.
    ---@type boolean
    automatic_installation = true,

    -- Disables warning notifications about misconfigurations such as invalid linter entries and incorrect plugin load order.
    quiet_mode = false,
}

Basic Customization

Using this configuration, linters specified in ensure_installed will be installed directly from the mason's registry, and ones specified in nvim-lint will be translated to Mason format and installed. NOTE: The linters in ensure_installed should be written in the format of the mason's registry (https://mason-registry.dev/).

require ('mason-nvim-lint').setup({
    ensure_installed = { 'bacon' }, -- bacon linter for rust is not available in nvim-lint, so it's specified to be directly installed from the mason's registry
})

Copyright

This project relies heavily on mason-lspconfig.nvim.