zigverm

zigverm is a version manager for the Zig programming Language. It lets you install Zig and further manage your installation.

Platform Support

Legend:
🎉 - Binary releases + automatic installer available
💪 - binary releases available
❌ - No binary releases. Maybe supported later. Requires compiling
- - Not applicable

OS/Arch	x86_64	x86	aarch64	armv7a	riscv64
Windows	💪	💪	❌	-	-
Linux	🎉	🎉	🎉	❌	❌
MacOS	🎉	-	🎉	-	-

Installation

For Linux and MacOS (x86_64/aarch64)

You can use this automated install script which will install zigverm along with the latest version of Zig

curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/AMythicDev/zigverm/main/scripts/install.sh | bash

By default it will create $HOME/.zigverm directory as the root folder for zigverm. You can customize this by setting this by setting the ZIGVERM_ROOT_DIR to the directory where you want to install zigverm. Make sire you add the ZIGVERM_ROOT_DIR in your shell config otherwise zigverm would not be able to locate the installation folder.

The script will also put the installation directory's bin folder to your $PATH variable. For this it will append a line to your $HOME/.profile and your shell's rc file. The file for each shell supported is listed below:

• Bash: $HOME/.bashrc
• Zsh: $HOME/.zshrc
• Fish: $XDG_CONFIG_HOME/fish/config.fish, if not set then uses $HOME/.config/fish/config.fish

For Windows

• Create the following folder structure in C:\Users\[YOU-USERNAME]\.zigverm:

.
├── bin
├── downloads
└── installs

• Download the latest release for Windows from GitHub and extract it.
• Copy zigverm.exe and zig.exe to the bin/ folder.
• Ass the bin directory to your PATH enviroment variable

Compiling

Requirements:

• Zig >= 0.12.0. Note that Zig master versions are not supported.
• libc on non-Windows systems. Can be provided by Zig itself, if available for the platform.
• git, if you want to compile the latest commit or you want to develop zigverm.

Now to compile:

• Clone the repo or download a source archive depending on if you want to compile the latest main branck or a release.
• Extract the archive and change into the extracted directory.
• Run the following command

zig build --release=safe

• If you are devloping zigverm, you can omit the --release=safe flag.
• You will have zigverm and zig in zig-out/bin/ directory
• Lastly follow the same steps for windows

Features

• Install versions (master, stable, x.y x.y.z)
• Continue download if previously interrupted
• Remove versions
• List down installed versions
• Update zigverm itself
• Manage default and per-directory version overrides
• Open the language reference and standard library docs (even when offline).
• Tries to maintain strong compatiblity with the wider zig ecosystem (zls, zig.vim)

Docs

Read the quick guide

License

zigverm is licensed under the Apache License 2.0. See the LICENSE file.