| commit | 415f7d0548fbf101279a9e4a01efe5c52d137876 | [log] [tgz] |
|---|---|---|
| author | Filippo Valsorda <filippo@cloudflare.com> | Sat Sep 05 02:57:42 2015 +0100 |
| committer | Filippo Valsorda <filippo@cloudflare.com> | Sat Sep 05 02:57:42 2015 +0100 |
| tree | fd2cf8dfd112f5e299aad7abd201055ce25c53f2 |
Initial commit based on gb c057f8ce
gvt is a simple Go vendoring tool made for the GO15VENDOREXPERIMENT. It's based entirely on gb-vendor.
You run gvt fetch when you would run go get. gvt downloads dependencies to ./vendor/. With GO15VENDOREXPERIMENT=1 set the compiler will find and use those packages without need to do import path rewriting. gvt works recursively as you would expect, and lets you update vendored dependencies. It also writes a manifest to ./vendor/manifest.
Packages whose dependencies are vendored with gvt are go build-able and go get-able by Go 1.5 with GO15VENDOREXPERIMENT=1 set.
go get -u github.com/FiloSottile/gvt
$ gvt fetch github.com/fatih/color
2015/09/05 02:38:06 fetching recursive dependency github.com/mattn/go-isatty
2015/09/05 02:38:07 fetching recursive dependency github.com/shiena/ansicolor
$ tree -d
.
└── vendor
└── github.com
├── fatih
│ └── color
├── mattn
│ └── go-isatty
└── shiena
└── ansicolor
└── ansicolor
9 directories
$ cat > main.go
package main
import "github.com/fatih/color"
func main() {
color.Red("Hello, world!")
}
$ export GO15VENDOREXPERIMENT=1
$ go build .
$ ./hello
Hello, world!
$ gvt update github.com/fatih/color
There are many Go vendoring tools, but they all have some subset of the following problems
* no GO15VENDOREXPERIMENT support: old tools are based on import path rewriting or GOPATH overrides * requirement to run on clients: some require the user to install the tool and run it after cloning, which breaks `go get` * **no real fetching support**: tools like Godep just copy source from your GOPATH, instead of pulling it from the Internet * prominent metadata files: there's no need for the manifest to be in your repository root, or in its own empty folder * entire different build stack: gb-vendor is awesome but it requires you to build your project with gb