gip要解决什么问题？

1. go项目的版本依赖，希望所有的开发、测试、生产环境跑的版本都是相同的；
2. 虽然go的vendor机制能够解决#1中的问题，但是会带来另一个问题：开发过程中如果有两个项目，A和B，A依赖B，但是，我们需要经常改B，所以又不想把B放到A的vendor下；那么如果A和B里面都有一个vendor的时候，就有可能会出现一些诡异的编译错误；参考 https://github.com/akutz/gpd
3. 在中国不翻墙就能把依赖拉下来

现有方案的一些问题

1. glide：Glide可以解决#1和#3的问题，但是解决不了#2的问题；特别是当需要同时修改多个代码库的时候就会很痛苦；
2. vg + dep: 可以解决#1和#2的问题，但是解决不了#3的问题；因为每次dep ensure的时候都需要去获取依赖的meta信息；
3. gigo，解决#1的问题

gip怎么做

参考了 vg 和 gigo 的思路，gip想要实现的是python中 pip 的组合，再配合direnv来实现GOPATH的切换。

NOTE：大量借鉴了vg 的代码设计和实现。

1. 每次进入一个项目，自动激活这个项目的GOPATH
   • 依赖direnv实现；在项目根目录下准备.envrc文件，当进入该文件夹时，自动将配置的GOPATH加到默认GOPATH之前；
2. 有一个requirements.txt，记录依赖的go package以及这些package对应的下载地址（现在只支持git）
3. 提供freeze方法（类似 pip freeze），输出现有的依赖库以及版本

关于循环依赖

• 当项目的依赖库也是gip管理的时候，gip会递归找到所有gip管理的依赖包进行按照。
• 使用BFS进行遍历依赖包；如果有重复依赖产生冲突，会以首次被遍历到的依赖包版本为准。

使用方法

0. 安装gip

   # install gip;
   go get -u github.com/caojia/gip
   
   # you can also download gip from directly from releases page
   # https://github.com/caojia/gip/releases
   
   # setup of direnv
   gip setup
   

1. 初始化一个项目

   # Just initialize a new envrc, which will set an isolated GOPATH
   gip init $name
   

2. 正常开发

   # install the requirements first
   gip install requirements.txt
   
   # use normal gip to install packages, $options and $pkg will pass to go get
   gip get -- $options $pkg
   # or specify the git clone url
   gip get github.com/golang/net#master,golang.org/x/net
   
   # coding, coding, coding
   
   # before push, generate the requirements.txt and commit it
   gip freeze > requirements.txt
   

3. 指定版本和repo地址

   可以在当前gip.yaml中配置某些package的指定版本和repo地址

   例如：

   imports:
   	- package: golang.org/x/net
   	  repo: https://github.com/golang/net
   	- package: xxx/x/x
   	  repo: an internal url
   	  version: master
   	  global: true
   

4. 如果某个依赖库，本地做了修改，gip 会先做git stash；所以如果发现本地修改丢失，可以通过 git stash list 和 git reflog 来找回。

gip.yml说明

gip会自动读取当前目录下的gip.yml文件，该文件可以配置任意依赖包的下载地址、版本以及是否下载到全局依赖。

配置说明：

Key	Description
package	package name
repo	where to fetch the package, e.g. if a package is blocked by gfw, push it to your internal git host, and set the repo to the new address.
version	if it's a branch name, gip will always install the latest commit of that branch; default is empty
global	if it's true, gip will install it in the default GOPATH, otherwise, it will be installed in the path where .envrc sets; default it false