Awesome
OO - Go Version Manager
Latest version: 0.1.0
oo
was heavily inspired by tj/n.
Requirements
Supported system:
- Mac OSX
- Linux
Requirements:
- Bash
- Curl
Install
-
Clone this repo.
git clone https://github.com/hit9/oo.git $HOME/.oo
-
Add this to your bashrc or zshrc:
source $HOME/.oo/env
Or this if you are using fish shell:
source $HOME/.oo/env.fish
Note that you still need to set GOPATH
manually in your bashrc or zshrc,
oo doesn't take care of that:
export GOPATH=/path/to/your/gopath
export PATH=$PATH:$GOPATH/bin
Examples
Get go1.12.6 installed:
$ oo get 1.12.6
Then, the go1.12.6
is ready:
$ go version
go version go1.12.6 darwin/amd64
Use go1.12.6 as current go
(or just oo 1.12.6
):
$ oo use 1.12.6
=> go1.12.6
Run go from 1.12.6 temporary:
$ oo as 1.12.6 version
go version go1.12.6 darwin/amd64
$ oo as 1.12.6 run helloworld.go
Hello world!
List all installed go versions
$ oo ls
1.12.5
=> 1.12.6
Build (or rebuild) go by version:
$ oo build 1.12.6
build go1.12.6..
build successfully
Get current go binary path:
$ oo bin
/Users/hit9/github/oo/go/bin/go
Remove a version:
$ oo rm 1.12.5 1 ↵ (go1.4 node@v2.0.0) ~/github/oo/versions/1.5/src
go@1.12.5 removed
You may need to download a prebuilt golang on the first run, if there's no golang installed, bootstrap won't work.
Using Prebuilt
By default, oo prefers to bootstrap a new version via an existing installed version:
$ oo get 1.12.6
get https://codeload.github.com/golang/go/tar.gz/go1.12.6..
######################################################################## 100.0%
using go1.12.5 to bootstrap go1.12.6....
build successfully
=> go1.12.6
But we are still able to download a prebuilt packages directly from https://golang.org/dl/ without a build waiting:
$ oo get 1.10.3 --use-prebuilt
get https://dl.google.com/go/go1.10.3.darwin-amd64.tar.gz..
######################################################################## 100.0%
=> go1.10.3
Usage
Usage: oo [COMMAND]
Commands:
oo Output current go version
oo ls Output versions installed
oo <version> Use go <version>
oo use <version> Use go <version>
oo get <version> Get go <version>
oo rm <version> Remove the given version
oo as <version> Run go from oo on a specific version
oo dir [<version>] Show go directory by version
oo bin [<version>] Show go binary path by version
oo build [<version>] Build go by version
oo env Output current go env
oo upgrade Upgrade oo to latest version
Options:
-v, --version Output oo's version
-h, --help Output this help message
Environment Variables:
OO_MIRROR_PATTERN Mirror url pattern to download go source tarball
default: https://codeload.github.com/golang/go/tar.gz/go%s
OO_BUILD_CMD Command to build go from source, default: ./make.bash
OO_BOOTSTRAP_VERSION Bootstrap go version to compile the target version,
default: the latest installed version
PREBUILT_PKG_URL_PATTERN Url pattern to download pre-built go package
default: https://dl.google.com/go/go%s.%s-amd64.tar.gz
The first parameter here is version, the second is platform.
Use https://dl.google.com/go/go%s.%s-arm64.tar.gz for arm64 platforms (e.g. Mac M1).
Version: 0.0.7
Custom Mirror
To use custom mirror url to download golang source:
$ export OO_MIRROR_PATTERN='https://storage.googleapis.com/golang/go%s.src.tar.gz'
$ oo get 1.12.6
get https://storage.googleapis.com/golang/go1.12.6.src.tar.gz..
########## 14.4%
To use custom mirror url to download prebuilt golang package:
$ export PREBUILT_PKG_URL_PATTERN=https://dl.google.com/go/go%s.%s-arm64.tar.gz
$ oo get 1.16.3 --use-prebuilt
get https://dl.google.com/go/go1.16.3.darwin-arm64.tar.gz..
########################################################################################################################################################################################################################## 100.0%
=> go1.16.3
You can add these environment variables to your bashrc or zshrc etc. for convenience.
Similar Projects
Troubles
If there are any errors during the bootstrap building, it's helpful to build manually to check what errors occurred:
cd path/to/oo/versions/x.x.x/src
GOROOT_BOOTSTRAP=path/to/downloaded/go ./all.bash
License
MIT.