gobuild

README

gobuild

gobuild 是一个简单的 Go 代码热编译工具。 会实时监控指定目录下的文件变化(重命名，删除，创建，添加)，并编译和运行程序。

• 采用配置文件，表达更加方便和直观；
• 自动生成配置文件；
• 可以设置多个监视目录；
• 本地化支持；

命令行语法

主要包含了 watch 和 init 两个子命令。具体的子命令可以通过 gobuild help 查看。

init

初始化项目，添加项目的必备的文件，比如热编译的配置文件 .gobuild.yaml。 如果是空目录，还会顺带初始化 go.mod 等文件。

gobuild init github.com/owner/mod

watch

监视文件并进行热编译，热编译的配置项从当前目录下的 .gobuild.yaml 加载。

gobuild watch [options]

配置文件

配置文件为当前目录下的 .gobuild.yaml，可由 gobuild init 子命令生成，包含了以下字段：

字段	类型	描述
main	string	指定需要编译的文件，如果为空表示当前目录。
output	string	指定可执行文件输出的文件路径
flags	map	指定可执行文件输出的文件路径
exts	[]string	指定监视的文件扩展名，如果包含了 *，表示所有文件类型，包括没有扩展名的。
args	string	传递给编译成功后的程序的参数
recursive	bool	是否监视子目录
dirs	dirs	表示需要监视的目录
freq	duration	监视器的更新频率
excludes	[]string	忽略的文件，glob 格式，高于 exts 配置项。

支持平台

平台支持依赖 colors 与 fsnotify 两个模块， 目前支持以下平台：windows, linux, macOS, BSD。

安装

macOS 和 linux 用户可以直接使用 brew 进行安装：

brew tap caixw/brew
brew install caixw/brew/gobuild

常用平台可以从 https://github.com/caixw/gobuild/releases 下载，并将二进制文件放入 PATH 即可。

如果不存在你当前平台的二进制，可以自己编译：

git clone https://github.com/caixw/gobuild.git
cd gobuild
./build.sh

版权

本项目采用 MIT 开源授权许可证，完整的授权说明可在 LICENSE 文件中找到。

Documentation

Index

• func Init(wd, name string) error
• func Watch(ctx context.Context, o *WatchOptions) error
• type WatchOptions

Functions

func Init

func Init(wd, name string) error

Init 初始化一个空的项目

wd 为工作目录，将在此目录下初始化项目； name 为 go.mod 中定义的模块的名称。 name 的最后一个元素会作为名称在 wd 指定的目录下创建子目录， 同时在子目录下会添加以下内容：

• go.mod 以 name 作为模块名；
• .gobuild.yaml 为 gobuild 的配置文件；
• cmd/{base}/{base}.go 程序入口 main 函数，base 为 name 的最后一个元素；

func Watch

func Watch(ctx context.Context, o *WatchOptions) error

Watch 监视文件变化执行热编译服务

如果初始化参数有误，则反错误信息，如果是编译过程中出错，将直接将错误内容输出到 watch.Logger。

Types

type WatchOptions

type WatchOptions = watch.Options