Awesome

zvm - Zig Version Manager

A script to manage your Zig versions.

Features

Single POSIX-compliant shell script
Shell completions (bash, zsh)
Few dependencies (you probably have them installed already)

Getting Started

First, make sure ZVM_BIN is on your PATH. By default, it's ~/.local/bin:¹

On Linux, /home/<username>/.local/bin
On Windows, C:\Users\<username>\.local\bin
On MacOS, /Users/<username>/.local/bin

Next, determine if you need to explicitly set your target. On Linux you probably won't have to. If you're on Windows or MacOS, see the Cross-platform support section below.

Prerequisites

A POSIX-compliant shell
curl
jq
tar
unzip

Usage

Without any commands, zvm will print the active Zig version and exit. Specific actions may be performed my providing a command.

Commands

`list`

Alias: ls

List Zig versions from the remote index:

zvm list

List installed Zig versions:

zvm list -i
zvm list --installed

`install`

Alias: i

Install a Zig version:

zvm install 0.12.0

Install a Zig version and make it active immediately:

zvm install -u 0.12.0
zvm install --use 0.12.0

`use`

Use an installed Zig version:

zvm use 0.12.0

`uninstall`

Alias: rm

Uninstall a Zig version:

zvm uninstall 0.11.0

By default, the uninstall command will prevent the current version from being uninstalled. To bypass, there are 2 options:

Fall back to the newest installed version with -l,--use-latest
Force removal
- Note that after forcing removal, the zig command will no longer exist and you'll have to use the use command to select a new version

`help`

Alias: h

Show zvm help:

zvm help

Customizing

Environment

ZVM_HOME - zvm home directory (where zvm downloads and extracts Zig tarballs)
ZVM_BIN - zvm bin directory (where zvm symlinks Zig binaries)

TODO

Support building from source? (in-progress, see #14)
Allow custom download location (default: $HOME/.local/share/zvm)
- 9b1afd4
Allow custom install prefix (default: $HOME/.local/bin/zig)
- 9b1afd4

Cross-platform support

Linux

Native support. zvm's detected native target will likely work, but you can override it if you need to.

Windows

Supported via various Linux subsystems (git-bash, WSL, etc.).

zvm uses uname to detect the target and it currently only uses what uname provides, which will differ depending on the Linux subsystem used (git-bash, WSL, mingw, etc). However, Zig's targets use windows as the OS name. Due to this, for now you'll have to explicitly set your target:

zvm --target <arch>-windows

Replace <arch> with one of the following:

On a 32-bit system, x86 (e.g. x86-windows)
On a 64-bit x86 system, x86-64 (e.g. x86_64-windows)
On a 64-bit aarch64 system, aarch64 (e.g. aarch64-windows)

MacOS

Supported natively but shares the same gotchas as the Windows support.

zvm uses uname to detect the target and it currently only uses what uname provides. However, Zig's targets use macos as the OS name instead of darwin, which is what uname will return. Due to this, for now you'll have to explicitly set your target:

zvm --target <arch>-macos