
gogv:用 Go 实现的 Graphviz dot 工具发布
来源标题:Show HN: Graphviz Dot in Go (CLI, Lib and WebAssembly)
开发者发布了 gogv,这是一个完全用 Go 编写的 Graphviz dot 实现,无需 cgo、无需安装 Graphviz,也没有嵌入 WebAssembly。它支持将 DOT 语言的图渲染为 SVG 等输出格式,可作为 CLI、库和 WebAssembly 使用。该工具依据公开论文和 Graphviz 16.1.0 的行为实现,不包含 Graphviz 或其移植版本的代码。
以下正文由 AI 翻译自 Hacker News 最新(原文版权归原站所有),可能存在偏差,重要内容请以原文为准。
用 Go 实现的 Graphviz dot 程序:它布局以 DOT 语言编写的图,并将其写出为 SVG 以及 dot 的其他输出格式。它不需要 cgo、不需要内嵌 WebAssembly,也不需要已安装的 Graphviz,并且可以作为以下形式使用: 图片是 gogv 对 docs/example.gv 的 SVG 输出。 gogv 与 Graphviz 项目无隶属关系,也未受其认可。 gogv 依据已发表的论文、Graphviz 文档以及将 Graphviz 16.1.0 作为黑盒观察到的行为编写。它不包含来自 Graphviz 或其移植版和绑定的任何代码。每个 Go 文件都在 Provenance: 行中注明其来源(make provenance 会检查这些行): 文本使用由 Liberation 2.1.5 字体生成的表来度量,这些字体在度量上与 Times New Roman、Arial 和 Courier New 兼容;模块中不包含任何字体。初等函数来自 fdlibm 的移植,因此输出在每个平台上都逐字节相同。
尚未支持的 Graphviz 特性会给出警告说明这一点,并指出改用哪个默认值;Graphviz 未记录的属性会被忽略,正如 Graphviz 忽略它们一样。
需要 Go 1.26 或更高版本。命令行: go install github.com/ekalinin/gogv/cmd/dot@latest 该命令名为 dot,与 Graphviz 的相同:当 Graphviz 也已安装时,PATH 中先找到的 dot 会运行。dot -V 可以区分它们(见命令行)。 go get github.com/ekalinin/gogv 构建 go build -o dot ./cmd/dot echo 'digraph { a -> b -> c; a -> c }' | ./dot -Tsvg > out.svg ./dot -V 库 gogv.Render 会布局 DOT 文本中的每个图,并以 gogv.Formats() 中的一种格式写出,其字节与 dot -T<format> 写出的相同: package main import ( "context" "fmt" "log" "os" "github.com/ekalinin/gogv" ) func main() { out, warnings, err := gogv.Render(context.Background(), "digraph { a -> b }", "svg") if err != nil { log.Fatal(err) for _, w := range warnings { fmt.Fprintln(os.Stderr, "warning:", w) os.Stdout.Write(out) 警告是返回的,而不是写出的:gogv.Warning 会指出对象、尚未支持的特性以及改用哪个默认值。语法错误是带行号的 *gogv.SyntaxError,而 Render 不写出的格式是 *gogv.FormatError。Render 可安全并发使用,并且在上下文被取消时以该上下文的错误停止。 dot 读取其命令行中指定的文件或标准输入,并写到标准输出或 -o 指定的文件。它接受 -T<format>、-o<file>、-V 和 -Kdot;它会拒绝 Graphviz 的 dot 的其他标志并以退出状态 1 退出,而不是忽略它们。-V 写出 dot - graphviz version 16.1.0 (gogv VERSION),以便从中读取 Graphviz 版本的程序能找到 gogv 所遵循的版本。 输出与在固定容器(tools/reference/Dockerfile)中构建的、未使用 Pango 的 Graphviz 16.1.0 的输出逐层比较:canon 逐字节比较,plain 按节点、边和尺寸比较(在 5% 以内),svg 按尺寸比较(在 5% 以内)以及光栅化文档的结构相似性(SSIM 至少 0.90)。dot、xdot 和 JSON 输出会被解析,并且必须具有参考输出的对象、属性和绘制操作,值相等但布局数字除外,且尺寸在 5% 以内;dot_json 和 xdot_json 逐字节比较。语料库是 testdata/conformance/cases 中的精选用例,以及在用 make harvest 收集时,gopuml 为其自身一致性用例生成的 DOT。 make harvest 通过 Go module proxy 获取 Makefile 中 GOPUML_VERSION 版本的 gopuml,并用 gopuml 自己的脚本获取其语料库中的 Vega 用例,因此它需要网络访问以及 Docker 和参考镜像;不需要 gopuml 检出。make harvest GOPUML=<dir> 则从本地 gopuml 检出中收集。报告会列出本次运行的语料库以及每个收集到的语料库来自哪个 gopuml。 make reference-image # 构建参考镜像(Docker) make reference # 记录精选用例的参考输出 make harvest # 收集 gopuml 语料库并记录其参考输出 tools/reference/fetch-tools.sh go generate ./internal/textmetrics # 获取 Liberation 字体 make conformance # 比较并写出 conformance-report.md make determinism # 比较原生、amd64 和 WebAssembly 输出 conformance-report.md 中有当前结果。使用尚未支持的特性的用例会被如此报告;其余差异列在 testdata/conformance/known-differences.yaml 中。 发布版本是 CI 已通过的 main 提交上的标签 vX.Y.Z,其说明在 docs/releases/vX.Y.Z.md 中: 编写 docs/releases/vX.Y.Z.md,并在拉取请求中将其合并到 main。 一旦 CI 在合并提交上通过,就在最新的 main 上运行: make release VERSION=vX.Y.Z 它会检查版本、说明、分支、已跟踪文件没有未提交的更改(未跟踪文件,例如尚未归档的 OpenSpec 更改,不计入)、标签尚不存在以及 CI 已通过,然后为该提交打标签、推送标签,并用说明创建 GitHub release。它需要已登录的 gh。 已推送的标签永远不会移动:一旦 Go module proxy 获取了它,其内容就固定了。然后发布版本用以下命令安装: go install github.com/ekalinin/gogv/cmd/dot@vX.Y.Z 贡献遵循 CONTRIBUTING.md 的净室规则、检查和约定。
正文由 探How 从来源站点 RSS 同步,内容未经改写;遇到排版缺失或需要图片、视频时请以原文为准。