GoTV

Installation

go install go101.org/gotv@latest

Usage

gotv ToolchainVersion [go-arguments...]

• a Go release version, such as 1.17.13, 1.18, 1.19rc1, which mean the release tags go1.17.13, go1.18, go1.19rc1, respectively, in the Go git repository. Note:
  • 1.N. means the latest release of 1.N (since Go toolchain 1.21, 1.N also means the latest release of 1.N).
  • 1. means the latest Go 1 release version.
  • . means the latest Go release version.
• :1.N, which means the local latest release-branch.go1.N branch in the Go git repository.
• :tip, which means the local latest master branch in the Go git repository.
• a version suffixed with ! means to fetch remote versions (by running gotv fetch-versions) firstly.

$ gotv 1.17. version
[Run]: $HOME/.cache/gotv/tag_go1.17.13/bin/go version
go version go1.17.13 linux/amd64

$ gotv 1.18.3 version
[Run]: $HOME/.cache/gotv/tag_go1.18.3/bin/go version
go version go1.18.3 linux/amd64

$ cat search.go
package main

import "fmt"

func demoFilter(n int) bool {
	return n & 1 == 0;
}

// Search values and return them without perverting order.
func search(start, end int)(r []int) {
	var count = 0
	for i, index := start, 0; i <= end; i++ {
		if demoFilter(i) {
			count++
			defer func(value int) {
				r[index] = value
				index++
			}(i)
		}
	}

	r = make([]int, count) // only allocate once
	return
}

func main() {
	fmt.Println(search(0, 9))
}

$ gotv 1.21. run search.go
[Run]: $HOME/.cache/gotv/tag_go1.21.7/bin/go run search.go
[8 6 4 2 0]
$ gotv 1.22. run search.go
[Run]: $HOME/.cache/gotv/tag_go1.22.1/bin/go run search.go
[0 0 0 0 0]

# sync the local Go git repository with remote
gotv fetch-versions

# list all versions seen locally
gotv list-versions

# build and cache some toolchain versions
gotv cache-version ToolchainVersion [ToolchainVersion ...]

# uncache some toolchain versions to save disk space
gotv uncache-version ToolchainVersion [ToolchainVersion ...]

# pin a specified toolchain version at a stable path
gotv pin-version ToolchainVersion

# unpin the current pinned toolchain version
gotv unpin-version

# set the default toolchain version (since v0.2.1)
gotv default-version ToolchainVersion

# check the default toolchain version (since v0.2.1)
gotv default-version

Pin a toolchain version

$ gotv pin-version 1.17.
[Run]: cp -r $HOME/.cache/gotv/tag_go1.17.13 $HOME/.cache/gotv/pinned-toolchain

Please put the following shown pinned toolchain path in
your PATH environment variable to use go commands directly:

	/home/username/.cache/gotv/pinned-toolchain/bin

$ go version
go version go1.17.13 linux/amd64

Set a bootstrap toolchain version

• Toolchain versions <= 1.12.17 are unable to be built with toochain versions >= 1.16;
• Toolchain versions <= 1.5.4 are uanable to be built with toolchain versions >= 1.6;
• A 1.17.13+ toolchain version is required to build 1.20+ toolchain versions;
• A 1.20.14+ toolchain version is required to build 1.22+ toolchain versions.
• A 1.22.6+ toolchain version is required to build 1.24+ toolchain versions.
• A 1.24.0+ toolchain version is required to build 1.26+ toolchain versions.

• Golds - an experimental Go local docs server, a Go docs generator, and a Go code reader.
• GoTV - a tool used to install and use coexisting installations of Go toolchain verisons harmoniously.
• nstd - a single-package go module which provides some missing types and functions in the standard library.