原文链接:http://tabalt.net/blog/golang-package-dependency-management-tool-gb/
一个Golang项目工程通常由bin
、pkg
、src
三个子目录构成,gb在这个概念的基础上新增了一个vendor
目录来存放项目依赖的第三方包;一个gb项目的工作目录里包含该项目需要的所有Go代码。
gb项目不放在你的\$GOPATH中,也不需要为你的gb项目设置或修改\$GOPATH。依赖的第三包需要放到vendor/src
目录中,并使用gb来编译和测试你的项目。
安装gb
gb的官网是:[](http://getgb.io/)http://getgb.io/,github地址是:[](https://github.com/constabulary/gb/)https://github.com/constabulary/gb/。
使用如下命令即可安装gb:
go get github.com/constabulary/gb/...
安装gb后,会有gb
和gb-vendor
两个可执行文件放入你的$GOPATH/bin
目录中,查看或编辑你的~/.bash_profile
文件,确保你的$GOPATH/bin
目录已经加入$PATH
中:
export PATH=$PATH:$GOPATH/bin
使用gb进行项目开发
我们以一个简单的提供HTTP页面的“Hello World”程序来学习一下gb的使用。为了体现gb管理第三方包依赖的特性,我们引入一个支持HTTP服务优雅重启的第三方包 github.com/tabalt/gracehttp。
创建gb项目目录结构:
cd ~/helloworld
mkdir -p src/helloworld
mkdir -p vendor/src
编写“Hello World”程序
#vim src/helloworld/main.go
package main
import (
"fmt"
"net/http"
"github.com/tabalt/gracehttp"
)
func main() {
http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
fmt.Fprintf(w, "hello world")
})
err := gracehttp.ListenAndServe(":8080", nil)
if err != nil {
fmt.Println(err)
}
}
添加依赖的第三包
gb vendor fetch github.com/tabalt/gracehttp
目前为止整个项目目录结构如下:
./
|-- src
| `-- helloworld
| `-- main.go
`-- vendor
|-- manifest
`-- src
`-- github.com
`-- tabalt
`-- gracehttp
|-- README.md
|-- connection.go
|-- gracehttpdemo
| `-- main.go
|-- listener.go
`-- server.go
编译执行程序
gb build helloworld
./bin/helloworld
打开一个新终端并执行curl http://127.0.0.1:8080/
,将会输出:
hello world
提交所有代码到git仓库
git init
git add .
git commit -am 'init hello world project with gb'
git add remote -v $your_remote_git_repository
git push origin master:master
gb常用命令
在上面的项目开发中,我们用到了两个命令gb build
和 gb vendor
,实际上,build
是我们之前所说的可执行文件$GOPATH/bin/gb
包含的,而vendor是gb的一个插件,最终调用的是可执行文件$GOPATH/bin/gb-vendor
。
可以通过gb help
命令查看gb支持的更多命令,命令的具体用法可以通过gb help $command_name
查看,很多gb命令都是在go命令行工具的基础上做的包装,用法也都相似,通过gb vendor help
可以查看vendor插件具体用法,这里我们简单列举如下:
gb 命令列表
命令 功能
build 编译包 doc 显示文档 env 打印项目的环境变量 generate 处理源代码生成Go文件 info 显示项目的信息 list 显示项目下的所有包 test 执行测试
gb vendor 功能列表
参数 功能
fetch 获取一个远程依赖 update 更新一个本地依赖 list 每行一个列出所有依赖 delete 删除一个本地依赖 purge 清除所有未引用的依赖 restore 从manifest清单文件还原依赖
原文链接:http://tabalt.net/blog/golang-package-dependency-management-tool-gb/