Chromosore/lazily-nvim

A standalone plugin lazy loader for Neovim

Lazily-nvim

A standalone plugin lazy loader.

Overview

Lazily is one third¹ of a full plugin manager: it only does lazy loading of the plugins. This plugin is intended for use with lightweight package managers such as minpac or paq, or even native vim packages.

This plugin requires Neovim 0.7.0.

Usage

local lazily = require("lazily")

-- This is optional. Use it to specify extra options.
lazily.setup{
    -- Default uses vim8 packages. This works with minpac, paq, packer and
    -- most modern plugin managers
    load = lazily.packadd;

    -- To load packages using an external function use e.g.
    load = my_plugin_store.load;
}

lazily.use("my-plugin", {
    autocmd = {
        event = {"BufEnter", "BufNew"};
        pattern = "*";
        filter = function(event)
            return vim.fn.isdirectory(event.match) == 1
        end;
    },
    command = "MyPlugin",
    mapping = {"n", "<leader>mp"},
    requires = {
        "my-other-plugin",
    },
})

-- To ensure the plugin is loaded, use
lazily.load("my-plugin")

-- To cancel all the lazy loading triggers, use
lazily.cancel("my-plugin")

See :help lazily for more informations.

Footnotes

1. The three thirds are downloading, loading and lazy-loading. ↩