网络知识 娱乐 govendor包管理及Go项目热加载

govendor包管理及Go项目热加载

govendor包管理

govendor好处

Go从1.5版本之后,就默认优先使用vendor子目录中的依赖库,而不是$GOPATH/src中的依赖包,这样我们可以把工程源码到处复制,使用时直接go build就可以了,不需要考虑一大堆第三方依赖包的管理问题。

安装govendor

go get -u github.com/kardianos/govendor
/*
		-v:打印出被构建的代码包的名字
		-u:已存在相关的代码包,强行更新代码包及其依赖包
*/

常用命令

		命令 功能
    init 初始化 vendor 目录
    list 列出所有的依赖包
    add 添加包到 vendor 目录,如 govendor add +external 添加所有外部包
    add PKG_PATH 添加指定的依赖包到 vendor 目录
    update 从 $GOPATH 更新依赖包到 vendor 目录
    remove 从 vendor 管理中删除依赖
    status 列出所有缺失、过期和修改过的包
    fetch 添加或更新包到本地 vendor 目录
    sync 本地存在 vendor.json 时候拉去依赖包,匹配所记录的版本
    get 类似 go get 目录,拉取依赖包到 vendor 目录

初始化项目并添加 gin

govendor init

		此时会在当前工程目录(顶层)下面生成一个子目录vendor,里面有个文件vendor.json记录了一些模板信息。

govendor add + external

    它会将你之前单独安装到$GOPATH/src目录下的所有依赖包都复制到本项目的vendor下面,
    并且在vendor.json列出详细的清单。如果$GOPATH/src目录下面没有依赖包,
    会解析当前项目中的go文件来将所有的依赖库先go get下来,存放到vendor下面。

govendor fetch github.com/gin-gonic/gin@v1.6.3
// 添加或更新包到本地vendor目录

govendor list -v fmt
// 可以更详细地查看各种包的依赖关系,但是有些包未显示出来。

实时热重载

为什么需要实时加载

之前使用Python编写Web项目的时候,常见的Flask或Django框架都是支持实时加载的,你修改了项目代码之后,程序能够自动重新加载并执行(live-reload),这在日常的开发阶段是十分方便的。

在使用Go语言的gin框架在本地做开发调试的时候,经常需要在变更代码之后频繁的按下Ctrl+C停止程序并重新编译再执行,这样就不是很方便;

Air热编译

介绍

Air, 它支持以下特性:

1 . 彩色日志输出 2 . 自定义构建或二进制命令 3 . 支持忽略子目录 4 . 启动后支持监听新目录 5 . 更好的构建过程

安装

这也是最经典的安装方式:

go get -u github.com/cosmtrek/air

MacOS
curl -fLo air https://git.io/darwin_air

Linux
curl -fLo air https://git.io/linux_air

Windows
curl -fLo air.exe https://git.io/windows_air

Docker
docker run -it --rm 
    -w "<PROJECT>" 
    -e "air_wd=<PROJECT>" 
    -v $(pwd):<PROJECT> 
    -p <PORT>:<APP SERVER PORT> 
    cosmtrek/air
    -c <CONF>

// 然后按照下面的方式在docker中运行你的项目
docker run -it --rm 
    -w "/go/src/github.com/cosmtrek/hub" 
    -v $(pwd):/go/src/github.com/cosmtrek/hub 
    -p 9090:9090 
    cosmtrek/air

使用Air

为了敲命令时更简单更方便,你应该把alias air='~/.air'加到你的.bashrc或.zshrc中; 首先进入你的项目目录:

cd /path/to/your_project

// 最简单的用法就是直接执行下面的命令:
// 首先在当前目录下查找 `.air.conf`配置文件,如果找不到就使用默认的
air -c .air.conf

//推荐用法

# 1. 在当前目录创建一个新的配置文件.air.conf
touch .air.conf

# 2. 复制 `air.conf.example` 中的内容到这个文件,然后根据你的需要去修改它

# 3. 使用你的配置运行 air, 如果文件名是 `.air.conf`,只需要执行 `air`。
air

示例

完整的air_example.conf示例配置如下,可以根据自己的需要修改;

# [Air](https://github.com/cosmtrek/air) TOML 格式的配置文件

# 工作目录
# 使用 . 或绝对路径,请注意 `tmp_dir` 目录必须在 `root` 目录下
root = "."
tmp_dir = "tmp"

[build]
# 只需要写你平常编译使用的shell命令。你也可以使用 `make`
# Windows平台示例: cmd = "go build -o tmpmain.exe ."
cmd = "go build -o ./tmp/main ."
# 由`cmd`命令得到的二进制文件名
# Windows平台示例:bin = "tmpmain.exe"
bin = "tmp/main"
# 自定义执行程序的命令,可以添加额外的编译标识例如添加 GIN_MODE=release
# Windows平台示例:full_bin = "tmpmain.exe"
full_bin = "APP_ENV=dev APP_USER=air ./tmp/main"
# 监听以下文件扩展名的文件.
include_ext = ["go", "tpl", "tmpl", "html"]
# 忽略这些文件扩展名或目录
exclude_dir = ["assets", "tmp", "vendor", "frontend/node_modules"]
# 监听以下指定目录的文件
include_dir = []
# 排除以下文件
exclude_file = []
# 如果文件更改过于频繁,则没有必要在每次更改时都触发构建。可以设置触发构建的延迟时间
delay = 1000 # ms
# 发生构建错误时,停止运行旧的二进制文件。
stop_on_error = true
# air的日志文件名,该日志文件放置在你的`tmp_dir`中
log = "air_errors.log"

[log]
# 显示日志时间
time = true

[color]
# 自定义每个部分显示的颜色。如果找不到颜色,使用原始的应用程序日志。
main = "magenta"
watcher = "cyan"
build = "yellow"
runner = "green"

[misc]
# 退出时删除tmp目录
clean_on_exit = true

bee热编译

安装

go get -u github.com/beego/bee

使用

# 进入你的项目目录,注意:使用bee 项目必须要在GOPATH目录下
$ cd /your_project
# 运行程序
$ bee run

gin热编译

gin是用于实时重新加载Go Web应用程序的简单命令行实用程序。只需gin在您的应用程序目录中运行,您的网络应用程序将 gin作为代理提供。gin检测到更改后,将自动重新编译您的代码。您的应用在下次收到HTTP请求时将重新启动。 gin 坚持“沉默就是黄金”的原则,因此,只有在出现编译器错误或在错误发生后成功进行编译时,它才会抱怨。

安装

go get github.com/codegangsta/gin

使用

gin run main.go

cd 项目目录
gin -p 3000 -a 9090 -b test.bin --all run

// 表示监听虚拟机的3000端口,将请求转发给9000端口,生成的二进制执行文件 test.bin,所有文件的改动都会引起项目编译

fresh热编译

go get -v -u github.com/pilu/fresh
fresh run main.go