nvim-treesitter/lua/nvim-treesitter/health.lua

local parsers = require('nvim-treesitter.parsers')
local config = require('nvim-treesitter.config')
local util = require('nvim-treesitter.util')
local tsq = vim.treesitter.query
local health = vim.health

local M = {}

local NVIM_TREESITTER_MINIMUM_ABI = 13
local TREE_SITTER_MIN_VER = { 0, 25, 0 }

---@param name string
---@return table?
local function check_exe(name)
  if vim.fn.executable(name) == 1 then
    local path = vim.fn.exepath(name)
    local out = vim.trim(vim.fn.system({ name, '--version' }))
    local version = vim.version.parse(out)
    return { path = path, version = version, out = out }
  end
end

local function install_health()
  health.start('Requirements')

  do -- nvim check
    if vim.fn.has('nvim-0.11') ~= 1 then
      health.error('Nvim-treesitter requires Neovim 0.11.0 or later.')
    end

    if vim.treesitter.language_version >= NVIM_TREESITTER_MINIMUM_ABI then
      health.ok(
        'Neovim was compiled with tree-sitter runtime ABI version '
          .. vim.treesitter.language_version
          .. ' (required >='
          .. NVIM_TREESITTER_MINIMUM_ABI
          .. ').'
      )
    else
      health.error(
        'Neovim was compiled with tree-sitter runtime ABI version '
          .. vim.treesitter.language_version
          .. '.\n'
          .. 'nvim-treesitter expects at least ABI version '
          .. NVIM_TREESITTER_MINIMUM_ABI
          .. '\n'
          .. 'Please make sure that Neovim is linked against a recent tree-sitter library when building'
          .. ' or raise an issue at your Neovim packager. Parsers must be compatible with runtime ABI.'
      )
    end
  end

  do -- treesitter check
    local ts = check_exe('tree-sitter')
    if ts then
      if vim.version.ge(ts.version, TREE_SITTER_MIN_VER) then
        health.ok(string.format('tree-sitter-cli %s (%s)', ts.version, ts.path))
      else
        health.error(
          string.format('tree-sitter-cli v%d.%d.%d is required', unpack(TREE_SITTER_MIN_VER))
        )
      end
    else
      health.error('tree-sitter-cli not found')
    end
  end

  do -- curl+tar check
    local tar = check_exe('tar')
    if tar then
      health.ok(string.format('tar %s (%s)', tar.version, tar.path))
    else
      health.error('tar not found')
    end

    local curl = check_exe('curl')
    if curl then
      health.ok(string.format('curl %s (%s)\n%s', curl.version, curl.path, curl.out))
    else
      health.error('curl not found')
    end
  end

  health.start('OS Info')
  local osinfo = vim.uv.os_uname() ---@type table<string,string>
  for k, v in pairs(osinfo) do
    health.info(k .. ': ' .. v)
  end

  local installdir = config.get_install_dir('')
  health.start('Install directory for parsers and queries')
  health.info(installdir)
  if vim.uv.fs_access(installdir, 'w') then
    health.ok('is writable.')
  else
    health.error('is not writable.')
  end
  if
    vim.iter(vim.api.nvim_list_runtime_paths()):any(function(p)
      return installdir == vim.fs.normalize(p) .. '/'
    end)
  then
    health.ok('is in runtimepath.')
  else
    health.error('is not in runtimepath.')
  end
end

local function query_status(lang, query_group)
  local ok, err = pcall(tsq.get, lang, query_group)
  if not ok then
    return 'x', err
  elseif not err then
    return '.'
  else
    return '✓'
  end
end

function M.check()
  --- @type {[1]: string, [2]: string, [3]: string}[]
  local error_collection = {}
  -- Installation dependency checks
  install_health()

  -- Parser installation checks
  health.start('Installed languages' .. string.rep(' ', 5) .. 'H L F I J')
  local languages = config.get_installed()
  table.sort(languages)
  for _, lang in ipairs(languages) do
    local parser = parsers[lang]
    local out = lang .. string.rep(' ', 22 - #lang)
    if parser and parser.install_info then
      for _, query_group in pairs(M.bundled_queries) do
        local status, err = query_status(lang, query_group)
        out = out .. status .. ' '
        if err then
          table.insert(error_collection, { lang, query_group, err })
        end
      end
    end
    if parser and parser.requires then
      for _, p in pairs(parser.requires) do
        if not vim.list_contains(languages, p) then
          table.insert(error_collection, { lang, 'queries', 'dependency ' .. p .. ' missing' })
        end
      end
    end
    health.info(vim.fn.trim(out, ' ', 2))
  end
  health.start('  Legend: H[ighlights], L[ocals], F[olds], I[ndents], In[J]ections')

  if #error_collection > 0 then
    health.start('The following errors have been detected in query files:')
    for _, p in ipairs(error_collection) do
      local lang, type = p[1], p[2]
      local lines = {}
      table.insert(lines, lang .. '(' .. type .. '): ')
      local files = tsq.get_files(lang, type)
      if #files > 0 then
        for _, file in ipairs(files) do
          local query = util.read_file(file)
          local _, file_err = pcall(tsq.parse, lang, query)
          if file_err then
            table.insert(lines, file)
          end
        end
      end
      health.error(table.concat(lines, ''))
    end
  end
end

M.bundled_queries = { 'highlights', 'locals', 'folds', 'indents', 'injections' }

return M