goenv - virtual environments for Go

goenv lets you create virtual environments for your Go projects. This means that you can install all the dependencies locally for your project without cluttering your user- or system-wide GOPATH.

It was inspired by pythons vex and opens a subshell for your Go virtual environment (in the following only goenv) and doens't mess with your environment variables, like pythons virtualenv does. To exit your goenv you only have to leave the subshell and your are in the exact same state where you started it.

goenv is a single bash script and has no other dependencies, except Go.

I've tested it with bash and zsh. Maybe it will work with other shells, too.

Features

if a .project file exists in the $GOPATH root, then goenv will cd into the directory which is specified in the first line of that file when the goenv is started
- an easy way to create such a file is like this (assumed that you're currently in the project directory and the corresponding goenv is activated): pwd > $GOPATH/.project
- next time you activate the goenv, you will be automically cd'ed into the project path
if the startup script startup.sh exists in the $GOPATH root, then it will be executed when the goenv is started

Installation

The installation is super simple, you have to set the GOENVS environment variable and source the goenvs.sh script. Add the following lines to your .bashrc/.zshrc:

export GOENVS=~/path/to/goenvs      # create the directory
source /path/to/goenvs/goenvs.sh

If you've already the set the GOPATH globally, make sure that your GOPATH is only set if it's unset, so that goenv is able change it in a subshell. Substitute your export GOPATH with the following one and you are good to go:

export GOPATH=${GOPATH:-/default/gopath}

Help

run goenv without parameter or goenv -h to view the help.
when you want to execute a command in goenv using the -e/--exec flags, make sure that you write your commands in single quotes, g.e.:

goenv -c evalia && goenv -e evalia 'go get github.com/heyLu/linguaevalia && linguaevalia'

you can run a temporary goenv with goenv -t, it will be deleted after you leave it

Demo

recorded with tty2gif.

Todo