Work-in-progress. The design, and structure are not finalized (nor backwards-compatible) yet.
The folder google/*
was cloned from github.com/googleapis/api-common-protos. The folder protoc-gen-openapiv2/*
was cloned from github.com/grpc-ecosystem/grpc-gateway/protoc-gen-openapiv2.
You need to install the following tools to build locally:
- The protoc compiler
- The following compiler plugins:
$ go get -u -v google.golang.org/protobuf/cmd/protoc-gen-go \
google.golang.org/grpc/cmd/protoc-gen-go-grpc \
github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-grpc-gateway \
github.com/grpc-ecosystem/grpc-gateway/v2/protoc-gen-openapiv2 \
github.com/pseudomuto/protoc-gen-doc/cmd/protoc-gen-doc
- The buf tool
Then run:
$ ./build.sh
Generated SDKs from updates to this repository:
The generated OpenAPI documentation can be found here.