Go - 使用工具生成易读的 Protocol 文档

最新推荐文章于 2024-05-12 09:35:39 发布

程序员新亮

最新推荐文章于 2024-05-12 09:35:39 发布

阅读量380

点赞数

文章标签： protobuf github json python plugin

本文链接：https://blog.csdn.net/XinLiangTalk/article/details/122613083

版权

文章目录：

前言
protoc-gen-doc
- 安装
- 使用
- 演示
小结
推荐阅读

前言

通过 .proto 文件能否生成更易阅读 HTML 文档？

关于这个问题，我找到了一个插件，给大家分享一下。

protoc-gen-doc

protoc-gen-doc^[1] This is a documentation generator plugin for the Google Protocol Buffers compiler (protoc). The plugin can generate HTML, JSON, DocBook and Markdown documentation from comments in your .proto files.

安装

go get -u github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc

使用

--doc_out=helloworld/doc \
--doc_opt=html,index.html

演示

以上篇文章 helloworld.proto 为例。

// 使用的 protoc --version 为 libprotoc 3.18.1
// 使用的 protoc-gen-go --version 为 protoc-gen-go v1.27.1
// 使用的 protoc-gen-go-grpc --version 为 protoc-gen-go-grpc 1.1.0
// 使用的 protoc-gen-doc --version 为 protoc-gen-doc version 1.5.0
// 在根目录下执行 protoc 命令
protoc \
--go_out=helloworld/gen \
--go-grpc_out=helloworld/gen \
--doc_out=helloworld/doc \
--doc_opt=html,index.html \
helloworld/helloworld.proto