- go项目的版本依赖,希望所有的开发、测试、生产环境跑的版本都是相同的;
- 虽然go的vendor机制能够解决#1中的问题,但是会带来另一个问题:开发过程中如果有两个项目,A和B,A依赖B,但是,我们需要经常改B,所以又不想把B放到A的vendor下;那么如果A和B里面都有一个vendor的时候,就有可能会出现一些诡异的编译错误;参考 https://github.com/akutz/gpd
- 在**不翻墙就能把依赖拉下来
- glide:Glide可以解决#1和#3的问题,但是解决不了#2的问题;特别是当需要同时修改多个代码库的时候就会很痛苦;
- vg + dep: 可以解决#1和#2的问题,但是解决不了#3的问题;因为每次
dep ensure
的时候都需要去获取依赖的meta信息; - gigo,解决#1的问题
参考了 vg 和 gigo 的思路,gip想要实现的是python中 pip 的组合,再配合direnv来实现GOPATH的切换。
NOTE:大量借鉴了vg 的代码设计和实现。
- 每次进入一个项目,自动激活这个项目的GOPATH
- 依赖direnv实现;在项目根目录下准备.envrc文件,当进入该文件夹时,自动将配置的GOPATH加到默认GOPATH之前;
- 有一个requirements.txt,记录依赖的go package以及这些package对应的下载地址(现在只支持git)
- 提供freeze方法(类似
pip freeze
),输出现有的依赖库以及版本
-
安装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
-
初始化一个项目
# Just initialize a new envrc, which will set an isolated GOPATH gip init $name
-
正常开发
# 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
-
指定版本和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
-
如果某个依赖库,本地做了修改,gip 会先做
git stash
;所以如果发现本地修改丢失,可以通过git stash list
和git reflog
来找回。
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 |