Golang学习--包管理工具glide

上一篇文章中我们已经成功的运行了go的代码，这是我们迈出的最基础的一步。

一个项目通常会依赖很多外部的库，当依赖的库比较多的时候，手工管理就会比较麻烦，这个时候就需要包管理工具出场了，帮你管理好所有依赖的库。

php项目中使用composer，javascript项目中使用npm，那么在go项目中，我们需要使用什么？

包依赖工具的选择

当前go的包管理工具有glide、godep、govendor和gvt等，相关对比的文章可以查看《go依赖包管理工具对比》。

功能对比可以参考如下内容（虽然跟上面文章比较的工具有些不同），内容来自《Go Package Manager Comparison》

	Glide	GB	Godep	Govendor
Semantic Versions	✓	✓	✕	✓
Semantic Version Ranges	✓	✕	✕	✕
Resolves dependency trees including versions	✓	✕	✕	✕
Uses common range syntax (similar to PHP, JavaScript, etc)	✓	✕	✕	✕
Tries to import from other package managers	✓	✕	✕	✕
Copies from the GOPATH	✕*	✕	✓	✓
Works with the go toolchain	✓	✕	✓	✓
Locks for reproducible builds	✓	✓	✓	✓
Allows package/version checked into VCS or installed on demand	✓	✓	✕	✓
Aliased repos (e.g., using forks)	✓	✕	✕	✓
Plugin extensibility model	✓	✓	✕	✕
Supports deleting unused repos for cleanup (opt-in)	✓	✕	✕	✓

根据我们的需求和了解，选择了使用glide，当然大家也可以选择其他包管理工具。

现在官方也出了包管理工具dep，感兴趣的可以查看这篇文章《官方依赖管理工具：dep》

为什么我们不选择dep，而使用glide，有以下两点原因：

我们需要支持VCS，dep暂时不支持
dep需要翻墙

当然如果这两点对你来说不是问题的话，我也推荐大家使用dep

glide命令

我们来熟悉一下glide的命令

# 初始化glide配置

glide create

glide init

# 添加新的包

glide get [package name]

# 根据glide.yaml更新包

glide update

glide up

# 根据glide.yaml安装包

glide install

# 返回当前项目的名称

glide name

# 列出当前项目已安装的包

glide list

# 替换包的镜像

glide mirror set [original] [replacement]

glide mirror set [original] [replacement] --vcs [type]

# 移除包的镜像

glide mirror remove [original]

# 获取包的镜像列表

glide mirror list

glide mirror特别适用于不能访问一些站点，导致很Golang的依赖包不能通过go get下载的情况。可以通过配置将墙了的版本库 URL 映射到没被墙的 URL，甚至也可以映射到本地版本库。

掌握上面的命令就可以使用glide了，是不是很简单？

glide.yaml解析

我们再来看一一个完整的glide.yaml的内容

package: github.com/Masterminds/glide

homepage: https://masterminds.github.io/glide

license: MIT

owners:

- name: Matt Butcher

  email: technosophos@gmail.com

  homepage: http://technosophos.com

- name: Matt Farina

  email: matt@mattfarina.com

  homepage: https://www.mattfarina.com

ignore:

- appengine

excludeDirs:

- node_modules

import:

- package: gopkg.in/yaml.v2

- package: github.com/Masterminds/vcs

  version: ^1.2.0

  repo:    git@github.com:Masterminds/vcs

  vcs:     git

- package: github.com/codegangsta/cli

  version: f89effe81c1ece9c5b0fda359ebd9cf65f169a51

- package: github.com/Masterminds/semver

  version: ^1.0.0

# 测试导入包

testImport:

- package: github.com/arschles/assert

glide.yaml中的这些元素的解释如下：

package：顶部的 package 是它所在GOPATH的位置，glide 将从该位置下开始导包。
homepage：该项目的详情页面。
license：许可证标识，可以是SPDX license字符串或文件路径。
owners：项目的所有者信息，便于接受漏洞信息。
ignore：忽略导入的包，注意是包而不是目录。
excludeDirs：排除扫描依赖的目录。
import：import 的包列表：
- package：导入包的名称，必填。软件包名称遵循go工具所用的相同模式。这意味着：1、映射到VCS远程位置的软件包名称以.git，.bzr，.hg或.svn结尾。例如，example.com/foo/pkg.git/subpkg。2、GitHub, BitBucket, Launchpad, IBM Bluemix Services, and Go on Google Source是特殊情况，不需要 VCS 扩展。
- version：可以为semantic version, semantic version range, branch, tag 或者 commit id。
- repo：如果包名称不是repo位置或这是一个私人存储库，它可以去这里。该软件包将从repo签出并放在软件包名称指定的位置。这允许使用fork。
- vcs：要使用的VCS，如git，hg，bzr或svn。仅当无法从名称中检测到类型时才需要。例如，以.git或GitHub结尾的仓库可以被检测为Git。对于Bitbucket的repo，我们可以联系API来发现类型。
- subpackages：在存储库中使用的包的记录。这不包括存储库中的所有包，而是包括正在使用的包。
- os：用于过滤的操作系统的列表。如果设置它将比较当前运行时操作系统与指定的操作系统，并且只有获取匹配的依赖。如果未设置过滤，则跳过。这些名称与构建标志和GOOS环境变量中使用的名称相同。
- arch：用于过滤的体系结构列表。如果设置它将比较当前运行时架构与指定的架构，并且只有在匹配时获取依赖关系。如果未设置过滤，则跳过。名称与构建标志和GOARCH环境变量中使用的名称相同。
testImport：在导入中未列出的测试中使用的软件包列表。每个包具有与导入下列出的相同的详细信息。

glide版本号指定规则如下：

=: equal (aliased to no operator)

!=: not equal

>: greater than

<: less than

>=: greater than or equal to

<=: less than or equal to

1.2 - 1.4.5 which is equivalent to >= 1.2, <= 1.4.5

2.3.4 - 4.5 which is equivalent to >= 2.3.4, <= 4.5

1.2.x is equivalent to >= 1.2.0, < 1.3.0

>= 1.2.x is equivalent to >= 1.2.0

<= 2.x is equivalent to < 3

* is equivalent to >= 0.0.0

~1.2.3 is equivalent to >= 1.2.3, < 1.3.0

~1 is equivalent to >= 1, < 2

~2.3 is equivalent to >= 2.3, < 2.4

~1.2.x is equivalent to >= 1.2.0, < 1.3.0

~1.x is equivalent to >= 1, < 2

^1.2.3 is equivalent to >= 1.2.3, < 2.0.0

^1.2.x is equivalent to >= 1.2.0, < 2.0.0

^2.3 is equivalent to >= 2.3, < 3

^2.x is equivalent to >= 2.0.0, < 3

要注意的是安装完成之后，会生成glide.lock文件，锁定安装包的版本。

代码可参考：https://github.com/CraryPrimitiveMan/go-in-action/tree/master/ch2

参考摘录文章