"Too many rounds of missing plugins" error

[jamischarles]

Hey friends 👋 ,

I upgraded from Lazy.nvim 9.x to 11.x recently.

Everything was working great on 9.x. For the LIFE of me I cannot figure out what I'm configuring wrong for v11 to work.

I cannot get a single one of my local plugins to load properly and work. I've now spent hours on this.

Any help would be MUCH appreciated 🙏 .

Related to this bug, but none of the solutions offered in the thread seemed to work:
#1563

nvim version:

NVIM v0.10.3
Build type: Release
LuaJIT 2.1.1736781742
Run "nvim -V1 -v" for more info

Checkhealth:

lazy: require("lazy.health").check()

lazy.nvim ~
- {lazy.nvim} version `11.16.2`
- OK {git} `version 2.39.5 (Apple Git-154)`
- OK no existing packages found by other package managers
- OK packer_compiled.lua not found

luarocks ~
- checking `luarocks` installation
- OK no plugins require `luarocks`, so you can ignore any warnings below
- OK {luarocks} `/opt/homebrew/bin/luarocks 3.11.1`
- WARNING `lua` version `5.1` needed, but found `Lua 5.4.7  Copyright (C) 1994-2024 Lua.org, PUC-Rio`
- WARNING {lua5.1} or {lua} or {lua-5.1} version `5.1` not installed

I've tried setting up a single local plugin in various ways, to no avail.

I have all my local plugins in a symlinked folder:
~/.dotfiles/nvim/lua/*

Outcome is always the same:

And then it fails to install colorscheme plugin

Path a

require("lazy").setup("plugins")

-- content of ~/.dotfiles/nvim/lua/plugins.lua
return {
  {
    dir = "~/.dotfiles/nvim/lua/colorscheme.lua",
    name = "colorscheme",
    lazy = false,
    priority = 1000,
     -- init = function()
     --   require("colorscheme").init()
     -- end,
     },
}

-- ~/.dotfiles/nvim/lua/colorscheme.lua
return {
  name = "colorscheme",
  dependencies = {
    -- LIGHT themes I like
    "cocopon/iceberg.vim",    -- "++ (Blue + purple)
    "EdenEast/nightfox.nvim", -- ++ Dark during the day. Has 10 themes inside. Very configurable.
    "stillwwater/vim-nebula", -- ++ NICE in light AND Dark (nightshift decent)
    -- DARK themes I like (fox ones)
    -- "ghifarit53/tokyonight-vim", --NICE. try it out more similar to night owl
    "folke/tokyonight.nvim", --tokyonight-storm (decent) -moon

  },
  init = function()

    print('colorscheme:setup')
    vim.opt.background = "light"
    vim.api.nvim_create_user_command("Light", ':lua vim.opt.background="light"', { nargs = 0 })
    vim.api.nvim_create_user_command("Dark", ':lua vim.opt.background="dark"', { nargs = 0 })

    -- vim.cmd('colorscheme iceberg') -- no lua equivalent of this :colorscheme command
    -- vim.cmd('colorscheme dayfox') -- no lua equivalent of this :colorscheme command
    -- vim.cmd('colorscheme duskfox') -- no lua equivalent of this :colorscheme command


    -- vim.cmd("colorscheme dawnfox") -- no lua equivalent of this :colorscheme command

    -- current default
    vim.opt.background = "dark"
    -- require'EdenEast/nordfox.nvim'
    -- vim.cmd("colorscheme nordfox") -- no lua equivalent of this :colorscheme command
  end,
}

Path b

Pretty much the same as A, but instead I build the spec manually:

-- table
local pluginTree = {}

-- build a table of plugin specs that are returned from the local plugin files
-- Makes it easy to load local plugins using an array
function buildPluginList(list)
  for _, localPlugin in ipairs(list) do

    -- local pluginSpec = require(localPlugin)
    local pluginSpec = {}

    -- spec needs to follow this format:
    -- https://lazy.folke.io/spec
    pluginSpec.dir = "~/.dotfiles/nvim/lua/" .. localPlugin .. ".lua"
    pluginSpec.name =  localPlugin 
    -- pluginSpec.import = pluginSpec.dir .. "/" .. localPlugin .. ".lua"
    -- pluginSpec.import = localPlugin
    -- pluginSpec.name = localPlugin .. ".lua"
    -- pluginSpec.lazy = false
    -- pluginSpec.dev = true -- use local plugin folder

    table.insert(pluginTree, pluginSpec)
  end

    -- print('pluginSpec', vim.inspect(pluginTree))
end

-- BUG: it's only executing the very last item in the list...



buildPluginList({
'colorscheme',
  -- 'cursorline'
})

require("lazy").setup(pluginTree)

^ This worked great until v11.x

[folke]

This is not a dir?
dir = "~/.dotfiles/nvim/lua/colorscheme.lua",

[folke]

You're doing it all wrong. Why do you add this kind of spec?
Totally not needed and wrong. Please read all the docs.

[jamischarles]

@folke I've split my config up by purpose ie: colorscheme, lsp etc...

Each of those is a separate file.

I am reading the docs continuously but I think I'm missing some key insight.

Any suggestions for getting back on track to having things working again?

Happy to restructure things. I'm not seeing much in docs for local plugins, but maybe I missed it.

[jamischarles]

Initially I set it up this way because I wanted an easy way to disable a plugin from a master list so I can see clearly what is enabled or not without having to visit or move a local plugin file.

Maybe there's a better way to accomplish that that I'm missing.

[folke]

If you really want to use your own single plugins then they should of course be structured like a real plugin.
A file is not a plugin. You're on your own. I'm not going to help you write plugins...

[jamischarles]

Ah so that's where I went wrong. Sounds like nvim and lazy expect each plugin to be its own folder.

I wasn't aware of that. That was the key insight I was missing.

Thanks for helping clear that up.

[jamischarles]

Ok. After reading through the docs carefully again, and looking at the examples again it finally clicked...

I was incorrectly treating colorscheme.lua etc as plugin. Really those are just a spec file that needs to get merged with the other spec files.

After making the adjustments needed, both these approaches worked beautifully:

Option a: plugin.lua file

-- plugins.lua file
return {
  {
    dir = "~/.dotfiles/nvim/lua",
    name = "statusline.lua",
    lazy = false,
    priority = 998,
 --  dependencies = require("statusline").dependencies,
    dependencies = {
      "nvim-tree/nvim-web-devicons", -- (for lualine) 
      "nvim-lualine/lualine.nvim",
  },
  {
    dir = "~/.dotfiles/nvim/lua",
    name = "git.lua",
    lazy=false,
    priority = 995,
    dependencies = {
    'lewis6991/gitsigns.nvim'
   },
-- [...]
}

Each of those files returns a list of deps to include
ie:

-- statusline.lua
return {
  "dep1",
  "dep2",
  {
    "nvim-lualine/lualine.nvim",
    dependencies = {
    "nvim-tree/nvim-web-devicons", -- (for lualine) 
    "cocopon/iceberg.vim", -- "++ (Blue + purple)
    
    },
    config = function()
    end

Then in init.lua:

Option b: build a spec tree via a function file (my preferred way)

-- init.lua
function buildPluginList(list)
  for _, localPlugin in ipairs(list) do
    local pluginSpec = {
     -- plugins are in `lua/plugins/*` folder. Dot is the path separator?
       import = "plugins." .. localPlugin 
    }
    table.insert(pluginTree, pluginSpec)
  end
end

-- easily comment out groups of plugins I don't want to load
buildPluginList({
  'cursorline', 
  'git',
});

@folke Thanks for putting me back on the right path.