schnutibox/vendor/google.golang.org/grpc/cmd/protoc-gen-go-grpc/README.md

22 lines
855 B
Markdown
Raw Normal View History

2021-05-04 08:41:43 +02:00
# protoc-gen-go-grpc
This tool generates Go language bindings of `service`s in protobuf definition
files for gRPC. For usage information, please see our [quick start
guide](https://grpc.io/docs/languages/go/quickstart/).
## Future-proofing services
By default, to register services using the methods generated by this tool, the
service implementations must embed the corresponding
`Unimplemented<ServiceName>Server` for future compatibility. This is a behavior
change from the grpc code generator previously included with `protoc-gen-go`.
To restore this behavior, set the option `require_unimplemented_servers=false`.
E.g.:
```
protoc --go-grpc_out=require_unimplemented_servers=false[,other options...]:. \
```
Note that this is not recommended, and the option is only provided to restore
backward compatibility with previously-generated code.