# goc

goc v2 版本开发中

## Quick Start

### 编译要求 

`Go 1.16+`

### 新特性一览

#### 1. 只支持 go module 工程

考虑到 GOPATH 已被官方明确将淘汰，以及支持 GOPATH 工程带来的巨大工作量，v2 不再支持 GOPATH 工程。

#### 2. 命令行 flag 解析优化

在 v1 版本中，`go build -o -ldflags 'foo=bar' ./app/main.go` 与 goc 命令并不等价，首先你需要切换到 `.app/` 目录中，然后执行 `goc build --buildflags="-o -ldflags 'foo=bar' ."`。这个转换给使用者带来不小的负担，特别是 `'"` 混杂在一起时，感觉会更难受。

在 v2 版本中，goc 编译命令和 go 编译命令已经极为相似，例如

```bash
go build -o -ldflags 'foo=bar' ./app/main.go
# 等价于
goc build -o -ldflags 'foo=bar' ./app/main.go
#
go build -o -ldflags 'foo=bar' ./app
# 等价于
goc build -o -ldflags 'foo=bar' ./app
#
go install ./app/...
# 等价于
goc install ./app/...
#
```

由于 go 命令对 flags 和 args 的相对位置有着严格要求：`go build [-o output] [build flags] [packages]`，所以 goc 命令中 `[build flags]` 的位置也类似。而 goc 自己的 flags 则相对灵活：

```bash
goc build -o -ldflags 'foo=bar' ./app --gocdebug --gochost "127.0.0.1:7779" 

goc build --gocdebug -o -ldflags 'foo=bar' ./app --gochost "127.0.0.1:7779" 
```

两者都对。如果不想最小化的改动 go 编译命令，那么 `--gochost` 可以不指定，在服务启动时指定坏境变量就能动态改变注册中心地址：

```
export GOC_CUSTOM_HOST="127.0.0.1:7779"
./agent
```

#### 3. 日志优化

带颜色日志，以及长时间操作时（例如 build, copy）会有转圈动画。

#### 4. 被测服务部署优化

在 v1 版本中，当被测服务在 docker 中，goc server 在外部时，会要求在容器启动时额外开启端口转发，并且编译还需带额外参数。这给部署带来不便。

在 v2 版本中，不再有这一限制，只需要 goc server 能够被被测服务访问即可。

#### 5. watch 模式

当使用 `goc build --gocmode watch .` 编译后，被测服务任何覆盖率变化都将实时推送到 goc server。

用户可以使用该 websocket 连接 `ws://[goc_server_host]/v2/cover/ws/watch` 观察到被测服务的新触发代码块，推送信息格式如下：

```bash
qiniu.com/kodo/apiserver/server/main.go:42.49,43.13 1 0
#
# importpath/filename.go:Line0.Col1,Line1,Col1 1 0
```

除此之外，原来的全局整体覆盖率可正常获取，不受影响。

#### 6. 跨平台支持

1. 支持 `Linux/Macos/Windows`
2. 支持 go 的交叉编译