trash is a minimalistic vendoring tool that you configure with
vendor.conf file. This example is for
# package github.com/rancher/trash github.com/Sirupsen/logrus v0.10.0 github.com/urfave/cli v1.18.0 github.com/cloudfoundry-incubator/candiedyaml 99c3df8 https://github.com/imikushin/candiedyaml.git github.com/stretchr/testify v1.1.3 github.com/davecgh/go-spew 5215b55 github.com/pmezard/go-difflib 792786c golang.org/x/sys a408501
The first non-comment line is the package we're managing ./vendor for (note: this can be literally any package in your project, not just the root one).
Commented lines begin with
Each non-empty and non-comment line lists one dependency. Only the "root" package of the dependency needs to be listed.
After the package name goes the version (commit, tag or branch) and optionally the package repository URL (by default, it's inferred from the package name).
To populate your ./vendor dir, you need to have
vendor.conf file in the current dir and just run:
Trash will clone the vendored libraries into
~/.trash-cache (by default), checkout requested versions, copy the files into
./vendor dir and prune non-imported packages and test files. This last step keeps your ./vendor lean and mean and helps save space in your project repo.
Note: as of v0.2.5 trash is available for Linux and macOS, and only supports git to retrieve packages, as git's the most popular one, but we're working on adding all the others that
go get supports.