Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/tristanisham/zvm
zvm (Zig Version Manager) lets you easily install/upgrade between different versions of Zig.
https://github.com/tristanisham/zvm
version-control version-manager versioning zig ziglang
Last synced: 29 days ago
JSON representation
zvm (Zig Version Manager) lets you easily install/upgrade between different versions of Zig.
- Host: GitHub
- URL: https://github.com/tristanisham/zvm
- Owner: tristanisham
- License: mit
- Created: 2022-11-09T05:55:03.000Z (about 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-30T21:24:43.000Z (about 1 month ago)
- Last Synced: 2024-10-02T07:04:43.898Z (about 1 month ago)
- Topics: version-control, version-manager, versioning, zig, ziglang
- Language: Go
- Homepage: https://www.zvm.app
- Size: 29.8 MB
- Stars: 439
- Watchers: 8
- Forks: 31
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.MD
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-version-managers - zvm - A version manager made in Go that works on Linux, BSD, MacOS, *nix systems including Windows. (Version Managers / Zig)
README
Zig Version Manager (zvm) is a tool for managing your [Zig](https://ziglang.org/) installs. With std
under heavy development and a large feature roadmap, Zig is bound to continue
changing. Breaking existing builds, updating valid syntax, and introducing new
features like a package manager. While this is great for developers, it also can
lead to headaches when you need multiple versions of a language installed to
compile your projects, or a language gets updated frequently.
## Join our Community
- [Twitch](https://twitch.tv/atalocke)
- [Twitter|X](https://twitter.com/atalocke)
# Installing ZVM
ZVM lives entirely in `$HOME/.zvm` on all platforms it supports. Inside of the
directory, ZVM will download new ZIG versions and symlink whichever version you
specify with `zvm use` to `$HOME/.zvm/bin`. You should add this folder to your
path. After ZVM 0.2.3, ZVM's installer will now add ZVM to `$HOME/.zvm/self`.
You should also add this directory as the environment variable `ZVM_INSTALL`.
The installer scripts should handle this for you automatically on *nix and Windows systems.
If you don't want to use `ZVM_INSTALL` (like you already have ZVM in a place you
like), then ZVM will update the exact executable you've called `upgrade` from.
# Linux, BSD, MacOS, *nix
```sh
curl https://raw.githubusercontent.com/tristanisham/zvm/master/install.sh | bash
```
# Windows
## PowerShell
```ps1
irm https://raw.githubusercontent.com/tristanisham/zvm/master/install.ps1 | iex
```
## Command Prompt
```cmd
powershell -c "irm https://raw.githubusercontent.com/tristanisham/zvm/master/install.ps1 | iex"
```
## Manually
Please grab the
[latest release](https://github.com/tristanisham/zvm/releases/latest).
## Putting ZVM on your Path
ZVM requires a few directories to be on your `$PATH`. If you don't know how to
update your environment variables perminantly on Windows, you can follow
[this guide](https://www.computerhope.com/issues/ch000549.htm). Once you're in
the appropriate menu, add or append to the following environment variables:
Add
- ZVM_INSTALL: `%USERPROFILE%\.zvm\self`
Append
- PATH: `%USERPROFILE%\.zvm\bin`
- PATH: `%ZVM_INSTALL%`
## Configure ZVM path
It is possible to overwrite the default behavior of ZVM to adhere to XDG specification on Linux. There's an environment variable `ZVM_PATH`. Setting it to `$XDG_DATA_HOME/zvm` will do the trick.
## Community Package
### AUR
`zvm` on the [Arch AUR](https://aur.archlinux.org/packages/zvm) is a community-maintained package, and may be out of date.
# Why should I use ZVM?
While Zig is still pre-1.0 if you're going to stay up-to-date with the master
branch, you're going to be downloading Zig quite often. You could do it
manually, having to scoll around to find your appropriate version, decompress
it, and install it on your `$PATH`. Or, you could install ZVM and run
`zvm i master` every time you want to update. `zvm` is a static binary under a
permissive license. It supports more platforms than any other Zig version
manager. Its only dependency is `tar` on Unix-based systems. Whether you're on
Windows, MacOS, Linux, a flavor of BSD, or Plan 9 `zvm` will let you install,
switch between, and run multiple versions of Zig.
# Contributing and Notice
`zvm` is stable software. Pre-v1.0.0 any breaking changes will be clearly
labeled, and any commands potentially on the chopping block will print notice.
The program is under constant development, and the author is very willing to
work with contributors. **If you have any issues, ideas, or contributions you'd
like to suggest
[create a GitHub issue](https://github.com/tristanisham/zvm/issues/new/choose)**.
# How to use ZVM
## Install
```sh
zvm install
# Or
zvm i
```
Use `install` or `i` to download a specific version of Zig. To install the
latest version, use "master".
```sh
# Example
zvm i master
```
### Force Install
As of `v0.7.6` ZVM will now skip downloading a version if it is already installed. You can always force an install with the `--force` or `-f` flag.
```sh
zvm i --force master
```
You can also enable the old behavior by setting the new `alwaysForceInstall` field to `true` in
`~/.zvm/settings.json`.
### Install ZLS with ZVM
You can now install ZLS with your Zig download! To install ZLS with ZVM, simply
pass the `--zls` flag with `zvm i`. For example:
```sh
zvm i --zls master
```
## Switch between installed Zig versions
```sh
zvm use
```
Use `use` to switch between versions of Zig.
```sh
# Example
zvm use master
```
## List installed Zig versions
```sh
# Example
zvm ls
```
Use `ls` to list all installed version of Zig.
### List all versions of Zig available
```sh
zvm ls --all
```
The `--all` flag will list the available verisons of Zig for download. Not the
versions locally installed.
## Uninstall a Zig version
```sh
# Example
zvm rm 0.10.0
```
Use `uninstall` or `rm` to remove an uninstalled version from your system.
## Upgrade your ZVM installation
As of `zvm v0.2.3` you can now upgrade your ZVM installation from, well, zvm.
Just run:
```sh
zvm upgrade
```
The latest version of ZVM should install on your machine, regardless of where
your binary lives (though if you have your binary in a privaledged folder, you
may have to run this command with `sudo`).
## Clean up build artifacts
```sh
# Example
zvm clean
```
Use `clean` to remove build artifacts (Good if you're on Windows).
## Set Version Map Source
```sh
zvm vmu "https://validurl.local/vmu.json" # Change the source ZVM pulls Zig release information from. Good for self-hosted Zig CDNs.
# ZVM only supports schemas that match the offical version map schema.
# Run `vmu default` to reset your version map.
zvm vmu default # Resets back to default Zig releases.
zvm vmu mach # Sets ZVM to pull from Mach nominated Zig.
```
## Print program help
```sh
zvm help
```
Or use it to dive deeper into a specific command.
```sh
zvm help list
```
```
NAME:
zvm list - list installed Zig versions. Flag `--all` to see remote options
USAGE:
zvm list [command options] [arguments...]
OPTIONS:
--all, -a list remote Zig versions available for download, based on your version map (default: false)
--help, -h show help
```
## Print program version
```sh
zvm --version
```
Prints the version of ZVM you have installed.
## Option flags
### Color Toggle
Enable or disable colored ZVM output. No value toggles colors.
#### Enable
- on
- yes/y
- enabled
- true
#### Disabled
- off
- no/n
- disabled
- false
```sh
--color # Toggle ANSI color printing on or off for ZVM's output, i.e. --color=true
```
## Environment Variables
- `ZVM_DEBUG` enables DEBUG logging for your executable. This is meant for
contributors and developers.
- `ZVM_SET_CU` Toggle the automatic upgrade checker. If you want to reenable the
checker, just `uset ZVM_SET_CU`.
- `ZVM_PATH` sets the install location for ZVM. Set the environment variable to the parent directory of where you've placed the `.zvm` directory.
## Please Consider Giving the Repo a Star ⭐
