goenv's Introduction

Golang Version Management with goenv

Note: This project is no longer being maintained since goapp command has already immigrated to the official go one.

goenv supplies the management system to switch between multiple Go and Google App Engine for Go releases.

Installation

Checkout

Clone the repository to install the latest version of goenv.

git clone https://github.com/kaneshin/goenv.git ~/.goenv

Define the cloned repository path as $GOENV_ROOT and then add $GOENV_ROOT/bin to your $PATH for access to the goenv command-line utility.

export GOENV_ROOT="$HOME/.goenv"
export PATH="$GOENV_ROOT/bin:$PATH"

Add goenv init to your shell to enable shims.

eval "$(goenv init -)"

Usage

$ goenv help
Usage: goenv <command> [<args>]

Some useful goenv commands are:
   exec        Execute a command from a particular Go version.
   shell       Set GOENV_VERSION for the lifetime of a shell.
   local       Persist the preferred Go version in the cwd.
   global      Persist the preferred Go default version.
   install     Install a version of Go.
   uninstall   Uninstall a version of Go.
   version     Show the current Go version.
   versions    Display all versions of Go installed in `${GOENV_ROOT}/versions/*'.
   rehash      Rehash goenv shims (run this after installing executables)

See `goenv help <command>' for information on a specific command.

`goenv install`

goenv install 1.7
goenv install gae-1.9.40

Completions

shellname=$(basename $SHELL)

if [ -n "$GOENV_ROOT" ]; then
  if [ -f "$GOENV_ROOT/completions/goenv.$shellname" ]; then
    source "$GOENV_ROOT/completions/goenv.$shellname"
  fi
fi

Credits

This library was heavily, heavily, heavily inspired by @sstephenson's rbenv and ruby-build projects. A few ideas were also taken from nvm.

A number of patterns and utilities are borrowed from that project, and it is my hope that goenv provides the same simplicity, elegance, and usability that I've come to love in rbenv and ruby-build for Go users.

goenv's People