theprocedural/go-version-manager

Go Version Manager (gov) is a simple command-line tool for managing Go versions on your system. You can get started by running the following command in your terminal.

Go Version Manager (gov)

Go Version Manager (gov) is a simple command-line tool for managing Go versions on your system.

Table of contents

• Installation
• Usage
  • List available supported Go versions
  • List all available Go versions
  • Install a Go version
  • Reinstall a Go version
  • Use a Go version
  • Display the currently used Go version
  • List installed Go versions
  • Remove a Go version
  • Prune
  • Show version
  • Self update
  • Uninstall gov
  • Show help
• Compiling from Source
• License

Installation

Linux and macOS

Using curl (recommended):

curl -fsSL https://gov.theprocedural.com/gov.sh | bash

Using wget:

wget -O- https://gov.theprocedural.com/gov.sh | bash

Usage

List available supported Go versions

Long:

gov list-supported

Short:

gov s

List all available Go versions

Long:

gov list-all

Short:

gov a

Install a Go version

Install a Go version, or the latest release using the "latest" tag, e.g:

Long:

gov install 1.21.1

gov install latest

Short:

gov i 1.21.1

gov i latest

Reinstall a Go version

Remove and then install again a Go version, e.g:

Long:

gov reinstall 1.21.1

Short:

gov r 1.21.1

Use a Go version

The first time gov will set the env var for you and you might need to restart your shell/terminal for the configuration to take effect. Subsequent changes should work seamlessly.

Long:

gov use 1.21.1

Short:

gov u 1.21.1

Display the currently used Go version

Long:

gov current

Short:

gov c

List installed Go versions

Long:

gov list

Short:

gov l

Remove a Go version

Long:

gov remove 1.21.1

Short:

gov x 1.21.1

Prune

Remove all installed Go versions except the currently used one, e.g:

Long:

gov prune

Short:

gov p

Show version

Show the installed gov version and extras.

Long:

gov version

Short:

gov v

Self update

Update gov to its latest version

Long:

gov self-update

Short:

gov e

Uninstall gov

This will only remove gov, not your installed Go versions.

After uninstallation, gov will provide instructions to remove Go and leftovers.

gov sayonara

Show help

gov --help

gov -h

gov help

gov h

# or make a mistake ¯\_(ツ)_/¯

Compiling from Source

If you prefer to compile gov from source or want to contribute, you can follow these steps:

1. Clone the gov repository:

   git clone https://gitlab.com/TheProcedural/go-version-manager

2. Change to the gov directory:

   cd gov

3. Build gov using the build scripts:

   1. Make script executable (if needed)

      sudo chmod +x ./build.sh

   2. Build only the supported platforms (recommended)

      ./build.sh <new_gov_version>

   3. Build for every platform and architecture. I mean, why not?

      ./build-all.sh <new_gov_version>

4. Optionally, move the gov binary to a directory included in your system's PATH for easy access.

Building notes

If you build for Windows note that env vars and zip extraction won't work. You're welcome to work on Windows support. I just can't be arsed with Windows, it puts me in a bad mood every time I use it.

License

This project is licensed under the GPLv3 License - see the LICENSE file for details.

Copyright notice

Copyright (c) 2023 Erik Bjerke. All rights reserved.

This software is not affiliated with or endorsed by the Go Project.

go-version-manager's Issues

Allow using 'latest' as an alias for the newest version in more commands

e.g.
gov use latest
gov remove latest

Set GOPATH and GOROOT at install

Install script should add lines to .bash_profile or .zprofile to set GOPATH and GOROOT

Specify multiple Go versions to install/remove

e.g. gov i latest 1.21.4 1.20.12

Project-specific configs

gov can read a config file in the CWD to set the Go version. Perhaps it could be activated the same way as in NVM, i.e. gov use with no arguments.
Preferably, however, the Go version is "changed" automatically. I guess it could use a shell script for go, rather than the actual binary, which uses the CWD to determine the correct version of Go to run