Skip to content

Releases: doctorfree/nvim-lazyman

Lazyman Version 1.0.0 Release 3

23 Mar 17:03
@doctorfree doctorfree
v1.0.0r3
dbb3c77
Compare
Choose a tag to compare
Lazyman Version 1.0.0 Release 3

Lazyman Release Notes

All that is needed to bootstrap nvim-lazyman is the lazyman.sh script. Download and execute to get started.

The Lazyman project can be used to install, initialize, and manage multiple Neovim configurations. Several popular Neovim configurations are supported including AstroNvim, NvChad, Allaman, Kickstart, LunarVim, and LazyVim.

In addition, Lazyman installs and initializes the Lazyman Neovim configuration, a richly configured Neovim environment using Lua, Lazy, and Mason to support highlighting, completion, diagnostics, and more for many programming languages.

The installation and initialization of Neovim configurations are placed in separate directories and managed using the NVIM_APPNAME environment variable.

The lazyman command is installed as ~/.local/bin/lazyman and can be used to install, initialize, remove, and manage multiple Neovim configurations.

Installation

The Lazyman installation process consists of three steps:

git clone https://github.com/doctorfree/nvim-lazyman $HOME/.config/nvim-lazyman
$HOME/.config/nvim-lazyman/lazyman.sh
$HOME/.config/nvim-lazyman/lazyman.sh -I

These steps:

  1. Download the Lazyman Neovim configuration
  2. Initialize the Lazyman Neovim configuration which:
    1. Installs Homebrew if not already installed
    2. Installs the latest version of Neovim if not already installed
    3. Installs and initializes configured Neovim plugins
  3. Installs language servers and tools for coding diagnostics (optional)

Lazyman uses Homebrew to install Neovim if there is not already Neovim 0.9 or later installed and in the execution path. In addition, Lazyman uses Homebrew to install Neovim dependencies, language servers, and tools. The Homebrew install of Neovim compiles the current version of Neovim from source to ensure we have the necessary capabilities. This process can be time consuming.

Bootstrap

To bootstrap the Lazyman Neovim configuration manager, the lazyman.sh script must be downloaded and executed. The download can be performed with git, curl, wget, or a copy/paste.

The recommended bootstrap procedure is with git:

Clone the repository with git and execute lazyman.sh:

git clone https://github.com/doctorfree/nvim-lazyman $HOME/.config/nvim-lazyman
$HOME/.config/nvim-lazyman/lazyman.sh

Alternatively, download the lazyman.sh script and execute it. For example, with curl:

curl -fsS https://raw.githubusercontent.com/doctorfree/nvim-lazyman/main/lazyman.sh > /tmp/lazyman.sh
chmod 755 /tmp/lazyman.sh
/tmp/lazyman.sh
rm -f /tmp/lazyman.sh

Once the lazyman.sh script has been downloaded and executed, subsequent Lazyman operations can be performed with the lazyman command found in ~/.local/bin/lazyman. The manual page can be viewed with man lazyman.

If you do not wish to use this automated installation and initialization method then manual installation and initialization is described below. Manual installation and initialization may be preferred by those who do not wish to upgrade Neovim to the latest version or by those who do not wish to use Homebrew.

Neovim 0.8 and earlier users, see the Neovim 0.8 section below for manual installation and initialization of nvim-lazyman.

Neovim 0.9 and later users, see the Neovim 0.9 section below for manual installation and initialization of nvim-lazyman.

Neovim 0.9 and later users can use the NVIM_APPNAME environment variable to control where Neovim looks for its configuration.

Postinstall

The Lazyman bootstrap process ensures the latest version of Neovim is installed but does not install language servers and tools necessary for coding diagnostics. To install these tools, execute:

lazyman -I

Manual installation

If you do not wish to use the automated installation and initialization provided by the lazyman.sh script, manual installation and initialization can be performed. Check the version of the installed Neovim with:

nvim --version

Follow the manual installation procedure for your version of Neovim. Manual installation of Lazyman will not install language servers or tools. Mason will take care of some of this for you but a manual installation should be accompanied by a manual upgrade of Neovim and installation of desired language servers and tools. You're on your own but you can always just run lazyman to perform an automated install and upgrade followed by lazyman -I to install language servers and tools.

Neovim 0.9 and later

In Neovim 0.9 and later there is a new feature enabling control of the Neovim configuration location through the NVIM_APPNAME environment variable. For example, export NVIM_APPNAME="nvim-lazyman" in your shell would make nvim look for its configuration in ~/.config/nvim-lazyman rather than ~/.config/nvim. This new feature can be used to easily switch between Neovim configurations.

If you wish to use this repository in conjunction with a setup utilizing the NVIM_APPNAME feature then the manual installation process can be performed by:

  • Backup any pre-existing nvim-lazyman config folder
[ -d $HOME/.config/nvim-lazyman ] && {
  echo "Backing up existing nvim-lazyman config as $HOME/.config/nvim-lazyman-bak$$"
  mv $HOME/.config/nvim-lazyman $HOME/.config/nvim-lazyman-bak$$
}
  • Clone the nvim-lazyman Neovim configuration repository and initialize Neovim
echo "Cloning nvim-lazyman configuration into $HOME/.config/nvim-lazyman"
git clone https://github.com/doctorfree/nvim-lazyman $HOME/.config/nvim-lazyman
export NVIM_APPNAME="nvim-lazyman"
nvim --headless "+Lazy! sync" +qa
nvim

Neovim 0.8 and earlier

[Note:] Lazyman bootstrap will install the latest version of Neovim even if an older version is already installed. A manual install of Lazyman will not upgrade Neovim. Neovim 0.8 and earlier does not support some of the features Lazyman provides.

Users of Neovim 0.8 and earlier can manually install and initialize nvim-lazyman following these instructions:

  • Backup any existing Neovim configuration, state, and installed plugins
[ -d $HOME/.config/nvim ] && {
  echo "Backing up Neovim config as $HOME/.config/nvim-bak$$"
  mv $HOME/.config/nvim $HOME/.config/nvim-bak$$
}
[ -d $HOME/.local/state/nvim ] && {
  echo "Backing up Neovim state as $HOME/.local/state/nvim-bak$$"
  mv $HOME/.local/state/nvim $HOME/.local/state/nvim-bak$$
}
[ -d $HOME/.local/share/nvim ] && {
  echo "Backing up Neovim installed plugins as $HOME/.local/share/nvim-bak$$"
  mv $HOME/.local/share/nvim $HOME/.local/share/nvim-bak$$
}
  • Clone the nvim-lazyman Neovim configuration repository and initialize Neovim
git clone https://github.com/doctorfree/nvim-lazyman $HOME/.config/nvim
nvim --headless "+Lazy! sync" +qa
nvim

Supported configurations

After installing and initializing lazyman, additional Neovim configurations can be installed and initialized using the lazyman command.

Currently the following Neovim configurations are supported:

Removal

The lazyman.sh script can be used to remove previously installed Neovim configurations with the -r command line option. For example, to remove a previously installed LazyVim configuration, its initialized plugins, state, and cache, execute the following command:

$HOME/.config/nvim-lazyman/lazyman.sh -l -r

To remove the nvim-lazyman configuration and associated plugins, state, and cache:

$HOME/.config/nvim-lazyman/lazyman.sh -r

All lazyman.sh operations can be performed as a dry run with -n. For example, to see which LazyVim folders would be removed without removing any:

$HOME/.config/nvim-lazyman/lazyman.sh -n -l -r
Assets 3
Loading