protoc-gen-twirp-gateway

WARNING: This is alpha quality code, do not use in production.

Generate google.api.HttpRule defined gateways for your Twirp RPC Go services.

Usage

See Google's gRPC transcoding documentation for gRPC examples if you haven't used google.api.HttpRule before.

protoc --go_out="." --twirp_out="." --twirp-gateway_out="." $proto

Motivation

• Keep your twirp protobuf service definitions grpc and grpc-gateway compatible.
• Provide RESTful endpoints on serverless plaforms that don't support gRPC such as non GKE Google Cloud Run deployed services.
• Implement REST, Twirp and gRPC interface endpoints all using the same IDL and concrete service implementation.

TODO

• Tests.
• RAML YAML.
• OpenAPI (Swagger) YAML.