documentation generator & other tools for protobuf/gRPC
This repository holds various Protobuf/gRPC tools:
protoc-gen-doc is a Protobuf compiler plugin for generating HTML documentation from
.protofiles using standard Go HTML template files.
protoc-gen-json is a Protobuf compiler plugin for generating a JSON dump file for the
protocplugin generation request. It is primarily useful for running tests without invoking
protocdirectly (e.g. via the Go testing suite).
protoc-gen-dump is just like
protoc-gen-jsonexcept it dumps output in protobuf format itself. It's much better than
protoc-gen-jsonif you can make use of it because there are certain fields (e.g. extensions) which are explicitly marked as non-JSON-encodable. If you wish to retain e.g. grpc-gateway google.api.http annotations, you'll need to make use of
protoc-gen-dumpinstead of
protoc-gen-json.