Awesome
Go Versioning Packager
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 but both tools can be used independently from each other.
Example usage: Go Dependency Management and Vendoring with gpm + gvp:
Installation
Install in *nix (preferred method)
$ git clone https://github.com/pote/gvp.git && cd gvp
$ git checkout v0.2.1 # You can ignore this part if you want to install HEAD.
$ ./configure
$ make install
Install via Homebrew
$ brew install gvp
Usage
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.
First,
$ source gvp
After gvp
has been sourced, these commands are available:
usage: gvp [COMMAND]
[...]
COMMANDS
source gvp Modifies GOPATH and GOBIN to use the .godeps directory.
gvp version Outputs version information.
gvp help Prints this message.
gvp in The function that is called when executing "source gvp"
gvp out Return the prompt to normal
Using with autoenv
Simply run:
cd /path/to/project
touch .env
echo "source /path/to/gvp" > .env
Plugins
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-<command> 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.
Why?
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 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.