lazy.nvim/README.md

3.1 KiB

lazy.nvim

Features

  • Partial clones instead of shallow clones
  • waits till missing deps are installed (bootstrap Neovim and start using it right away)
  • Async
  • No need for compile
  • Fast
  • Correct sequencing of dependencies (deps should always be opt. Maybe make everything opt?)
  • Config in multiple files
  • Patterns for local packages
  • Profiling
  • lockfile
  • upvalues in config & init
  • check for updates
  • lazy-lock.lua
  • tag/version support git tag --sort version:refname
  • auto-loading on completion for lazy-loaded commands
  • bootstrap code
  • semver https://devhints.io/semver https://semver.npmjs.com/

TODO

  • health checks: check merge conflicts async
    • unsupported props or props from other managers
    • other packages still in site?
    • other package manager artifacts still present? compiled etc
  • fix plugin details
  • show disabled plugins (strikethrough?)
  • log file
  • git tests
  • Import specs from other plugin managers
  • packspec
    • add support to specify engines, os and cpu like in package.json
    • semver merging. Should check if two or more semver ranges are compatible and calculate the union range
      • default semver merging strategy: if no version matches all, then use highest version?
    • package meta index (package.lua cache for all packages)
  • status page showing running handlers and cache stats
  • delete lazy keymaps when a plugin loads. Reset handlers for a plugin?
  • deal with re-sourcing init.lua. Check a global?
  • rename run to build
  • temp colorscheme
  • allow setting up plugins through config fooo
  • task timeout
  • incorrect when switching TN from opt to start
  • max concurrency
  • ui border
  • make sure we can reload specs while keeping state
  • use uv file watcher (or stat) to check for config changes
  • support for Plugin.lock
  • defaults for git log
  • view keybindings for update/clean/...
  • add profiler to view
  • add buttons for actions
  • show time taken for op in view
  • auto lazy-loading of lua modules
  • clear errors
  • add support for versions git tag --sort v:refname
  • rename requires to dependencies
  • move tasks etc to Plugin.state
  • handlers imply opt
  • dependencies imply opt for deps
  • fix local plugin spec
  • investigate all opt=true. Simplifies logic (easily switch between opt/start afterwards)

📦 Differences with Packer

  • Plugin Spec:

    • setup => init
    • requires => dependencies
    • as => name
    • opt => lazy
    • run => build
    • lock => pin
    • module is auto-loaded. No need to specify

📦 Other Neovim Plugin Managers in Lua