From ad83e0b77af206adbecf6a6b7100520306aabef1 Mon Sep 17 00:00:00 2001 From: Richard Belleville Date: Mon, 6 Jan 2020 12:50:24 -0800 Subject: [PATCH] Clarify the set_trailing_metadata docstring --- src/python/grpcio/grpc/__init__.py | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/src/python/grpcio/grpc/__init__.py b/src/python/grpcio/grpc/__init__.py index 93a10644bf5..3688ac82600 100644 --- a/src/python/grpcio/grpc/__init__.py +++ b/src/python/grpcio/grpc/__init__.py @@ -1162,7 +1162,13 @@ class ServicerContext(six.with_metaclass(abc.ABCMeta, RpcContext)): @abc.abstractmethod def set_trailing_metadata(self, trailing_metadata): - """Sends the trailing metadata for the RPC. + """Sets the trailing metadata for the RPC. + + Sets the trailing metadata to be sent upon completion of the RPC. + + If this method is invoked multiple times throughout the lifetime of an + RPC, the value supplied in the final invocation will be the value sent + over the wire. This method need not be called by implementations if they have no metadata to add to what the gRPC runtime will transmit.