History

Keita Shinyama 7a7caf363d protoc-gen-go-grpc: Update README.md file (#6349 )		2023-06-08 08:54:16 -07:00
..
README.md	protoc-gen-go-grpc: Update README.md file (#6349 )	2023-06-08 08:54:16 -07:00
go.mod	go.mod: update all dependencies after 1.54 branch cut (#6132 )	2023-03-28 16:03:41 -07:00
go.sum	go.mod: update all dependencies after 1.54 branch cut (#6132 )	2023-03-28 16:03:41 -07:00
grpc.go	cmd/protoc-gen-go-grpc: export consts for full method names (#5886 )	2023-02-01 13:20:35 -08:00
main.go	cmd/protoc-gen-go-grpc: bump -version to 1.3.0 for release (#6064 )	2023-03-01 09:58:20 -08:00

README.md

protoc-gen-go-grpc

This tool generates Go language bindings of services in protobuf definition files for gRPC. For usage information, please see our quick start guide.

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=. --go-grpc_opt=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.