devnw / gvm

Go Version Manager (gvm) enables seamless installing and swapping between Go versions with a single command. This tool manages a Go environment for the user by allowing a user to specify which Go version they wish to use and handling all of the steps to install and configure that Go version. GVM also supports installing Go from the official Golang master branch so that you can easily try the next version of Go without waiting for a pre release build.

gvm

Go Version Manager

Install

curl -o- https://raw.githubusercontent.com/devnw/gvm/main/install.sh | bash

wget -qO- https://raw.githubusercontent.com/devnw/gvm/main/install.sh | bash

Updating gvm

gvm will automatically detect if there is a newer version available for the installed gvm tag and give the user the option to update (NOTE This does NOT work for semver tags). If the user chooses to update, the gvm command will be updated to the latest version and re-run the updated script instead.

Usage

gvm <command> [arguments]

Available Commands

<go version> Install or Change Specific Go Version

• -s Silent Mode (No Prompts)

• -r Remove Go Version

ls List Installed Go Versions

clean Remove inactive Go Versions

-h | --help | help Print this help text

Installation Example

To install a released version of Go use the following command.

gvm 1.17.5

If this version of Go has been previously installed, the link will be updated activating that version. If the version is not installed however gvm will install it, then link it.

To remove a version

gvm 1.17.5 -r

Development Version

gvm supports installing the current development version of Go

To install the current development version of Go use the following command.

gvm next

NOTE: If you have previously installed the development version of Go you must pass the --update flag if you want to build the latest development version, otherwise it will keep using the previously compiled development version.

How it works

gvm creates a directory at $HOME/.gvm and stores all of the Go versions in it. It then creates a symlink to the currently active version at $HOME/.gvm/go which is then added to the beginning of the PATH.

Supported OSes and Architectures

• Linux (ARM64 / AMD64)
• Mac OS X (ARM64 / AMD64)
• FreeBSD (ARM64 / AMD64)

gvm's Issues

[Feat]: Add Support for Boostrap ENV Variable

gvm should support the bootstrap env variables when building from source to ensure that the current gvm installed version is used for compilation.

[Bug]: can not install 1.20

🐞 Describe the bug

can not install 1.20

Download releases to .gvm/downloads before deleting instead of working directory

[Feat]: GitHub Support

Is your feature request related to a problem? Please describe.
Support for Github on Windows

Describe the solution you'd like
GVM support for GitHub on Windows OS. I've attached an updated version of the gvm file that includes additional lines necessary for the support. Wasn't sure if you would allow a pull request or not so please see file

Describe alternatives you've considered
Possibly using embedded linux on windows but Gitbash works and is a much lighter solution. We've been using it to develop golang for many years.

Additional context
Here is an output of gvm running against gitbash on windows using the attached version of the file. Notice its successfully downloading zip version of amd64

gvm.txt

Update auto-update release documentation

Currently the README indicates that the auto-update feature works for any tagged version of gvm. This is not the case.

The documentation needs to be updated to indicate that the auto-release ONLY works for latest and dev tags as those are the ones that are updated as part of the release process and will cause the sha 256 mismatch which alters the script to alterations. For v*.. tags those never get updated and so the sha will never differ since we will not push new updates to existing tags that are v*..

Add build tests which pull different linux/mac images and execute a set of runs to ensure proper installation

[Feat]: Add licence reference and information to script header

[Feat]: Add `clean` option to remove inactive versions

Add clean option to remove inactive versions

[Feat]: Add pre-configure support for setting up local user bin

mkdir $HOME/bin && echo "export PATH=$HOME/bin:$PATH" >> ~/.bashrc && source ~/.bashrc

Or similar to setup environment so that a user doesn't have to setup their own path.

[Feat]: Add `gvm use` option and support for .gvm file like `nvm`

gvm fails in latest build

Hey, this seems like a really cool project to replace my bash script used to update go.

However after a clean install I get a syntax error as shown in the picture below:

Test on freebsd

Determine if current latest runs properly on freebsd

Correct any issues found and update documentation to show freebsd as supported

[Feat]: Add support for wrapping `go` command and letting user know an updated version of Go is available

Add an option to the script asking the user if they desire to know when new releases of Go are available when they execute the go command and install a wrapper that tracks go versions.

This will likely be something done only daily to ensure there aren't issues with too many requests against the tags for Go.

Add support for `gvm latest` to install the latest version of `go`

This should determine the latest tag using the Github API or Google API to pull a list of tags and determine from semver which is highest.

Set this up to hide output

gvm/gvm

Line 51 in 262d77c

uname -a | grep "x86_64"

Add -r option to remove a specific version

[Bug]: When on next the update flag does not work

[Feat]: Add support for `$SHELLrc` instead of assuming bashrc

Add readme badges

[Feat]: Add persistent configuration

This should allow for a users selection on prompts to be remembered from previous runs to allow for a completely silent run on subsequent executions.

[Feat]: Remove dependency on Curl by using a similar method of swaping to wget like NVM

Add support for branches on dev

Update gvm next support so that a --branch or -b flag can be provided to choose the branch of the go source to build

[Feat]: Add shasum check for downloaded packages against site

GVM should verify the file downloaded matches the sha of the file listed on the Golang site prior to extracting and installing

Remove Support for `/usr/local/go` override

Update readme and message to indicate that /usr/local/go is used by ALL users of a system and that it should only be done with intent.

Update / Add Release action so that there is also a release for a specific tag version and not only latest

Test on Windows WSL 2

Determine if this runs properly on WSL 2 running ubuntu.

Correct issues if it doesn't and update documentation to list as supported.

[Feat]: Add install script similar to NVM

This should mimic the install steps of NVM

Investigation: Determine if sharing the `go env` is a viable or desired function of GVM

This research task should determine if it would be beneficial to copy environment variables between versions of Go managed by gvm or point at them in some other way to allow users to swap between versions easily while maintaining environment.

Add support for forks

Add an option for a user to use a fork in place of the go git repo path to build their own development branch as part of the go next command. Perhaps go next --fork <github-path>

[Feat]: Automatically re-build `gopls`

This should intelligently re-build gopls as needed based on the users current active version to enable language support for their editor. Note: Only update gopls if it is already installed.

[Bug]: Improper architecture for Raspberry PI

🐞 Describe the bug

Incorrect version of Go pulled for arch, see screenshot below

[Feat]: Update readme for windows docs

Pull docs update from PR for the windows changes. Be sure to include the must install gitbash with symlinks and source ~/.bashrc and how to create the ~/.bashrc file for path

vi ~/.bashrc
export PATH=$PATH:"/c/Users/<username>/bin"
exit gitbash and reopen
error at top may say a `.bash_profile` was created for you
curl command from docs
source ~/.bashrc
gvm <version>
``

If installing Go from source fails the next step should ask user if they still want to update symlink

gvm/gvm

Line 101 in 262d77c

./all.bash