gvp stands for Go Versioning Packager and is based on gst, a similar tool that provides dependency isolation for Ruby gems.
The tool modifies your GOPATH
to point to a local .godeps/
directory so that you can keep the dependencies of your project isolated there, it also modifies GOBIN
and PATH
to include the new GOPATH/bin
directory.
gvp is a companion tool to gpm, the Go Package Manager.
Example usage: Go Dependency Management and Vendoring with gpm + gvp:
$ brew install gvp
$ git clone https://github.com/pote/gvp.git && cd gvp
$ git checkout v0.1.0 # You can ignore this part if you want to install HEAD.
$ ./configure
$ make install
Since gvp
is a script and runs in a child environment of your shell, the latter will not take the env changes unless you source
them.
$ gvp init
$ source gvp in
$ source gvp out
init Creates the .godeps directory
in Modifies GOPATH, GOBIN and PATH to use the .godeps
out Restores the previous GOPATH, GOBIN and PATH.
version outputs version information.
help prints this message.
As of v0.1.0 gvp includes a plugin system very much similar to the one in gpm.
The way gvp plugin work is simple: whenever an unknown command is passed into gvp it will look for an executable in your $PATH called gvp- and if it exists it will run it while passing all extra arguments to it, simple yet powerful.
This brings a lot to the table: plugins can be written in anything, they can be Go binaries, bash scripts, Ruby gems, Python packages, you name it. gvp wants to make it easy for you to extend it. :)
If you happen to write a plugin for gvp: please open an issue so we can compile a list of useful plugins as well as add them to the gpm homebrew tap so users can install them easily.
Dependencies of multiple Go projects are by far easier to handle in isolation, using plain gpm to handle your dependencies means that you are forced to run it again every time you work on a new project, this can get old quickly.
Using gvp
can greatly simplify your workflow, by isolating your Go project dependencies you only need to run source gvp in
in order to be back in the work environment of your application, this means that there will never be Go packages installed in
your system which will conflict in versioning across your different projects.
If for some reason you need to ship your repository with its dependencies included this is also of help, but including a
Godeps
file to use with gpm will probably be your best option.