当前位置

网站首页> 程序设计 > 开源项目 > 程序开发 > 浏览文章

Golang包依赖管理工具gb - 服务端码农的随笔

作者:小梦 来源: 网络 时间: 2024-05-19 阅读:

原文链接:http://tabalt.net/blog/golang-package-dependency-management-tool-gb/

一个Golang项目工程通常由binpkgsrc三个子目录构成,gb在这个概念的基础上新增了一个vendor目录来存放项目依赖的第三方包;一个gb项目的工作目录里包含该项目需要的所有Go代码。

gb项目不放在你的$GOPATH中,也不需要为你的gb项目设置或修改$GOPATH。依赖的第三包需要放到vendor/src目录中,并使用gb来编译和测试你的项目。

安装gb

gb的官网是:http://getgb.io/,github地址是:https://github.com/constabulary/gb/。

使用如下命令即可安装gb:

go get github.com/constabulary/gb/...

安装gb后,会有gbgb-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 ~/helloworldmkdir -p src/helloworldmkdir -p vendor/src

编写“Hello World”程序

#vim src/helloworld/main.gopackage mainimport (    "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 initgit add .git commit -am 'init hello world project with gb'git add remote -v $your_remote_git_repositorygit push origin master:master

gb常用命令

在上面的项目开发中,我们用到了两个命令gb buildgb 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/